Параметр `WEBHOOKS`¶

Платный доступ

Использование данного параметра доступно только для премиум пользователей Hotline. Для приобретения платной версии системы обратитесь в нашу службу поддержки.

Параметр задает один или несколько адресов для обработки входящих вебхуков от Хотлайн по заданному списку событий.

Вебхуки отправляются методом POST с телом запроса в формате JSON.

Типы событий¶

1. Системные события¶

Доступные значения: dialog_created, dialog_reopened, dialog_closed, message_received, message_sent, message_intercepted.

Вебхуки на такие события не возвращают результат в бекенд-группу.

2. Кастомные команды¶

Может быть указана любая своя или уже существующая в системе команда. Название команды должно иначинаться с символа слеш /.

Вебхуки на такие события могут возвращать результат в бекенд-группу в виде сообщения.

Подробнее о формате отправляемых запросов смотрите в описании формата Webhooks.

По умолчанию список пуст, вебхуки никуда не отправляются.

Формат данных¶

Конфигурация вебхуков задается в формате JSON.

Чтобы очистить параметр, отправьте значение OFF

Сетап-боту необходимо отправить нужное значение после выбора параметра для редактирования.

Значение по умолчанию¶

NONE

Примеры использования¶

{
  "https://someapiserver.com/webhooks/end_point-1": [
    "dialog_created",
    "dialog_reopened",
    "dialog_closed",
    "message_received",
    "message_sent",
    "message_intercepted"
  ],
  "https://someapiserver.com/webhooks/end_point-2": [
    "/mark", "/info",
    "/invoice", "/client"
  ]
}

Результат: все системные события будут приходить на end_point-1, а события о вызванных командах пойдут на end_point-2.

Основные кейсы¶

внешние интеграции
кастомная аналитика

Параметр WEBHOOKS¶