Webhooks

Los dos webhooks del agente en Atendy: el de entrada (antes de la llamada) y el de fin de llamada, con la estructura del payload y buenas prácticas.

Webhooks (API)

Un webhook es una URL tuya (o de una herramienta como n8n, Make o tu propio servidor) a la que Atendy envía datos de forma automática en un momento concreto de la llamada. Cada agente puede tener dos webhooks, y sirven para cosas distintas: uno se dispara antes de que empiece la conversación y el otro cuando la llamada termina.

Ambos se configuran dentro del agente, en su asistente de herramientas o ajustes del agente, pegando la URL correspondiente. Funcionan tanto en llamadas de teléfono como en las pruebas desde el navegador.

Webhook de entrada (antes de la llamada)

En cuanto entra una llamada (o empiezas una prueba), Atendy hace una petición a tu URL de entrada con los datos que ya conoce, sobre todo el número de teléfono de quien llama. Tu servidor puede usar ese número para buscar a la persona en tu sistema y responder con datos suyos. Todo lo que devuelvas queda disponible como variables dentro del prompt y del saludo.

1. Prepara una URL en tu servidor o herramienta que reciba una petición POST con JSON.
2. En el agente, pega esa URL en el campo del webhook de entrada.
3. Cuando llegue una llamada, Atendy enviará a esa URL el número de origen y el identificador del agente.
4. Tu servidor responde con un JSON que contenga las variables que quieras usar (por ejemplo el nombre del cliente).
5. El agente arranca la conversación ya con esos datos cargados.

Esto es un ejemplo de lo que Atendy envía a tu webhook de entrada:

{
  "agent_id": "a1b2c3d4-0000-0000-0000-000000000000",
  "caller_number": "+34600123456",
  "room_name": "call-_+34600123456_a1B2c3"
}

Y esto es lo que tu servidor debe responder: un JSON con las variables que quieras poner a disposición del agente. Los nombres de las claves son los que luego usarás entre dobles llaves.

{
  "nombre": "Ana García",
  "plan": "Premium",
  "ultima_cita": "2026-07-02"
}

Usar las variables en el prompt y el saludo

Cada variable que devuelva el webhook de entrada se escribe entre dobles llaves y Atendy la sustituye por su valor real justo antes de hablar. Puedes usarlas tanto en el prompt del sistema como en el saludo inicial.

Saludo inicial:
Hola {{nombre}}, gracias por llamar. Veo que tienes el plan {{plan}}.

Prompt del sistema:
Atiendes a {{nombre}}, cliente con plan {{plan}}.
Su última cita fue el {{ultima_cita}}. Ayúdale con lo que necesite
sobre su cuenta y confirma sus datos si hace falta.

Webhook de fin de llamada

Cuando la llamada termina y Atendy ha analizado la conversación, envía a tu URL de fin de llamada un único mensaje con lo ocurrido: la transcripción completa, un resumen, los KPIs que hayas definido y los datos de la llamada. Es el momento ideal para volcar el resultado en tu CRM, avisar a tu equipo o lanzar un flujo en n8n.

El payload usa la misma estructura que el evento call_analyzed de Retell, para que los flujos ya construidos para ese formato funcionen sin cambios. Todo cuelga de un objeto call:

{
  "event": "call_analyzed",
  "call": {
    "call_id": "call-out-4f3a9c2b1d7e",
    "agent_id": "a1b2c3d4-0000-0000-0000-000000000000",
    "agent_name": "Recepción",
    "call_status": "ended",
    "start_timestamp": 1786303502000,
    "end_timestamp": 1786303645000,
    "duration_ms": 143000,
    "from_number": "+34911234567",
    "to_number": "+34600123456",
    "direction": "outbound",
    "disconnection_reason": "agent_hangup",
    "transcript": "Agent: Hola Ana, le llamo por su cita.\nUser: Sí, quería cambiarla.",
    "transcript_object": [
      { "role": "agent", "content": "Hola Ana, le llamo por su cita." },
      { "role": "user", "content": "Sí, quería cambiarla." }
    ],
    "call_analysis": {
      "call_summary": "La clienta pidió cambiar su cita del jueves al viernes por la tarde. Se reprogramó y se le confirmó.",
      "custom_analysis_data": {
        "cita_reprogramada": true,
        "motivo": "cambio de fecha"
      }
    }
  }
}

Campos que recibes, todos dentro de call:

Buenas prácticas

Receta: cada llamada en una fila de tu Excel o Google Sheets (n8n)

Es lo que más se pide: que cada llamada quede apuntada en la hoja donde el negocio ya lleva sus clientes, esté en Google Sheets, en OneDrive o en Dropbox. Se hace con el webhook de fin de llamada y un flujo de n8n de tres nodos. Con Make o Zapier es igual, cambian los nombres.

1. En n8n crea un flujo nuevo y añade un nodo Webhook con método POST. Copia la URL de producción que te da.
2. En Atendy, abre el agente → Integraciones y pega esa URL en «Webhook de agente · post-llamada». Guarda.
3. Haz una llamada de prueba al agente (o usa Probar agente). Al minuto llegará a n8n el evento call_analyzed: en el nodo Webhook pulsa «Listen for test event» antes de llamar para ver los campos.
4. Añade un nodo Google Sheets (acción «Append row») o Microsoft Excel 365 («Add a row») y apunta a tu hoja. Si tu archivo está en Dropbox, n8n tiene nodo de Dropbox pero no edita celdas: para Excel en Dropbox lo práctico es que la hoja viva en OneDrive o en Google Sheets, o mover el archivo.
5. Mapea las columnas arrastrando desde el evento: fecha = {{ $json.call.start_timestamp }} (milisegundos; conviértelo con DateTime.fromMillis), teléfono = call.from_number en entrantes y call.to_number en salientes, nombre = call.crm_client.name, número de cliente = call.crm_client.client_ref, resumen = call.call_analysis.call_summary, y cada Dato del agente = call.call_analysis.custom_analysis_data.<nombre_del_dato>. Guarda también call.call_id: es tu referencia única.
6. Si quieres actualizar la fila del cliente en vez de añadir una por llamada, usa la acción «Update row» con la columna del teléfono (o del número de cliente) como clave de búsqueda, y añade las columnas nuevas a la derecha de las tuyas.
7. Activa el flujo. A partir de ahí cada llamada aparece en tu hoja un par de minutos después de colgar.