Интеграции

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

Приёмники

Адреса, на которые отправляются события. Каждый запрос подписан секретом приёмника.

    Ключи API

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

      Журнал доставок

      Что ушло, с каким ответом и за сколько. Не доставленное можно отправить заново.

        Как подключиться

        Коротко о том, что получает принимающая сторона.

        Лента событий
        GET /api/v1/integrations/events?since=<курсор>
        Заголовок X-API-Key. Ответ — массив событий без обёртки, пустая лента это []. Элемент: id, type, created_at, cursor, data. Порядок по возрастанию времени; передайте cursor последнего обработанного в since, чтобы получить только новое.
        Вебхук
        POST с заголовками X-Telemaks-Event, X-Telemaks-Delivery, X-Telemaks-Timestamp и X-Telemaks-Signature вида t=…,v1=…, где v1 — HMAC-SHA256 от строки метка.тело на секрете приёмника. Успех — любой ответ 2xx; иначе повтор через минуту, пять, пятнадцать, час и шесть часов. Тело вебхука — конверт доставки (event, delivery_id, occurred_at, cursor) вокруг того же data, что в ленте.
        Типы событий
        —
        Группировка
        Каждый найденный пост — отдельное событие. Совпадающие тексты мы не схлопываем: в инфокампании, где сообщества публикуют один текст с хештегом, считать нужно все посты. Поле cluster_id справочное, его можно игнорировать.
        Повторы
        Одно событие может прийти дважды, если связь оборвалась после вашего ответа. Храните delivery_id и пропускайте повторы.