Описание

C помощью Webhooks можно интегрировать Re:plain во внешнюю систему/сервис, например в вашу CRM.

Для работы Webhooks нужно указать URL-адрес вашего обработчика в настройках модуля Re:plain API. На указанный адрес будут отправляться запросы при совершение событий, перечисленних ниже.

Спецификация

Протокол передачи данных

HTTP (POST)

Формат запроса

JSON

Формат ответа

HTTP код 200

<aside> 💡 Если обработчик не возвращает успешный ответ — будут приостановлены все последующие события от этого конкретного клиента

</aside>

Тайм-аут соединения

10 секунд

Кол-во повторных запросов

5 попыток, примерно раз в минуту

<aside> 💡 По истечению попыток — будут удалены все текущие события от этого конкретного клиента

</aside>

Рекомендации

• Старайтесь делать ваши обработчики идемпотентными

  <aside> 💡 Каждое событие содержит уникальный ID

  </aside>

• Если обработчик выполняет тяжелую или долгую операцию — добавьте полученное событие в свою очередь задач и затем сразу возвращайте успешный ответ