Обзор вебхуков

Все вебхуки, которые Veyra Intelligence принимает и отправляет (триггеры рутин, чат-сервисы, GitHub, почта, голос, плагины и пробуждение HTTP-агентов), и как проходит аутентификация каждого.

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

Вебхуки передают события между 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). Повторы распознаются и не выполняются дважды.
  • Каждая доставка записывается — принятая или отклонённая — в журнал активности соответствующей организации.
Вебхуки