Webhooks

AI4CALL puede llamar a URL configuradas para resultados relacionados con las llamadas. La configuración acepta URL http:// o https://; en producción usa HTTPS, valida el JSON esperado y correlaciona los eventos con la solicitud o llamada guardada por tu aplicación.

Callback de resultado outbound

Configura callResultUrl al iniciar una llamada outbound. AI4CALL envía:

{
  "internal_id": "<YOUR_CORRELATION_ID>",
  "dialstatus": "ANSWER",
  "duration": 42
}

La callback comunica únicamente el resultado outbound; no contiene la transcripción de la conversación.

Conversación y post-call

Configura el endpoint de fin de conversación con PATCH /assistants/{assistantId}/runtime/hangup/conversation-webhook:

{
  "enabled": true,
  "url": "https://example.com/hooks/ai4call",
  "authName": "crm-bearer"
}

authName es el nombre de una autenticación ya guardada para el cliente. Las credenciales correspondientes se resuelven en el servidor y no viajan en la solicitud. Envía authName: null para enviar sin autenticación; desactiva la integración con enabled: false.

Configura la extracción de datos estructurados con PATCH /assistants/{assistantId}/runtime/hangup/schema:

{
  "hangupUrl": "https://example.com/hooks/extracted-data",
  "schema": [{
    "name": "customerIntent",
    "type": "string",
    "description": "Motivo principal de la llamada",
    "required": true
  }]
}

Los tipos de propiedad del esquema son string, number, boolean, enum y object. Configura MCP post-call por separado mediante /runtime/postcall/mcp-config.

No des por hecho que se envía una firma HMAC: la firma webhook no forma parte del contrato actual. Para los payloads de configuración exactos consulta la Referencia API.