Webhooks Salientes
Cuando ocurre un evento en tu cuenta, INYECTAIA hace un POST a la URL que configuraste. El payload llega en JSON con la siguiente estructura:
{
"evento": "mensaje_recibido",
"cuenta_id": "uuid",
"timestamp": "2025-01-01T00:00:00Z",
"datos": { ... }
}Para verificar que la llamada proviene de INYECTAIA, compará el header x-webhook-secret contra el valor que configuraste en el panel. Si no coincide, rechazá la petición con 401.
Si tu endpoint devuelve un status diferente de 2xx, el sistema reintenta 3 veces con delays de 0 ms, 500 ms y 1 000 ms.
Eventos disponibles
| Evento | Cuándo se dispara |
|---|---|
mensaje_recibido | Un contacto envía un mensaje al número conectado. |
mensaje_enviado | El agente o un operador humano envía un mensaje. |
contacto_nuevo | Se registra un contacto nuevo en el CRM. |
contacto_actualizado | Se editan los datos capturados de un lead. |
cita_agendada | El agente agenda una cita en el calendario. |
cita_modificada | Se cambia la hora o los datos de una cita existente. |
cita_cancelada | Una cita es cancelada por el agente o el operador. |
llamada_terminada | Finaliza una llamada saliente gestionada por Vapi. |
handoff_humano | El agente detecta que la conversación requiere atención humana. |
API Keys
Cada cuenta puede generar API keys desde Configuración → Integraciones → API Keys. Podés crear múltiples keys con distintos nombres para identificar cada integración.
Incluí la key en el header Authorization de cada request:
Authorization: Bearer {tu_api_key}Las keys no tienen fecha de expiración por defecto. Podés revocarlas desde el panel en cualquier momento.
Configuración en el panel
Para agregar un webhook desde el panel:
- Andá a Configuración → Integraciones → Webhooks.
- Hacé click en Nuevo webhook.
- Ingresá la URL de tu endpoint y elegí los eventos que querés recibir.
- Copiá el webhook secret generado y usalo en tu servidor para verificar las llamadas.
- Guardá y hacé un test desde el panel para confirmar que llegue correctamente.
¿Todavía no tenés cuenta? Empezar gratis →