Перечень используемых Вебхуков (Webhooks)
Статья в разработке
Содержание
Введение
В статье представлено описание всех Вебхуков (Webhooks) и методов, которые используются для организации взаимодействия программы с внешними системами: телефония, сайт, мобильное приложение, мессенджеры и т.д.
Перечень Вебхуков (Webhooks)
crm_reg_call.php
Описание
Регистрирует события в программе: звонок (входящий, исходящий, пропущенный), заявка с сайта.
Входящие параметры
Параметр | Тип | Описание |
---|---|---|
CallId | Идентификатор звонка | |
CallerNumber | Номер телефона, на который идет звонок | |
CallDate | Дата звонка | |
AnswerWaitTime | Время ожидания ответа | |
AnswerWaitTime | Время ожидания ответа | |
ReasonCallLoss | Причина потери звонка | |
CalledNumber | Номер телефона, на который звонят при исходящем звонке | |
ContactInfo | ||
Comment | ||
MissedCall | bool | Признак пропущенного звонка |
Outcoming | bool | Признак исходящего звонка |
FirstCalledNumber | ||
FromWeb | bool | Признак заявки с сайта |
WebPage | string | Страница, с которой пришла заявка с сайта |
Object1CId | ||
Object1CType | ||
CarModel | ||
PhoneStation | ||
PhoneStation | ||
session_id | ||
Parts |
getcallerdata.php
Описание
Возвращает имя клиента, который отображается на экране телефона.
Входящие параметры
Параметр | Тип | Описание |
---|---|---|
CallId | Идентификатор звонка | |
CallerNumber | Номер телефона, с которого идет звонок | |
ParsedCallerNumber |
getcalltype.php
Описание
Возвращает тип звонка согласно умной маршрутизации (см. шаги 3,4,5,6 в Умная машрутизация входящего звонка).
Входящие параметры
Параметр | Тип | Описание |
---|---|---|
CallerNumber | Номер телефона, с которого идет звонок |
getcurrenttime.php
Описание
Возвращает время на сервере 1С
/messenger/webhook_telegram
Описание
Регистрирует входящие сообщения из Telegram в программе
/messenger/webhook_whatsapp
Регистрирует входящие сообщения из WhatsApp в программе
/crm/callback.php
Описание
При поступлении заявки с сайта связывает клиента с менеджером по телефону.
Для настройки интеграции сайта и CRM-модуля при отправке форм с сайта необходимо вызывать Webhook следующего формата: http://<IP-адрес>/crm/callback.php?[params], где:
- <IP-адрес> - IP-адрес сервера телефонии, с которым интегрирована программа "Управление автоцентром".
- [params] - параметры http-запроса (см. Входящие параметры).
Пример в декодированном: http://11.11.11.11:555/crm/callback.php?phone=74955404614&startparam2=Андрей&startparam3=сообщение&domain=code_site&advchannel=Google
Входящие параметры
/jivosite/jivosite.php
Описание
Регистрирует сообщения с чата Jivosite, интегрированного на сайте для взаимодействия с клиентами
Входящие параметры
№ | Параметр | Описание | Как обрабатывается ссылка скриптом с указанным параметром, если он не указан |
---|---|---|---|
1 | CallId | Идентификатор звонка | Генерируется |
2 | CallDate | Дата звонка | Передается пустым |
3 | CallerNumber | Номер телефона, с которого идет звонок | Ищет параметр phone, если не находит, то передается пустым |
4 | CalledNumber | Номер телефона, на который звонят при исходящем звонке | - |
5 | AnswerWaitTime | Время ожидания ответа | Передается пустым |
6 | ReasonCallLoss | Причина потери звонка | Передается пустым |
7 | MissedCall | Признак пропущенного звонка | Передается пустым |
8 | Outcoming | Признак исходящего звонка | Передается пустым |
9 | ContactInfo | Наименование контрагента | Ищет параметр name, если не находит, то передается пустым |
10 | FirstCalledNumber | Городской номер | Передается пустым |
11 | FromWeb | Признак заявки с сайта | Передается пустым |
12 | WebPage | Страница, с которой пришла заявка с сайта | Ищет параметр domain, если не находит, то передается пустым |
13 | Comment | Комментарий, что подтянется в задачу | Ищет параметр comment, если не находит, то пустой |
14 | Object1CId | Id объекта 1С, что передается вместе с событием (используется для исходящих) | Передается пустым |
15 | Object1CType | Тип объекта 1С, что передается вместе с событием (используется для исходящих) | Передается пустым |
16 | CarModel | Модель автомобиля | Передается пустым |
17 | Электронная почта | Передается пустым | |
18 | PhoneStation | Передает 'AS' | Код телефонной станции |
19 | AdvChannel | Рекламный канал | Ищет advchannel, если не находит, то передается пустым |
20 | session_id | Параметр для динамического коллтрэкинга | Передается пустым |
21 | user_id | Параметр для динамического коллтрэкинга | Передается пустым |
22 | X_ROISTAT | UTM-метка | Ищет x-roistat, если не находит, то передается пустым |
23 | X_ROISTAT_PHONE | UTM-метка | Передается пустым |
24 | X_ROISTAT_MARKER | UTM-метка | Передается пустым |
25 | Duration | Длительность звонка | Передается пустым |
26 | Parts | если не указан, то <?xml version="1.0" encoding="UTF-8"?>,
если session_id и user_id заполнены, то <object type="string" name="session_id">'.$session_id.'</object>'.'<object type="string" name="user_id">'.$user_id.'</object> если WebPage заполнено и равно JivoSite, то <object type="string" name="ВидОбращения">Чат</object> если Duration заполнено, то <object type="string" name="Duration">'.$Duration.'</object>' Если $x_roistat заполнено, то <object type="string" name="x-roistat">'.$x_roistat.'</object> <object type="string" name="x-roistat-phone">'.$x_roistat_phone.'</object> <object type="string" name="x-roistat-marker">'.$x_roistat_marker.'</object></datа> Если указан, то декодируем, добавляем строки перед </datа> <object type="string" name="session_id">'.$session_id.'</object> <object type="string" name="user_id">'.$user_id.'</object> <object type="string" name="Duration">'.$Duration.'</object> |
Параметр | Тип | Описание |
---|---|---|
source | Код рекламного канала |