¶ Прием лидов
В личном кабинете Calltouch откройте раздел Интеграции и выберите пункт Вебхуки.
На вкладке По лидам нажмите Создать вебхук.
На вкладке Основные настройки укажите параметры вебхука:
- Адрес обработчика — URL API CRM (формат ниже).
- Метод передачи данных — POST.
- В блоке События включите Создание заявки. Остальные события (звонки, смена статуса и т.п.) не отмечайте — ClubIS принимает лиды при создании заявки в Calltouch.
В поле Адрес обработчика указывается адрес API CRM, который выглядит так — http://ip_сервера:порт/api/calltouch?USER_ID=id_пользователя&USER_HASH=хэш_пользователя. USER_ID и USER_HASH — данные для авторизации в CRM, ip_сервера:порт — внешний адрес, на котором работает служба web-service.
Рабочий пример на нашем тестовом сервере: https://test.club-is.ru/api/calltouch?USER_ID=30&USER_HASH=f77d565e02169dad60bca51ea19bd53cf1a041d6
При работе нескольких клубов в одной базе можно из колтача передавать CLUB_ID с кодом клуба из справочника Клубы (например CLUB_ID=1).
На вкладке Передаваемая информация отметьте поля, которые вебхук будет отправлять в ClubIS. Опцию Скрывать персональные данные не включайте — без телефона и e-mail лид не создастся.
Включите как минимум:
- ФИО клиента
- Номер клиента и/или Email клиента (нужен хотя бы один контакт)
- Название формы — попадёт в название сделки в CRM
Дополнительно рекомендуется передавать Тип обращения, ID заявки в Calltouch, Отслеживаемый номер — они сохраняются в заметке к лиду. Можно включать и другие поля из списка, если вам это необходимо.
UTM-метки не обязательны, но желательны для сквозной аналитики. При необходимости включите:
- Метка utm_source
- Метка utm_medium
- Метка utm_campaign
- Метка utm_content
- Метка utm_term
¶ Теги лидов в Calltouch
Помимо приёма заявок и выгрузки сделок, ClubIS может добавлять теги к лидам в Calltouch — по событиям в анкете клиента и по входящим заявкам с сайта. Теги помогают в отчётах Calltouch видеть, что произошло с обращением после попадания в CRM (звонок, встреча, повторный контакт и т.д.).
¶ Что попадает в теги
Для каждого подходящего события в Calltouch добавляются до двух тегов:
- название события — как в справочнике событий ClubIS (например, «Вх. Звонок», «Вх. Встреча после звонка»);
- тип анкеты — «Контакт», «Клиент», «БЧК», «Гость» и т.п.
Для заявок с сайта, принятых через вебхук Calltouch, вместо служебного названия события в тег подставляется название сделки — то, что указано в поле «Название формы» или в теме заявки (например, «Заявка с сайта», «JivoSite оффлайн заявка»).
Уже существующие теги в Calltouch не перезаписываются — новые добавляются к имеющимся.
¶ Настройка в ClubIS
В Администратор → Интеграции → Лиды в блоке Calltouch (должен быть включён):
- Включите опцию Тегировать лиды в Calltouch по событиям анкеты (тип события и тип анкеты).
- В поле Типы событий (id через запятую) перечислите идентификаторы типов событий, по которым нужно отправлять теги. Список id можно посмотреть в отчёте События — список (модуль Менеджер).
- При необходимости измените Догон событий за последние (дней) — за какой период подхватывать ещё не отправленные события (по умолчанию 90 дней).
- Параметры Типы лидов, среди которых будет происходить поиск и Глубина поиска подходящего лида от даты (минут) влияют на то, как ClubIS находит в Calltouch нужный лид по телефону, если прямой идентификатор звонка или заявки недоступен.
Сохраните настройки и перезапустите службу web-service.
¶ Заявки с сайта
Заявки, поступившие из Calltouch по вебхуку, подхватываются для тегирования автоматически — отдельно добавлять их тип события в список не нужно. ClubIS связывает заметку по заявке со сделкой в CRM и передаёт в Calltouch ID заявки, полученный из вебхука.
Чтобы тегирование работало, в настройках вебхука Calltouch обязательно должно передаваться поле ID заявки в Calltouch (см. раздел Приём лидов).
¶ Звонки и другие события менеджера
Когда сотрудник фиксирует в анкете событие из списка настроенных типов (входящий звонок, встреча, повторный звонок и т.д.), ClubIS в фоновом режиме отправляет соответствующие теги в Calltouch. Отправка выполняется той же службой web-service, что и выгрузка сделок, с интервалом из поля Интервал синхронизации (мин.).
¶ Если теги не появляются в Calltouch
Проверьте по порядку:
- включён блок Calltouch и опция тегирования лидов;
- перезапущена служба web-service после изменения настроек;
- для заявок с сайта — в вебхуке передаётся ID заявки и контакт (телефон или e-mail);
- для событий менеджера — тип события есть в списке Типы событий;
- заявка или звонок действительно есть в том же личном кабинете Calltouch (тот же ID ЛК Calltouch и API-ключ, что в настройках ClubIS).
Подробнее о работе со сделками и событиями в CRM — в статье Лиды и сделки в ClubIS.
¶ Отправка сделок
Чтобы ClubIS передавал в Calltouch статусы и суммы сделок, сначала возьмите данные для доступа к API Calltouch. В личном кабинете откройте Интеграции → API (страница Передача данных через API), включите переключатель Передавать данные по API и скопируйте:
- ID личного кабинета (site_id) — в ClubIS это поле ID ЛК Calltouch;
- API токен (access_token) — в ClubIS это поле API-ключ.
Затем в Администратор → Интеграции → Лиды включите блок Calltouch и вставьте скопированные значения.
После сохранения настроек перезапустите службу web-service. Именно она в фоновом режиме отправляет в Calltouch изменения по сделкам из модуля Менеджер — статусы, суммы, ответственного менеджера и сведения о продаже. Выгружать сделки вручную не нужно.
Служба периодически проверяет, какие сделки изменились с прошлой успешной отправки, и передаёт только их. Как часто это происходит, задаёт поле Интервал синхронизации (мин.) в блоке Calltouch (по умолчанию — 60 минут): после перезапуска первая проверка выполняется сразу, далее — с указанным интервалом. Если Calltouch временно недоступен или возвращает ошибку, служба увеличивает паузу между попытками.
Общие правила закрытия сделок, фильтры выгрузки и работа менеджера со сделками — в статье Лиды и сделки в ClubIS.