Вебхуки чат-сервисов

Как Slack, Microsoft Teams, Discord, Telegram и GitHub доставляют сообщения в Veyra, как проверяется каждая доставка и какие действуют ограничения.

Veyra Docs TeamОбновлено 1 мин чтенияВерсия 2 · История

Когда вы подключаете канал чата, сервис отправляет каждое сообщение и событие в Veyra по адресу:

HTTP
POST https://intelligence-api.veyra.so/api/chat-webhooks/{publicId}/{provider}

provider — одно из значений slack, microsoft-teams, discord, telegram или github. publicId определяет ваш адрес; при настройке консоль подставляет полный адрес, а вы вставляете его в настройки приложения у сервиса.

Проверка

Прежде чем читать доставку, Veyra проверяет её собственным механизмом сервиса:

Сервис Чем проверяется
Slack Секрет подписи приложения (X-Slack-Signature и X-Slack-Request-Timestamp).
Microsoft Teams Токен Bot Framework в запросе.
Discord Публичный ключ приложения (заголовки подписи Ed25519).
Telegram Секретный токен, заданный при регистрации вебхука.
GitHub Секрет вебхука GitHub App (X-Hub-Signature-256).

Доставка, не прошедшая проверку, отклоняется, и из неё ничего не читается. Секреты для проверки вводит человек при настройке, а не агент.

Ограничения

Каждый адрес принимает до 600 запросов в минуту с одного адреса источника. Ответы содержат X-RateLimit-Limit и X-RateLimit-Remaining; при превышении Veyra отвечает 429 с Retry-After, а сервисы повторяют доставку по своему расписанию.

Ответы

Veyra отвечает в формате, которого ждёт каждый сервис (например, на проверку URL от Slack или подтверждение взаимодействия в Discord). Неподдерживаемый сервис или сервис со своим маршрутом (почта, голос) получает 400.

Доставка и повторы

Сервисы повторяют неудачные доставки. Veyra распознаёт повторы по идентификатору события или доставки, поэтому повтор никогда не создаёт вторую задачу или второй ответ.

Что происходит с сообщением

  1. Отправитель сопоставляется со связанным участником Veyra. Несвязанные отправители получают ссылку, чтобы подтвердить, кто они.
  2. Новая ветка становится задачей для агента этого адреса; ответ продолжает задачу.
  3. Ответ агента публикуется в той же ветке.

Управление адресами описано в разделе Каналы чата справочника API.

ВебхукиВходящиеКаналы чата