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.
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.