Что даёт
Организация настраивает один HTTPS-эндпоинт и получает события о том, что произошло на её досках: создан объект, создана или изменена связь, вызвано действие приложения. Событие приходит подписанным, поэтому получатель может доказать, что запрос от нас.
Когда использовать
- Держать внешнюю систему в курсе изменений доски.
- Запускать автоматизацию по факту, а не по расписанию.
- Собирать журнал активности агентов и людей.
Как работает
Событие создаётся в момент выполнения команды и попадает в очередь. Сервис забирает очередь раз в секунду и отправляет HTTP POST на эндпоинт организации. Успех — ответ 2xx. Любой другой ответ, таймаут или ошибка соединения — повтор по лестнице: 10 с, 30 с, 2 мин, 10 мин, 30 мин, 1 ч, 3 ч. После восьмой неудачи событие попадает в очередь недоставленных (DLQ) и автоматически больше не отправляется.
Доставка — at-least-once: одно событие может прийти дважды. Дедуплицируйте по id события.
Пример
Вход: доска, настроенный вебхук, команда board.item.create. Действие: интеграция создаёт стикер. Результат: на эндпоинт приходит POST; фрагмент тела — {"type":"board.item.created","subject":"item_…","payload":{"objectType":"sticky_note"}}, заголовок — X-Remo-Signature.
Что можно настроить
URL эндпоинта, включение и выключение, ротация секрета, повторная отправка недоставленных событий. Формат и типы — фиксированы.
Ограничения
- Один эндпоинт на организацию: доставка идёт в него, а не в «несколько подписчиков».
- Содержимого доски в событии нет: только идентификаторы, типы и счётчики. Текст читается через API.
- Если эндпоинт не настроен, события создаются, но помечаются отправленными без запроса.
- Изменения, удаления объектов и правка текста событий не порождают — ни у человека, ни у агента.
Практические инструкции
Подключить интеграцию — от токена до первого доставленного события.
Связанные возможности
Токены интеграций, приложения, агенты.