Настройка вебхук-адресов

Корректная настройка вебхук-адресов обеспечит двусторонний обмен данными между вашей системой и платформой Fasttrack.

Ваш вебхук-адрес

Это URL-адрес вашего сервера, куда мы будем отправлять все события связанные с вашим API-каналом (сообщения операторов, контент сценариев чат-бота).

Для получения событий от Fasttrack, необходимо подтвердить конечный адрес сервера, куда будут отправляться запросы:

Определите URL-адрес сервера, который будет принимать уведомления;
Настройте механизм подтверждения адреса (ответ на уведомление confirmation).

Мы будем ждать ответ от вашего сервера в течении 2х секунд.

Вебхук-адрес добавляется в настройках API-канала.

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

Пример уведомления от Fasttrack:

{
  "payload": {
    "type": "confirmation"
  }
}

Пример ответа (подтверждения) от вашего сервера:

{
  "code": "AaAaAaAa"
}

Код подтверждения указан в настройках API-канала вашего проекта.

Вебхук-адрес Fasttrack

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

http://localhost:8080/bots/receive_post/:bot uuid/api_messenger/

:bot uuid – Уникальный идентификатор вашего проекта в Fattrack.

Подставьте идентификатор проекта или скопируйте адрес из настроек API-канала.

Rate limit: 10 RPS (запросов в секунду). При превышении лимита запросы будут отклоняться с ошибкой 429.

Last updated 6 months ago