Перечень используемых Вебхуков (Webhooks): различия между версиями
(→Входящие параметры) |
(→Логика работы) |
||
(не показано 14 промежуточных версий этого же участника) | |||
Строка 10: | Строка 10: | ||
=== Описание === | === Описание === | ||
Регистрирует события в программе: звонок (входящий, исходящий, пропущенный), заявка с сайта. | Регистрирует события в программе: звонок (входящий, исходящий, пропущенный), заявка с сайта. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
=== Входящие параметры === | === Входящие параметры === | ||
Строка 325: | Строка 166: | ||
|- | |- | ||
|} | |} | ||
+ | [[Файл:Callback_1.png]] | ||
+ | |||
+ | == getcallerdata.php == | ||
+ | === Описание === | ||
+ | Возвращает имя клиента, который отображается на экране телефона. | ||
+ | |||
+ | === Входящие параметры === | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! scope="col"| Параметр | ||
+ | ! scope="col" style="width:100px;"| Тип | ||
+ | ! scope="col"| Описание | ||
+ | |- | ||
+ | | CallId | ||
+ | | | ||
+ | | Идентификатор звонка | ||
+ | |- | ||
+ | | CallerNumber | ||
+ | | | ||
+ | | Номер телефона, с которого идет звонок | ||
+ | |- | ||
+ | | ParsedCallerNumber | ||
+ | | | ||
+ | | | ||
+ | |} | ||
+ | |||
+ | == getcalltype.php == | ||
+ | === Описание === | ||
+ | Возвращает тип звонка согласно умной маршрутизации (см. шаги 3,4,5,6 в [[Умная машрутизация входящего звонка]]). | ||
+ | |||
+ | === Входящие параметры === | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | ! scope="col"| Параметр | ||
+ | ! scope="col" style="width:100px;"| Тип | ||
+ | ! scope="col"| Описание | ||
+ | |- | ||
+ | | CallerNumber | ||
+ | | | ||
+ | | Номер телефона, с которого идет звонок | ||
+ | |} | ||
+ | |||
+ | == getcurrenttime.php == | ||
+ | === Описание === | ||
+ | Возвращает время на сервере 1С | ||
+ | |||
+ | == /messenger/webhook_telegram == | ||
+ | === Описание === | ||
+ | Регистрирует входящие сообщения из Telegram в программе | ||
+ | |||
+ | == /messenger/webhook_whatsapp == | ||
+ | Регистрирует входящие сообщения из WhatsApp в программе | ||
+ | |||
+ | == /crm/callback.php == | ||
+ | === Описание === | ||
+ | <p>При поступлении заявки с сайта связывает клиента с менеджером по телефону.</p> | ||
+ | <p> | ||
+ | Для настройки интеграции сайта и CRM-модуля при отправке форм с сайта необходимо вызывать Webhook следующего формата: http://<IP-адрес>/callback.php?[params], где: | ||
+ | * <IP-адрес> - IP-адрес сервера телефонии, с которым интегрирована программа "Управление автоцентром". | ||
+ | * [params] - параметры http-запроса (см. Входящие параметры). | ||
+ | * Название скрипта может варьироваться от телефонии, что его размещает. | ||
+ | </p> | ||
+ | |||
+ | ===Логика работы=== | ||
+ | <p>На сайте компании размещается форма для обратного звонка, заявки. Клиент заполняет форму, отправляет ее. Сайт в это время вызывает скрипт callback.php. </p> | ||
+ | <p>Срабатывает умная маршрутизация в скрипте, если есть ответственный по этому клиенту. </p> | ||
+ | <p>Далее на согласованные при настройке номера поступает звонок. Звонят одновременно </p> | ||
+ | <p>В момент звонка на телефонах отображается “Заявка с сайта”, “Имя” и “Номер”.</p> | ||
+ | *Если трубку взяли, то после поднятия трубки ответившему проигрывается приветствие “Поступила заявка с сайта”, и в это же время открывается форма сделки. Идет дозвон до клиента. | ||
+ | *Если трубку не взяли, то делаются три попытки дозвона на все согласованные трубки по 30 сек с интервалом в 30 сек. Если никто не ответил, то фиксируем заявку в 1с на должность. | ||
+ | <p></p> | ||
+ | <p>При этом, звонок может зависеть от подразделения.</p> | ||
+ | |||
+ | ===Интеграция с сайтом=== | ||
+ | :1. Если сайт на https, то специалисты техподдержки 5s генерируют ссылку для обратного звонка. Пример ссылки, которую будет вызывать форма на сайте: | ||
+ | <p>https://cloud.5-systems.ru/callback/actions/папка_с_наименованием_клиента/connect.php?key=00000000&phone=9210000000&name=client_name&comment=client_comment&domain=www_domain&advchannel=website&department=</p> | ||
+ | <p>Здесь параметры:</p> | ||
+ | *key - персональный ключ для организации, которой выдали ссылку</p> | ||
+ | *phone - телефон клиента | ||
+ | *name - имя клиента (необязательный) | ||
+ | *comment - комментарий (необязательный) | ||
+ | *domain - адрес сайта, с которого делается вызов (необязательный) | ||
+ | *advchannel - рекламный канал (необязательный) | ||
+ | *department - подразделение | ||
+ | <p>Параметры нужно url-кодировать</p> | ||
+ | :2. Если сайт на http, то сайт может вызывать скрипт напрямую из телефонии. | ||
+ | |||
+ | <p>Пример ссылки, вызываемой с сервера телефонии:</p> | ||
+ | <p>xx.xx.xx.xx:80/zeon/api/integration/1c-callback.php?&phone=8900000000&name=test&comment=test_comment&domain=www_domain&advchannel=advertising_channel&department=&user_id=&session_id=&FromWeb=1</p> | ||
== /jivosite/jivosite.php == | == /jivosite/jivosite.php == |
Текущая версия на 11:56, 29 июля 2021
Статья в разработке
Содержание
Введение
В статье представлено описание всех Вебхуков (Webhooks) и методов, которые используются для организации взаимодействия программы с внешними системами: телефония, сайт, мобильное приложение, мессенджеры и т.д.
Перечень Вебхуков (Webhooks)
crm_reg_call.php
Описание
Регистрирует события в программе: звонок (входящий, исходящий, пропущенный), заявка с сайта.
Входящие параметры
№ | Параметр | Описание | Как обрабатывается ссылка скриптом с указанным параметром, если он не указан |
---|---|---|---|
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> |
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-адрес>/callback.php?[params], где:
- <IP-адрес> - IP-адрес сервера телефонии, с которым интегрирована программа "Управление автоцентром".
- [params] - параметры http-запроса (см. Входящие параметры).
- Название скрипта может варьироваться от телефонии, что его размещает.
Логика работы
На сайте компании размещается форма для обратного звонка, заявки. Клиент заполняет форму, отправляет ее. Сайт в это время вызывает скрипт callback.php.
Срабатывает умная маршрутизация в скрипте, если есть ответственный по этому клиенту.
Далее на согласованные при настройке номера поступает звонок. Звонят одновременно
В момент звонка на телефонах отображается “Заявка с сайта”, “Имя” и “Номер”.
- Если трубку взяли, то после поднятия трубки ответившему проигрывается приветствие “Поступила заявка с сайта”, и в это же время открывается форма сделки. Идет дозвон до клиента.
- Если трубку не взяли, то делаются три попытки дозвона на все согласованные трубки по 30 сек с интервалом в 30 сек. Если никто не ответил, то фиксируем заявку в 1с на должность.
При этом, звонок может зависеть от подразделения.
Интеграция с сайтом
- 1. Если сайт на https, то специалисты техподдержки 5s генерируют ссылку для обратного звонка. Пример ссылки, которую будет вызывать форма на сайте:
Здесь параметры:
- key - персональный ключ для организации, которой выдали ссылку
- phone - телефон клиента
- name - имя клиента (необязательный)
- comment - комментарий (необязательный)
- domain - адрес сайта, с которого делается вызов (необязательный)
- advchannel - рекламный канал (необязательный)
- department - подразделение
Параметры нужно url-кодировать
- 2. Если сайт на http, то сайт может вызывать скрипт напрямую из телефонии.
Пример ссылки, вызываемой с сервера телефонии:
xx.xx.xx.xx:80/zeon/api/integration/1c-callback.php?&phone=8900000000&name=test&comment=test_comment&domain=www_domain&advchannel=advertising_channel&department=&user_id=&session_id=&FromWeb=1
/jivosite/jivosite.php
Описание
Регистрирует сообщения с чата Jivosite, интегрированного на сайте для взаимодействия с клиентами
Входящие параметры
Параметр | Тип | Описание |
---|---|---|
source | Код рекламного канала |