🔗Типы вебхуков и интеграций с сервисами

Вебхук (webhook) — это отправка запросов по событиям. Запросы уведомляют внешние сервисы об изменениях и событиях — информация отправляется на указанный URL-адрес. Вебхуки используются для интеграции.

В сервисе Selarti доступны два типа интеграции с разными вебхуками.

Интеграция с сервисами через раздел «ИИ»

Первый тип интеграции настраивается в разделе «ИИ» при создании и редактировании искусственного интеллекта в блоке «Профессиональные настройки».

В блоке «Профессиональные настройки» в выпадающем меню «ИИ функции» выберите «сustom api».

Функция «custom api» позволяет подключать любые внешние сервисы и интеграции. Эту функцию вызывает сам ИИ, который далее обрабатывает запросы и передаёт данные из диалога на внешний сервер. При этом ИИ может не только отправлять, но и получать нужную информацию от внешнего сервера.

Вебхуки отправляются по различным событиям с любыми указанными параметрами. Задайте для ИИ правила, что нужно собрать из диалога — адрес, телефон, другие нужные данные. Например, ИИ собирает контакты, имя, детали заказа, обрабатывает данные, передаёт в CRM и другой внешний сервис. Далее получает ответ, например, подтверждение и дополнительные данные от внешних сервисов. Затем собирает, обрабатывает и передаёт эту информацию ответом пользователю.

Вебхуки при настройке интеграции такого типа возможно отправлять и получать не один раз. За один диалог возможна сотня событий, по каждому из которых в нужные сервисы поступит уведомление. На одно входящее сообщение Selarti может вызвать до 100 различных интеграций.

Подробнее о настройке в инструкции «Настройка сustom API».

Интеграция с сервисами через раздел «Интеграции»

Второй тип интеграции настраивается через раздел «Интеграции». В разделе выберите уведомления о событиях по тегам и по сообщениям, при которых на внешний сервер отправятся вебхуки.

Типы вебхуков:

• успешный диалог;

• получен контакт;

• есть интерес;

• передан на оператора;

• сообщение для оператора;

• все сообщения.

Такие вебхуки содержат готовые и стандартные системные параметры. Например, success содержит информацию о том, успешен или нет диалог. Или thread_id — id треда, используется для идентификации диалога с пользователем. Вебхук нельзя изменить, нельзя добавить дополнительные поля.

Вебхуки при такой настройке интеграции поступают один раз на одно событие. Например, диалог успешен — поступает вебхук, контакт получен — поступает вебхук. То есть на каждое из событий отправляется один вебхук.

Подробнее о создании интеграции в статье «Интеграции | Integration».