Webhook de correo
Cómo llega a Veyra a través de AgentMail el correo de la bandeja de un agente, cómo se verifica cada entrega con firmas de Svix y cómo se encadenan las respuestas.
Un agente puede tener su propia dirección de correo. El correo enviado a esa dirección llega a través del proveedor AgentMail, que lo entrega a Veyra en:
POST https://intelligence-api.veyra.so/api/chat-webhooks/agentmail/{publicId}Verificación
AgentMail firma cada entrega con Svix. Antes de leer nada, Veyra comprueba las cabeceras svix-id, svix-timestamp y svix-signature contra el secreto de firma de la bandeja, sobre el cuerpo sin procesar. Una entrega sin firma válida se rechaza.
Respuestas
| Estado | Significado |
|---|---|
204 |
Aceptada. |
403 |
El cuerpo no se entregó como bytes sin procesar o falló la comprobación de la firma. |
Otros 4xx |
La bandeja no existe, está en pausa o se desconectó. |
El proveedor reintenta las entregas fallidas; el svix-id evita que un reintento cree un segundo mensaje.
Qué pasa con un correo
- Un correo nuevo inicia una tarea para el agente de la bandeja.
- Una respuesta en un hilo en el que está el agente continúa esa tarea.
- Los adjuntos se guardan con la tarea tras las comprobaciones habituales de archivos.
El correo saliente del agente siempre pertenece a una tarea. Una respuesta está ligada al mensaje que responde y no puede cambiar sus destinatarios ni su asunto. Un envío en cola aún no se ha entregado; el estado de entrega muestra cuándo lo aceptó el proveedor.
Configúralo
Conecta el correo desde Connectors como un canal de chat. La configuración registra el webhook en AgentMail por ti.
Consulta Correo en la referencia de la API.