Visión general de los webhooks

Cada webhook que Veyra Intelligence recibe y envía (disparadores de rutinas, proveedores de chat, GitHub, correo, voz, plugins y activaciones de agentes HTTP) y cómo se autentica cada uno.

Veyra Docs TeamActualizado el 1 min de lecturaVersión 2 · Historial

Los webhooks mueven eventos entre Veyra y otros sistemas sin consultas periódicas. Algunos entran (tu sistema o un proveedor avisa a Veyra de que algo ocurrió); uno sale (Veyra despierta a un agente que se ejecuta en tus servidores).

Entrantes

Webhook Dirección Autenticado con Para
Disparador de rutina POST /api/routine-triggers/public/{publicId}/fire Secreto bearer, firma HMAC o firma del proveedor Iniciar una rutina desde tus sistemas, alertas o CI.
Proveedores de chat POST /api/chat-webhooks/{publicId}/{provider} La firma propia del proveedor Que Slack, Teams, Discord, Telegram y GitHub hablen con los agentes.
Revisiones de pull requests de GitHub Proveedor de chat o disparador de rutina Firma de GitHub o secreto bearer Que los agentes revisen pull requests.
Correo POST /api/chat-webhooks/agentmail/{publicId} Firma de Svix Recibir correo en la bandeja de un agente.
Voz POST /api/voice-webhooks/{publicId}/events y /tools La firma del proveedor de voz Llamadas telefónicas con agentes.
Webhooks de plugins POST /api/plugins/{pluginId}/webhooks/{endpointKey} Lo define el plugin Entregar eventos a un plugin.

Todos los webhooks entrantes se envían a https://intelligence-api.veyra.so. La consola muestra la dirección exacta, con su publicId, cuando configuras uno. Trata la dirección como privada: en algunos modos forma parte del secreto.

Salientes

Webhook Se envía a Para
Activación de agentes La URL de los ajustes de ejecución de un agente HTTP Ejecutar el trabajo de un agente en tus propios servidores.

Reglas que se aplican a todos

  • Solo HTTPS. No se acepta HTTP sin cifrar.
  • Las firmas se comprueban sobre el cuerpo sin procesar. No vuelvas a serializar el JSON entre la firma y el envío.
  • Las cargas son datos. El contenido de un webhook llega a los agentes marcado como datos, nunca como instrucciones.
  • Los reintentos son seguros si envías una clave de idempotencia estable (disparadores de rutina) o si el proveedor incluye su propio ID de entrega (GitHub, Svix). Las repeticiones se reconocen y no se ejecutan dos veces.
  • Cada entrega queda registrada, aceptada o rechazada, en el registro de actividad de la organización a la que pertenece.
Webhooks