Обзор вебхуков
Все вебхуки, которые Veyra Intelligence принимает и отправляет (триггеры рутин, чат-сервисы, GitHub, почта, голос, плагины и пробуждение HTTP-агентов), и как проходит аутентификация каждого.
Вебхуки передают события между Veyra и другими системами без постоянного опроса. Одни входящие (ваша система или сервис сообщает Veyra, что что-то произошло); один исходящий (Veyra будит агента, работающего на ваших серверах).
Входящие
| Вебхук | Адрес | Аутентификация | Для чего |
|---|---|---|---|
| Триггер рутины | POST /api/routine-triggers/public/{publicId}/fire |
Bearer-секрет, HMAC-подпись или подпись сервиса | Запускать рутину из своих систем, оповещений или CI. |
| Чат-сервисы | POST /api/chat-webhooks/{publicId}/{provider} |
Собственная подпись сервиса | Дать Slack, Teams, Discord, Telegram и GitHub общаться с агентами. |
| Ревью пул-реквестов GitHub | Чат-сервис или триггер рутины | Подпись GitHub или bearer-секрет | Поручать агентам ревью пул-реквестов. |
| Почта | POST /api/chat-webhooks/agentmail/{publicId} |
Подпись Svix | Принимать письма в почтовый ящик агента. |
| Голос | POST /api/voice-webhooks/{publicId}/events и /tools |
Подпись голосового сервиса | Телефонные звонки с агентами. |
| Вебхуки плагинов | POST /api/plugins/{pluginId}/webhooks/{endpointKey} |
Определяет плагин | Доставлять события плагину. |
Все входящие вебхуки отправляются на https://intelligence-api.veyra.so. При настройке консоль показывает точный адрес вместе с publicId. Держите адрес в тайне: в некоторых режимах он является частью секрета.
Исходящие
| Вебхук | Куда отправляется | Для чего |
|---|---|---|
| Пробуждение агентов | URL из настроек среды выполнения HTTP-агента | Выполнять работу агента на своих серверах. |
Общие правила
- Только HTTPS. Обычный HTTP не принимается.
- Подписи проверяются по исходному телу. Не сериализуйте JSON заново между подписью и отправкой.
- Полезная нагрузка — это данные. Содержимое вебхука доходит до агентов с пометкой «данные», а не как инструкции.
- Повторы безопасны, если вы передаёте стабильный ключ идемпотентности (триггеры рутин) или сервис добавляет собственный идентификатор доставки (GitHub, Svix). Повторы распознаются и не выполняются дважды.
- Каждая доставка записывается — принятая или отклонённая — в журнал активности соответствующей организации.