Ringostat
Entrar

Webhooks: resultados de las llamadas

~5 min · Cuándo se envía el informe, el payload, la autorización Basic/OAuth 2.0 y la entrega.

Después de cada llamada finalizada Ringostat envía el informe a tu URL. Indícala en la campaña → bloque «Webhook and reports» (o webhookURL en voiceagent_create_campaign).

«When to send webhook»: all — cada llamada (por defecto); answered — solo las llamadas contestadas; interaction — llamadas en las que la persona pulsó una tecla o, en campañas con agente de IA, habló. Un número que agotó todos sus intentos solo se envía con all.

Por defecto es un POST con Content-Type: application/json y un cuerpo JSON-RPC 2.0: method siempre es callCompleted y los datos de la llamada van en params.

POST https://your-app.example/webhooks/ringostat
Content-Type: application/json

{ "jsonrpc":"2.0", "method":"callCompleted", "id":1760437456000000000,
  "params":{ "campaign_id":799, "campaign_name":"Confirmación de pedidos",
    "number_id":1001, "phone_number":"+34612345678", "status":"completed",
    "start_time":1760437400, "answered_time":1760437408, "end_time":1760437456,
    "duration":56, "connected_duration":48, "wait_time":8,
    "custom_fields":{"name":"Juan"}, "dtmf_responses":[],
    "voicemail_detected":false, "transferred_to":"",
    "aisdr_final_response":{ … } } }

status: completed, answered, transferred, voicemail, abandoned, failed o retry. Las horas son segundos Unix y las duraciones, segundos. aisdr_final_response es el informe estructurado de una llamada del agente de IA (aisdr); sus claves salen de los ajustes de informe de la campaña. Un número que agotó sus intentos llega con status failed y los campos attempt_count y max_attempts. La grabación no va en el payload: la devuelve voiceagent_get_call_detail.

En las campañas con agente de IA, el payload incluye además tools: el último resultado correcto de cada herramienta que el agente llamó en la conversación, con su nombre como clave. Así llega al webhook, por ejemplo, el número de una reserva de Servio HMS o el de un pedido creado. Las llamadas fallidas y los rechazos no se incluyen; una herramienta que no se llamó no tiene clave.

"tools": {
  "servio_create_booking": { "ok": true, "booking_id": "100245",
    "payment_link": "https://pay.example.com/booking?account=100245", … } }

En tu propia plantilla de cuerpo, refiérete a ellos como {{tools.<herramienta>.<campo>}}. Añade ? al final si la herramienta puede no haberse llamado: el campo será null, y sin ? el webhook de esa llamada no se envía. Una petición de prueba desde el panel no tiene resultados de herramientas: un campo con ? será null y uno sin ? mostrará un marcador <sample: tools…>.

{"phone":"{{phone_number}}","booking":"{{tools.servio_create_booking.booking_id?}}",
 "payment":"{{tools.servio_create_booking.payment_link?}}"}

Cualquier herramienta de integración funciona igual. Por ejemplo, una guía de Nova Poshta creada durante la llamada: nova_poshta_create_waybill devuelve ttn, delivery_cost, estimated_delivery_date, warehouse y city.

{"phone":"{{phone_number}}","ttn":"{{tools.nova_poshta_create_waybill.ttn?}}",
 "delivery_date":"{{tools.nova_poshta_create_waybill.estimated_delivery_date?}}"}
Las solicitudes no van firmadas. Para autenticarlas, elige HTTP Basic u OAuth 2.0 en «Authorization» del bloque «Webhook and reports» (administradores del proyecto). Ahí también puedes cambiar el método a PUT o PATCH y sustituir el cuerpo por tu propia plantilla JSON o form. Un webhook con autorización necesita una URL https y no sigue redirecciones.
Responde con 2xx en 30 segundos (20 segundos con Basic u OAuth 2.0). Una entrega fallida no se reintenta, salvo una repetición tras un OAuth 401. Cada intento se ve en la ficha de la llamada → «Webhook delivery»; reenvía un informe con «Resend webhook» o voiceagent_resend_call_webhook. Descarta los duplicados por number_id + end_time.