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

by Александр Гайдуков

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-запрос имеет ограничение по длине запроса).