Интеграция с помощью web-hooks

SmartCallBack умеет отправлять данные по обращениям с помощью POST и GET запроса на любой указанный адрес в виде Webhook (вебхук), например по адресу:
http://site.ru/leads/?

Рекомендуем: использовать SSL-сертификат (https) для конечной принимающей стороны, для обеспечения безопасности данных.

Триггеры срабатывания - начало звонка оператору или создание заявки через messenger (при необходимости набор триггеров может быть расширен).

Эта возможность может быть полезна для отображения карточки клиента в момент звонка в CRM.

Запрос включает в себя набор параметров:

• id- уникальный id заявка в системе SmartCallBack
• phone- номер клиента
• status - код статуса обращения, пример:{"code":"6","title":"Вызов оператора"}
• type - тип заявки в системе SmartCallBack
• email - mail оставленный клиентом
• domen_id - уникальный id домена в системе SmartCallBack
• date_create- дата оставления заявки (unix-метка времени по Москве)
• date_callback- дата звонка
• queryType- качество обращения, от 0 до 9, где 0-не целевой , 1-околоцелевой, 9-целевой.
• manager_id- номер менеджера в системе SmartCallBack
• date_queryType - дата присвоения queryType
• page_from - страница с которой оставили заявку
• page_start - страница захода на сайт
• session_start- номер сессии
• city - город
• domen- адрес домена
• manager_name- имя менеджера в системе SmartCallBack
• duration - продолжительно звонка по заявке
• record_url- ссылка на запись разговора
• utm_source- utm sourse источника с которого оставили заявку
• utm_medium- utm medium источника с которого оставили заявку
• utm_campaign- utm medium источника с которого оставили заявку
• utm_content- utm content источника с которого оставили заявку
• utm_term- utm term источника с которого оставили заявку
• tags- теги к заявке из системы SmartCallBack
• message- переписка пользователя и оператора

Справочник типов обращений SmartCallBack (возможные значения type в списке выше):

1 – CallBack  Обратный звонок
2 – Telegram  Заявки из Telegram Messenger
3 – WhatsApp  Заявки из WhatsApp Messenger
4 – Viber  Заявки из Viber Messenger
5 – Facebook  Заявки из Facebook Messenger
6 – Вконтакте  Заявки из VK Messenger или VK Leads
7 – CoMagic  Заявки из системы CoMagic
8 – Такси
9 – Email
10 – MobileDirect Прямой звонок с мобильного устройства в call-центр
11 – myTarget (автоматизированные лиды из рекламной системы myTarget)
12 – LiveChat (обращения через онлайн консультант на сайте)
13 – Юла Автоматизированные лиды с портала объявлений Юла

Пример hook-и:

id=9795&status=38&statustypeid=12&domenid=1619&application=LiveChat&fio=LiveChat client #888385&phone=&datecreate=1519807722&utmsource=&utmcampaign=&utmterm=&utmcontent=&utmmedium=&querynumberdomen=1&querynumberclient=1&statustitle=Диалог закрыт&statustype=LiveChat&domaintitle=sol-system.ru&countmessagesfromoperator=2&countmessagesfromclient=2&messages=json_строка

Справочник статусов обращений SmartCallBack (возможные значения поля status из списка параметров веб-хук)

0 – Новая
1 – Принята
2 – Нет ответа
3 – Обработана
4 – Архив
5 – MobileDirect
6 – Вызов оператора
7 – Вызов посетителя
8 – Оператор на линии
9 – Посетитель на линии
10 – Идет разговор
11 – Завершено оператором
12 – Завершено посетителем
13 – Обрыв связи
14 – Email
15 – Ожидание повторного звонка
16 – Потенциальный клиент
17 – Диагностика системы
18 – Ожидаем действие оператора
19 – Отправлено письмо
20 – Запись на показ
21 – Запись на показ
22 – Помечено как спам
23 – Удалена
24 – Подписка
25 – Отправка SMS
26 – Viber
27 – WhatsApp
28 – На обработку
29 – Telegram
31 – Facebook
32 – Вконтакте
34 – Другие события
35 – Новый диалог
36 – Запрос на чат
37 – Идет общение
38 – Диалог закрыт
39 – Оператор не ответил
40 – Посетитель не ответил

Хуки уходят в 3 случаях (тригеры срабатывания web-hook SmartCallBack):

• Начало звонка оператору Отправление информации об обращении и посетителе который заказал звонок. Триггер срабатывания - начала звонка оператору. Может быть полезным для отображения карточки клиента в момент звонка в CRM.

• Создание заявки через messenger Отправление информации об обращении и посетителе, который оставил заявку через Viber, WhatsApp или Telegram. Триггер срабатывания - создание новой заявки через Viber, WhatsApp, LiveChat, Telegram.

• Закрытие диалога Отправление информации об обращении и посетителе, с которым происходило общение. Триггер срабатывания - закрытие диалога оператором.

Интеграция с помощь web-хук включается в настройках сайта в блоке интеграций: В ее настройках вы можете указать на какие URL направлять запросы при различных событиях SmartCallBack.

Важно:

Хука может отправлять в формате post и get запроса.

При использовании GET-запроса параметр message (текст переписки) не передается (так как GET-запрос имеет ограничение по длине запроса).