Для чего нужна интеграция
Что можно сделать в Vakas-tools совместно с Close.com:
- Автоматически создавать лиды с контактами в Close.com при регистрации.
- Обновлять данные существующих лидов (название, статус, кастомные поля).
- Создавать и обновлять задачи для менеджеров.
- Добавлять примечания (заметки) к карточке лида.
В зависимости от входящих данных (регистрация, оплата, отчёт с вебинара) можно настроить триггеры с разными наборами действий.
Подключение Close.com
1 Создайте API-ключ в Close.com
- Войдите в аккаунт Close.com.
- Перейдите в Settings → Developer.
- Нажмите New Api Key.
- Скопируйте созданный ключ.
2 Добавьте сервис в Vakas-tools
- В Vakas-tools перейдите в Сервисы и доступы → Добавить сервис → Close.com.
- Укажите название подключения — произвольное, для вашего удобства (например, «Close основной»).
- Вставьте скопированный Ключ API.
- Нажмите «Добавить сервис».
Важно: сохраните ключ сразу после создания. Если потеряли — создайте новый.
После успешного подключения сервис появится в списке и станут доступны триггеры. И в базах уже добавьте сервис именно к базе с помощью кнопки [+Сервис].
После успешного подключения сервис появится в списке и станут доступны триггеры.
Переподключение
Если ключ перестал работать (удалён или деактивирован):
- Перейдите в настройки сервиса Close.com.
- Нажмите «Обновить».
- Введите новый API-ключ.
Возможная ошибка
«Ошибка доступа проверьте введеные данные» — неверный API-ключ. Проверьте его в Close.com → Settings → Developer. Возможно, ключ удалён или деактивирован — создайте новый.
Как работает интеграция — общая схема
Передача данных настраивается через правила. На странице сервиса есть три вкладки: Регистрации, Отчёты, Заказы. На каждой вкладке — свой список правил.
Схема работы:
- Правило — определяет, при каких условиях передавать данные.
- Условия (внутри правила) — фильтруют, какие лиды попадут под это правило.
- Действия (кнопка напротив правила) — определяют, какое действие совершить и что именно передать в сервис.
Значок ⧉ — множественное добавление
Рядом с названием некоторых действий отображается зелёный значок ⧉ (два квадрата). Он означает, что это действие можно добавить несколько раз с разными настройками. При срабатывании триггера выполнятся все добавленные блоки.
Действия без этого значка можно добавить только один раз.
То есть если добавишь два блока:
- Блок 1: «Оплатил курс А»
- Блок 2: «Промокод: SALE2025»
Сработает триггер → в Close к ученику добавятся два отдельных примечания.
Общие настройки
Открываются кнопкой «Общие настройки» на странице триггеров. Эти настройки применяются ко всем триггерам данного подключения Close.com.
Секция 1: Поиск дублей
«Проверять на дубли» / «Не проверять»
- Проверять (рекомендуется) — система ищет лид по email и телефону. Если нашла — работает с существующим, а не создаёт нового.
- Не проверять — всегда создаёт новый лид. Используется редко.
Рекомендация: всегда включайте проверку дублей. Иначе при каждом срабатывании триггера будет создаваться новый лид, даже если он уже есть в Close.com.
«По какому полю искать дубли» (дополнительный поиск)
Если email и телефон не нашли лид, система может дополнительно искать по кастомному полю:
- Поле в Close — выберите одно из кастомных полей лида из выпадающего списка.
- Значение поля — укажите значение или шорткод.
Когда это нужно: если вы хотите связать лид в Close.com с записью из другой системы по уникальному идентификатору.
Пример настройки:
| Параметр | Значение |
|---|---|
| Поле в Close | ID из внешней системы |
| Значение поля | {#external_id#} |
Секция 2: Значения по умолчанию
Эти значения подставляются автоматически, если в конкретном действии поле оставлено пустым.
«Название лида»
Имя лида по умолчанию при автоматическом создании. Поддерживает шорткоды.
Пример: {#name#} — подставится имя из входящих данных.
Когда используется: если в действии «Добавить лид» поле «Название» оставлено пустым.
«Название задачи»
Название задачи по умолчанию. Поддерживает шорткоды.
Пример: Обработать заявку от {#name#}
«Статус»
Статус лида по умолчанию. Выбирается из выпадающего списка — статусы загружаются из Close.com.
Когда используется: при создании лида, если в действии статус не выбран.
Пример настройки общих настроек:
| Параметр | Значение |
|---|---|
| Поиск дублей | Проверять на дубли |
| Название лида | {#name#} |
| Название задачи | Обработать заявку |
| Статус | Potential |
Добавить правило
Правила настраиваются одинаково для всех сервисов. Подробная инструкция по созданию правил и настройке условий описана в отдельном разделе.
В рамках интеграции с Close отличаются только доступные действия, которые выполняются при срабатывании правила.
Конструктор действий
Открывается кнопкой «Действия» у триггера. Здесь вы указываете, что должно произойти в Close.com при срабатывании триггера.
Каждое действие добавляется отдельно. Можно комбинировать несколько действий в одном триггере — они выполнятся последовательно.
Добавить лид
Что делает: ищет лид в Close.com по email и телефону. Если не найден — создаёт новый лид с контактом.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Название лида | текст + шорткоды | Название лида. Если оставить пустым — берётся из «Название лида» в общих настройках. |
| Статус | выпадающий список | Статус лида (например: «Potential», «Qualified»). Загружается из Close.com. |
Пример заполнения
| Поле | Значение |
|---|---|
| Название лида | {#name#} |
| Статус | Potential |
Как это работает
- Система берёт
name,email,phoneиз входящих данных. - Если включён поиск дублей — ищет лид по email/телефону.
- Если лид найден — использует его. Если нет — создаёт новый с указанными параметрами.
- Контакт создаётся автоматически внутри лида (с email и телефоном из входящих данных).
- При успешном создании/нахождении сохраняется ID лида для последующих действий.
Поля лида
Что делает: обновляет кастомные (custom) поля лида.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Поля | выбор поля + значение | Пары «Кастомное поле → Значение». Поля выбираются из списка кастомных полей Close.com. Значения поддерживают шорткоды. |
Пример заполнения
| Кастомное поле | Значение |
|---|---|
| Источник | Вебинар |
| UTM Source | {#utm_source#} |
| Город | {#city#} |
Как это работает
- Ищет лид по email/телефону. Если не найден — создаёт.
- Обновляет указанные кастомные поля лида одним запросом.
- Каждое поле передаётся с уникальным идентификатором из Close.com.
Важно: чтобы обновить кастомные поля, они должны быть предварительно созданы в Close.com. Список полей загружается при открытии конструктора действий.
Статус лида
Что делает: изменяет статус лида на выбранный.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Статус | выпадающий список | Новый статус лида. Загружается из Close.com. |
Пример заполнения
| Поле | Значение |
|---|---|
| Статус | Qualified |
Как это работает
- Ищет лид по email/телефону. Если не найден — создаёт с указанным статусом.
- Если лид найден — обновляет его статус.
Название лида
Что делает: изменяет название (name) лида.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Название | текст + шорткоды | Новое название лида. |
Пример заполнения
| Поле | Значение |
|---|---|
| Название | {#name#} — клиент |
Как это работает
- Ищет лид по email/телефону. Если не найден — создаёт.
- Обновляет название лида на указанное значение.
Важно: действия «Поля лида», «Статус лида» и «Название лида» объединяются в один запрос к API Close.com. Это значит, что вы можете использовать их вместе — все изменения применятся одновременно.
Добавить задачу
Что делает: создаёт задачу в Close.com, привязанную к лиду.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Название задачи | текст + шорткоды | Текст задачи. Если пусто — берётся из «Название задачи» в общих настройках. |
| Ответственный пользователь | выпадающий список | Менеджер, которому назначается задача. Загружается из Close.com. |
Пример: задача «Позвонить»
| Поле | Значение |
|---|---|
| Название задачи | Позвонить {#name#}, тел. {#phone#} |
| Ответственный | Иванов Пётр |
Пример: задача «Подтвердить оплату»
| Поле | Значение |
|---|---|
| Название задачи | Подтвердить оплату от {#name#} на сумму {#costMoney#} руб. |
| Ответственный | Петрова Анна |
Как это работает
- Ищет лид по email/телефону. Если не найден — создаёт.
- Создаёт задачу, привязанную к ID лида.
- Устанавливает дату задачи — текущую.
- Назначает ответственного менеджера.
Изменить/добавить задачу
Что делает: обновляет существующую активную задачу или создаёт новую, если активных задач нет.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Название задачи | текст + шорткоды | Новый текст задачи. |
| Ответственный пользователь | выпадающий список | Новый ответственный менеджер. |
Пример: обновление задачи после оплаты
| Поле | Значение |
|---|---|
| Название задачи | Проверить оплату от {#name#} |
| Ответственный | Петрова Анна |
Как это работает
- Ищет лид по email/телефону.
- Ищет активные задачи лида.
- Если активная задача найдена (не в архиве) — обновляет её: меняет текст, ответственного и дату.
- Если активных задач нет — создаёт новую задачу.
Важно: архивные задачи пропускаются при поиске. Если все задачи лида в архиве — будет создана новая.
Добавить примечание
Что делает: добавляет заметку (note) к лиду. Заметка видна в карточке лида в Close.com.
Поля действия
| Поле | Тип | Описание |
|---|---|---|
| Комментарий | текстовое поле + шорткоды | Текст заметки. |
Особенности
- Можно добавить несколько примечаний в одном триггере — нажмите «Добавить» ещё раз.
- Каждая заметка привязывается к ID лида.
Пример: примечание о вебинаре
Был на вебинаре {#webinarId#}.
Смотрел {#bil_minut#} мин.
Кликал по кнопке: {#clickFile#}.Пример: примечание об оплате
Оплата: {#costMoney#} руб.
Тариф: {#positions#}
Статус: {#payment_status#}Пример: примечание о регистрации
Регистрация с лендинга.
UTM: {#utm_source#} / {#utm_medium#} / {#utm_campaign#}Шорткоды
Во всех текстовых полях можно использовать шорткоды — подстановки данных из входящего события. Нажмите иконку {--} рядом с полем, чтобы увидеть список доступных шорткодов.
Часто используемые шорткоды
| Шорткод | Данные |
|---|---|
{#name#} |
Имя контакта |
{#email#} |
|
{#phone#} |
Телефон |
{#costMoney#} |
Сумма заказа |
{#positions#} |
Название тарифа |
{#payment_number#} |
Номер заказа |
{#payment_status#} |
Статус платежа |
{#payedMoney#} |
Оплачено |
{#leftCostMoney#} |
Осталось оплатить |
{#paymentLink#} |
Ссылка на оплату |
{#webinarId#} |
ID вебинара |
{#bil_minut#} |
Был на вебинаре (минут) |
{#clickFile#} |
Кликал ли по кнопке |
{#city#} |
Город |
{#utm_source#} |
UTM source |
{#utm_medium#} |
UTM medium |
{#utm_campaign#} |
UTM campaign |
Полный список шорткодов зависит от источника данных и отображается при нажатии {--} рядом с полем.
Типичные сценарии настройки
Сценарий 1: Регистрация → новый лид в Close.com
Цель: при регистрации на вебинар автоматически создать лид в Close.com.
Шаг 1. Настройте общие настройки
- Нажмите «Общие настройки».
- Установите «Проверять на дубли».
- Укажите «Название лида»:
{#name#}. - Выберите «Статус»: Potential.
- Сохраните.
Шаг 2. Настройте действия триггера
Нажмите «Действия» напротив нужного триггера.
Действие: Добавить лид
| Поле | Значение |
|---|---|
| Название лида | {#name#} — регистрация |
| Статус | Potential |
Результат
При каждой регистрации система:
- Ищет лид по email/телефону.
- Если не найден — создаёт новый с названием, статусом «Potential» и контактными данными.
- Если найден — работает с существующим (дубль не создаётся).
Сценарий 2: Оплата → обновление статуса + задача + примечание
Цель: при поступлении оплаты обновить статус лида, поставить задачу менеджеру и добавить примечание.
Настройте действия триггера
Действие 1: Добавить лид (чтобы гарантировать, что лид существует)
| Поле | Значение |
|---|---|
| Название лида | {#name#} |
| Статус | Qualified |
Действие 2: Статус лида
| Поле | Значение |
|---|---|
| Статус | Qualified |
Действие 3: Добавить задачу
| Поле | Значение |
|---|---|
| Название задачи | Подтвердить оплату от {#name#} |
| Ответственный | Иванов Пётр |
Действие 4: Добавить примечание
Оплата получена: {#costMoney#} руб.
Тариф: {#positions#}
Заказ №{#payment_number#}
Статус: {#payment_status#}Результат
При оплате система:
- Находит или создаёт лид.
- Обновляет статус на «Qualified».
- Создаёт задачу менеджеру.
- Добавляет примечание с деталями заказа.
Сценарий 3: Вебинар → обновление полей + примечание
Цель: после вебинара заполнить кастомные поля лида и добавить примечание о поведении на вебинаре.
Настройте действия триггера
Действие 1: Поля лида
| Кастомное поле | Значение |
|---|---|
| Источник | Вебинар |
| Город | {#city#} |
Действие 2: Добавить примечание
Был на вебинаре {#webinarId#}.
Смотрел {#bil_minut#} мин.
Город: {#city#}
Кликал по кнопке: {#clickFile#}Результат
После вебинара система:
- Находит лид и заполняет кастомные поля.
- Добавляет примечание с данными о поведении на вебинаре.
Сценарий 4: Регистрация → лид + задача менеджеру
Цель: при регистрации создать лид и поставить задачу менеджеру позвонить.
Настройте действия триггера
Действие 1: Добавить лид
| Поле | Значение |
|---|---|
| Название лида | {#name#} |
| Статус | Potential |
Действие 2: Добавить задачу
| Поле | Значение |
|---|---|
| Название задачи | Позвонить новому лиду: {#name#}, {#phone#} |
| Ответственный | Петрова Анна |
Результат
При регистрации система:
- Создаёт лид со статусом «Potential».
- Ставит задачу менеджеру Петровой.
Сценарий 5: Обновление существующей задачи
Цель: при новом событии обновить активную задачу менеджера или создать новую, если активных нет.
Настройте действия триггера
Действие: Изменить/добавить задачу
| Поле | Значение |
|---|---|
| Название задачи | Новая информация по {#name#}: оплата {#costMoney#} руб. |
| Ответственный | Иванов Пётр |
Результат
При событии система:
- Ищет лид по email/телефону.
- Если есть активная задача — обновляет её текст и ответственного.
- Если активных задач нет — создаёт новую.
Частые вопросы и проблемы
Решение: проверьте ключ в Close.com → Settings → Developer. Скопируйте заново. Возможно, ключ удалён или деактивирован — создайте новый.
- Включён ли поиск дублей в «Общих настройках»?
- Передаются ли email и/или телефон во входящих данных?
- Если используется доп. поле — заполнено ли оно?
Решение: убедитесь, что email или телефон передаются и лид существует или будет создан. Добавьте действие «Добавить лид» в тот же триггер.
- Поле существует в Close.com?
- Значение указано?
- Обновите страницу (F5) — список полей загружается из Close.com при открытии конструктора.
- Выбран ли статус в действии «Статус лида»?
- Лид найден? Если email/телефон не совпадают — система создаст нового вместо обновления существующего.
Решение: это нормальное поведение. Если нужно обновить конкретную задачу — она должна быть активной (не в архиве).
Решение: убедитесь, что лид существует. Добавьте действие «Добавить лид» в триггер.
Решение: перейдите в Close.com → Settings → Developer, проверьте статус ключа. При необходимости создайте новый и обновите его в Vakas-tools.