Llamadas salientes y campañas

Cómo lanzar una llamada saliente puntual y crear campañas por lista (CSV) con ritmo controlado en Atendy.

Llamadas salientes y campañas

Con las llamadas salientes tu agente no solo espera a que le llamen: es él quien marca. Puedes lanzar una llamada suelta a un número concreto o preparar una campaña que recorra una lista entera de contactos, uno a uno, al ritmo que tú decidas. En ambos casos el agente habla con la misma voz, el mismo saludo y las mismas herramientas que ya configuraste.

Requisitos antes de empezar

Para que una llamada saliente funcione necesitas tres cosas listas.

Lanzar una llamada saliente puntual

Es la forma más rápida de que el agente llame a una sola persona: por ejemplo, para confirmar una cita o devolver una llamada. Se hace desde la sección Llamadas salientes del panel.

1. Entra en Llamadas salientes en el menú del panel.
2. Elige el agente que hará la llamada.
3. Selecciona el número de origen (el que aparecerá como remitente).
4. Escribe el número de destino en formato internacional, con prefijo de país (por ejemplo +34600000000).
5. Si tu agente usa variables, rellena los datos de esa persona (por ejemplo su nombre).
6. Pulsa para lanzar la llamada. El agente marca en ese momento y, cuando la persona descuelga, empieza a hablar.

Campañas por lista (CSV)

Una campaña es una lista de contactos que el agente llama de forma automática, uno detrás de otro. Tú subes la lista en un archivo CSV, eliges el agente y el número de origen, marcas el ritmo, y Atendy se encarga de ir marcando. Puedes pausar, reanudar o cancelar la campaña cuando quieras.

Preparar la lista en un CSV

Un CSV es un archivo de texto con columnas separadas por comas; lo puedes crear con Excel, Google Sheets o Numbers y exportarlo como CSV. La primera fila son los nombres de las columnas (la cabecera) y cada fila siguiente es un contacto. Necesitas al menos una columna con el teléfono de destino.

telefono,nombre,cita
+34600111222,Ana,martes a las 10:00
+34600333444,Luis,miércoles a las 17:30
+34600555666,María,jueves a las 12:00

1. Crea una hoja de cálculo con una columna de teléfono (en formato internacional, con +34 u otro prefijo).
2. Añade las columnas de datos que tu agente necesite: nombre, cita, referencia de pedido, lo que uses en el prompt o el saludo.
3. Rellena una fila por contacto.
4. Exporta o guarda el archivo como CSV.
5. Sube ese archivo al crear la campaña en Llamadas salientes.

Variables por contacto

Cada columna extra de tu CSV se convierte en una variable que puedes usar en el prompt o el saludo del agente escribiéndola entre dobles llaves. Así cada llamada suena personalizada sin crear un agente por cliente. Por ejemplo, si tu CSV tiene las columnas nombre y cita, en el saludo del agente puedes escribir:

Hola {{nombre}}, le llamo de la clínica para confirmar su cita del {{cita}}.

En la llamada a Ana se dirá "Hola Ana, le llamo de la clínica para confirmar su cita del martes a las 10:00", y en la de Luis se sustituirá por sus datos. Además, siempre tienes disponible la variable {{numero_origen}}, que trae el teléfono de la persona con la que se habla.

Crear y lanzar la campaña con ritmo

El ritmo es el tiempo que Atendy espera entre una llamada y la siguiente. Sirve para no saturar tu operación ni recibir todas las respuestas a la vez: si tu equipo puede atender los desvíos o el trabajo que generan las llamadas, un ritmo más rápido acaba antes; si prefieres ir con calma, aumenta la pausa entre llamadas.

1. En Llamadas salientes, crea una campaña nueva y ponle un nombre.
2. Elige el agente y el número de origen.
3. Sube tu archivo CSV con la lista de contactos.
4. Revisa que las columnas se han reconocido bien (teléfono y variables).
5. Define el ritmo: cuántos segundos esperar entre una llamada y la siguiente.
6. Inicia la campaña. Atendy irá marcando contacto a contacto respetando ese ritmo, aunque cierres la pestaña.

Horario de llamada

Como la campaña sigue marcando aunque cierres la pestaña, conviene decirle a qué horas puede llamar: si lanzas una lista larga por la tarde, sin horario seguiría llamando de madrugada. Al crear la campaña marca «Llamar solo en este horario» e indica desde y hasta (por defecto de 09:00 a 21:00). Puedes además limitarla a días laborables para no llamar en fin de semana.

Las horas se interpretan en la zona horaria del agente, la que configuraste en su pestaña Voz e idiomas. Fuera de ese horario la campaña queda en espera (la verás marcada como «Fuera de horario») y continúa sola en cuanto vuelve a estar dentro, retomando por el contacto donde iba. No tienes que reanudarla a mano.

Lista de exclusión (no volver a llamar)

Cuando alguien le dice a tu agente que no quiere recibir más llamadas, el agente lo registra y ese número queda en tu lista de exclusión. Atendy la respeta en todas tus campañas: al subir una lista, los números excluidos se descartan antes de empezar (te dice cuántos), y si alguien pide la baja mientras la campaña está en marcha, su llamada tampoco se realiza y aparece como «Excluido» en el detalle.

Seguir y controlar una campaña

Desde la misma pantalla ves el progreso en directo: cuántas llamadas se han lanzado, cuántas han fallado y cuántas quedan pendientes. En cualquier momento puedes pausar la campaña (deja de marcar y guarda el punto donde iba), reanudarla o cancelarla del todo.

Cada llamada realizada aparece en Analítica con su grabación, transcripción, resumen, sentimiento y las herramientas que el agente usó. En el panel Resumen ves las métricas de negocio agregadas: número de llamadas, minutos, canal y sentimiento.

Lanzar llamadas desde tus propias herramientas (API)

Si trabajas con n8n u otra aplicación y quieres disparar llamadas desde tus flujos, Atendy tiene una API pública. Requiere plan Escala. Primero crea una clave de API en la sección de Llamadas salientes (tendrá el formato sk_live_...). Guárdala en un sitio seguro: solo se muestra una vez.

Para lanzar una llamada, envía una petición POST autenticada con la cabecera x-api-key. En vars puedes incluir las variables que se inyectarán como {{variable}} en el prompt y el saludo, igual que en las campañas.

curl -X POST https://atendy.es/api/v1/calls \
  -H "x-api-key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "uuid-de-tu-agente",
    "to": "+34600000000",
    "from": "+34...",
    "vars": { "nombre": "Ana" }
  }'

Una respuesta correcta (200) devuelve el identificador de la llamada, la sala y el estado inicial:

{ "call_id": "...", "room": "...", "status": "dialing" }