Перечень используемых Вебхуков (Webhooks)

Введение

В статье представлено описание всех Вебхуков (Webhooks) и методов, которые используются для организации взаимодействия программы с внешними системами: телефония, сайт, мобильное приложение, мессенджеры и т.д.

Перечень Вебхуков (Webhooks)

crm_reg_call.php

Описание

Регистрирует события в программе: звонок (входящий, исходящий, пропущенный), заявка с сайта.

Входящие параметры

getcallerdata.php

Описание

Возвращает имя клиента, который отображается на экране телефона.

Входящие параметры

getcalltype.php

Описание

Возвращает тип звонка согласно умной маршрутизации (см. шаги 3, 4, 5, 6 в Умная маршрутизация входящего звонка).

Входящие параметры

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 генерируют ссылку для обратного звонка. Пример ссылки, которую будет вызывать форма на сайте:

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=

Здесь параметры:

• key - персональный ключ для организации, которой выдали ссылку
• phone - телефон клиента
• name - имя клиента (необязательный)
• comment - комментарий (необязательный)
• domain - адрес сайта, с которого делается вызов (необязательный)
• advchannel - рекламный канал (необязательный)
• department - подразделение

Параметры нужно url-кодировать

2. Если сайт на http, то сайт может вызывать скрипт напрямую из телефонии.

Пример ссылки, вызываемой с сервера телефонии:

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, интегрированного на сайте для взаимодействия с клиентами

Входящие параметры