Вебхуки чат-сервисов
Как Slack, Microsoft Teams, Discord, Telegram и GitHub доставляют сообщения в Veyra, как проверяется каждая доставка и какие действуют ограничения.
Когда вы подключаете канал чата, сервис отправляет каждое сообщение и событие в Veyra по адресу:
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 распознаёт повторы по идентификатору события или доставки, поэтому повтор никогда не создаёт вторую задачу или второй ответ.
Что происходит с сообщением
- Отправитель сопоставляется со связанным участником Veyra. Несвязанные отправители получают ссылку, чтобы подтвердить, кто они.
- Новая ветка становится задачей для агента этого адреса; ответ продолжает задачу.
- Ответ агента публикуется в той же ветке.
Управление адресами описано в разделе Каналы чата справочника API.