Вебхуки: передача заявок и диалогов в CRM (Pro)

Вебхук — это адрес, на который Lidmi сам отправляет данные о каждой новой заявке или диалоге. Через сервисы интеграций Albato, ApiX-Drive или Make заявки можно передавать в amoCRM, Битрикс24, Google Таблицы, Telegram и другие программы — без программиста. Если у вас есть разработчик, он может принимать данные своим скриптом. Вебхуки доступны на тарифе Pro.

Какие события отправляются

«Новая заявка» — из любого источника: «Перезвоните мне», офлайн-форма, мини-сайт, промо-баннер, цепочка сообщений. С именем, телефоном, удобным временем звонка, страницей и UTM-метками.
«Новый диалог» — когда посетитель написал первое сообщение, с текстом этого сообщения и каналом.
«Диалог закрыт» — кто закрыл, теги, число сообщений, время первого ответа.

Как подключить через Albato, ApiX-Drive или Make

В сервисе интеграций создайте связку, которая начинается с вебхука (в Albato — «Вебхук», в Make — «Custom webhook»). Сервис выдаст адрес, который начинается с https://. Скопируйте его.
В кабинете Lidmi откройте «Каналы», внизу страницы — раздел «Вебхуки». Нажмите «+ Добавить адрес».
Вставьте адрес в поле «Адрес (URL)», отметьте, какие события отправлять, и нажмите «Добавить».
Нажмите «Отправить тестовое событие». Сервис интеграций получит пример с выдуманными данными — по нему удобно настроить, какое поле куда попадает в CRM или таблице.
Закончите связку в сервисе интеграций: выберите, куда передавать заявки, и сопоставьте поля.

Подробная подсказка с примерами данных — в кабинете, в блоке «Как подключить» под списком адресов. Всего можно добавить до 5 адресов. Настраивать вебхуки могут владелец и операторы с полным доступом.

Если адрес не отвечает

Если доставить не удалось, Lidmi повторит попытку через 1 минуту, 5 минут, 30 минут, 2 часа и 12 часов — последняя примерно через 14,5 часа.
После 5 неудач подряд владельцу придёт письмо. Если неудач набралось 50 подряд и с первой из них прошли сутки, адрес выключится автоматически — об этом тоже придёт письмо. Включить его снова можно переключателем «Отправлять события на этот адрес».
Кнопка «Журнал отправок» показывает последние отправки за 30 дней: время, событие, результат и код ответа. Содержимое заявок в журнале не хранится.

Если компания перешла на Free, события не отправляются, а адреса сохраняются — после оформления Pro отправка продолжится.

Данные посетителей

В заявках и диалогах есть персональные данные посетителей — имя, телефон, e-mail. Отправляя их в сторонний сервис, вы передаёте их туда сами, как владелец сайта. Указывайте адреса только тех сервисов, которым доверяете, и упомяните такую передачу в политике обработки персональных данных на своём сайте.

Для разработчиков

Запрос — POST с JSON в UTF-8. Вверху: event (lead.created, dialog.created или dialog.closed), event_label, delivery_id, test, occurred_at (UTC), occurred_at_local, timezone, company_id, company_name и объект lead или dialog. Если у источника какого-то поля нет, в нём null. Пример для каждого события — в блоке «Как подключить».
Подпись — заголовок X-Lidmi-Signature: sha256=<hex>: HMAC-SHA256 от сырого тела запроса, ключ — «Секрет для подписи» адреса (показывается в его карточке, можно выпустить новый). Проверка на PHP: hash_equals('sha256=' . hash_hmac('sha256', $body, $secret), $signature).
Ещё заголовки: X-Lidmi-Event, X-Lidmi-Delivery (при повторах тот же — по нему отсеивайте дубли), X-Lidmi-Attempt.
Ответьте кодом 2xx в течение 10 секунд. Повторяются ошибки сети, таймауты, ответы 5xx, 408 и 429; перенаправления не выполняются, прочие 3xx и 4xx не повторяются.