Endpoint
GET /v1/jobs/{job_id}/events
| Header | Valor |
|---|
X-API-Key | Tu API key |
Parámetros de ruta
| Parámetro | Tipo | Descripción |
|---|
job_id | string (UUID) | El job_id retornado al crear el envío |
Ejemplo
curl https://comms.panzo.mx/v1/jobs/c3d4e5f6-a1b2-4321-beef-000000000001/events \
-H "X-API-Key: TU_API_KEY"
Respuesta
{
"job_id": "c3d4e5f6-a1b2-4321-beef-000000000001",
"events": [
{
"event_id": 1001,
"event_type": "sent",
"result": {},
"created_at": "2026-03-30T10:00:00Z"
},
{
"event_id": 1002,
"event_type": "delivered",
"result": {},
"created_at": "2026-03-30T10:00:05Z"
},
{
"event_id": 1003,
"event_type": "read",
"result": {},
"created_at": "2026-03-30T10:01:12Z"
}
]
}
Tipos de evento por canal
WhatsApp
| Evento | Descripción |
|---|
sent | Mensaje enviado a Meta Cloud API |
delivered | Meta confirmó que el dispositivo lo recibió |
read | El destinatario abrió la conversación |
failed | Error en cualquier etapa de la entrega |
Email
| Evento | Descripción |
|---|
sent | Mensaje enviado por Postfix |
opened | El destinatario cargó el pixel de tracking |
clicked | El destinatario hizo clic en un enlace del email |
bounced | Rebote duro devuelto por Postfix |
failed | Error de entrega |
Errores
| Código | Causa |
|---|
401 | API key inválida |
500 | Error interno |
Un job exitoso siempre tiene al menos un evento sent. Los eventos posteriores
(delivered, read, opened, etc.) se agregan conforme el proveedor notifica
la plataforma vía webhook.
