Outbound Call
Outbound Call hace que un flujo llame por teléfono. Eliges uno de tus agentes de voz, el número al que llamar y, si quieres, qué dice el agente al descolgar y qué debe saber de la llamada. El agente marca, deja que quien descuelga salude primero, mantiene la conversación con sus herramientas y su voz de siempre y, al colgar, el flujo recibe un informe de la llamada: si se contestó, si saltó un buzón de voz y un resumen. Si salta un buzón, se nota a los pocos segundos y el agente cuelga, o deja tu mensaje y cuelga.
La llamada usa siempre la versión publicada del agente y sale por el trunk de salida elegido al publicarlo. Cómo preparar el trunk y el agente se explica en Llamadas salientes.
Cuándo usarlo
- Recordar citas el día antes y confirmar o cambiar la hora.
- Confirmar pedidos o entregas por teléfono.
- Hacer encuestas de satisfacción después de un servicio.
- Avisar a un cliente de una incidencia en cuanto la detecta otro flujo.
Configuración
Destination, First Message y Call Context admiten modo herramienta: así, un agente de texto del flujo puede decidir a quién llamar y qué decir.
| Campo | Qué hace |
|---|---|
| Voice Agent | El agente que llama: uno de tus flujos con un Voice Agent. Pulsa el botón de refrescar para verlos. Debe estar publicado y tener un trunk de salida. |
| Outbound Line | La línea por la que sale la llamada: uno de tus trunks de salida. Pulsa refrescar para verlos; solo aparecen los de tu cuenta. Agent’s line (automatic) (por defecto) usa la línea elegida al publicar el agente. |
| Destination | El número al que llamar en formato internacional, por ejemplo +34600000000, o un usuario SIP de la línea de salida, por ejemplo 1001 o alice. Una dirección SIP completa (sip:usuario@host) no se puede marcar. |
| First Message | Lo que dice el agente cuando la persona ha saludado, palabra por palabra. Vacío, empieza con su propio saludo. |
| Call Context | Lo que el agente debe saber de esta llamada: a quién llama, por qué y los datos que necesite. Lo recibe antes de empezar la conversación. |
| Wait For Answer | Activado (por defecto), el flujo espera a que la llamada se conteste o el intento falle, y el resultado dice cuál de las dos. Desactivado, el flujo sigue en cuanto empieza a marcar. |
| Language Model | Solo aparece con Detect Voicemail o Summarize The Call activados. Conecta cualquier modelo de lenguaje (entra por abajo): a los pocos segundos de contestar lee lo dicho para Detect Voicemail y, al terminar, la llamada entera para Summarize The Call. Basta un modelo rápido y barato. Sin modelo, el informe trae solo la transcripción. |
Opciones avanzadas
| Campo | Qué hace |
|---|---|
| Caller Number | El número que ve la persona llamada: uno de los números de la línea elegida (pulsa refrescar) o el que escribas. Line’s default, uno de los números publicados del agente o el de la línea. |
| Ring Timeout (Seconds) | Cuánto suena el teléfono antes de dar el intento por no contestado. Por defecto, 45. |
| Detect Voicemail | Activado (por defecto), a los pocos segundos de contestar el modelo lee lo que ha dicho el otro lado y distingue un buzón de voz o una locución de una persona. El agente no espera a la comprobación: si contesta una persona, no nota nada. Solo se cuelga si el modelo está seguro dos veces seguidas, con 5 segundos de diferencia: así, una persona que ha dicho algo que podría ser un buzón («Hola, soy Marta») tiene tiempo de contestar al agente. Si es un buzón, la llamada termina hacia los 15 segundos y el flujo sigue. Si hay duda, la llamada sigue con normalidad. |
| Check For Voicemail After (Seconds) | Cuántos segundos después de contestar se hace esa comprobación. Deja tiempo a que suene el saludo del buzón. Por defecto, 10 (de 5 a 60). Solo con Detect Voicemail activado. |
| On Voicemail | Qué hacer si contesta un buzón: Hang up (por defecto) cuelga en el acto; Leave a message and hang up dice Voicemail Message y cuelga. Solo con Detect Voicemail activado. |
| Voicemail Message | El mensaje que se deja en el buzón, palabra por palabra, antes de colgar. Escríbelo en el idioma de la persona llamada. Solo con Leave a message and hang up; vacío, cuelga sin decir nada. |
| Summarize The Call | Activado (por defecto), el paso espera al final de la llamada y el modelo escribe un resumen; en producción, la ejecución se pausa mientras dura la llamada. Con esta opción y Detect Voicemail desactivadas, el flujo sigue en cuanto se contesta, como antes. |
| Wait For The Callee To Speak (Seconds) | Al descolgar, la gente saluda primero («¿Sí?», «Dígame»). El agente espera ese saludo y habla después; si en estos segundos nadie dice nada, empieza igualmente. Por defecto, 3. Con 0, habla en cuanto se contesta. |
| Longest Wait (Minutes) | Con el buzón o el resumen activados: si la llamada sigue pasado este tiempo, el paso termina con lo dicho hasta entonces. La llamada no se corta. Por defecto, 30. |
Resultado
La salida Call trae el resultado de la llamada: su estado (answered si se contestó, busy, no_answer, failed, o dialing si no se esperó), si se contestó (answered), el motivo cuando falla el identificador de la llamada (call_id), la línea por la que salió (trunk) y el número que se mostró (caller_number). La llamada aparece en el historial como Saliente.
Cuando el paso espera al final de la llamada, trae además:
| Dato | Qué es |
|---|---|
ended | Si la llamada había terminado. false solo si seguía pasado Longest Wait. |
duration_seconds | Cuánto duró. |
hangup_reason | Cómo terminó: quién colgó, transferencia o motivo del fallo. |
transcript | La conversación, una línea por turno (Agent: y Callee:). |
voicemail | true si contestó un buzón de voz o una locución, false si habló una persona o nadie contestó, y vacío sin modelo o con Detect Voicemail desactivado. Con un buzón, hangup_reason es voicemail detected. |
summary | Un resumen de la llamada en su idioma. Necesita Language Model y Summarize The Call. |
Que se conteste lo dice la red telefónica, no el modelo. El modelo solo lee lo que se dijo.
Puedes conectar la salida a un componente que decida qué hacer, por ejemplo enviar un mensaje si nadie contestó o si saltó el buzón.
En producción, la ejecución se pausa durante la llamada
Cuando el flujo publicado se ejecuta en producción (por la API, un webhook o una programación) con Summarize The Call activado y un Language Model conectado, el flujo no se queda esperando mientras dura la conversación:
- En cuanto se contesta la llamada, la ejecución se pausa en Outbound Call y deja de ocupar el servidor.
- Al colgar (o al pasar Longest Wait), la misma ejecución continúa desde Outbound Call con el informe completo y ejecuta solo lo que va después. Los pasos anteriores no se repiten: usa sus mismos resultados y no se vuelve a llamar.
- En el registro de ejecuciones es una sola ejecución, con el mismo identificador: verás Outbound Call dos veces, primero en pausa (
paused) y después con el informe (resumed), seguido de los pasos posteriores.
Si llamas al flujo por la API y esperas la respuesta, esta llega al contestarse la llamada, sin lo que va después del paso. En el playground, en las pruebas y cuando el paso está en un bucle o en modo batch, Outbound Call espera al final de la llamada como siempre.
Ejemplo
Una clínica recuerda cada tarde las citas del día siguiente.
- Una tarea del Programador lanza cada día a las 18:00 un flujo que consulta las citas de mañana.
- Por cada cita, Outbound Call con Voice Agent «Recordatorio de citas», el teléfono del paciente en Destination y en Call Context: «Paciente Ana García, cita mañana a las 10:30 con la doctora Ruiz. Confirmar o proponer cambio».
- Language Model conectado: al colgar, el paso devuelve el resumen («Confirma la cita de mañana a las 10:30»). Si contesta un buzón, con On Voicemail en Leave a message and hang up deja «Le llamamos de la clínica para recordarle su cita de mañana a las 10:30» y cuelga a los pocos segundos.
- Si la llamada no se contesta o contesta un buzón, el flujo envía un mensaje con la misma información.
Buenas prácticas
- Explica en el prompt del agente que puede ser él quien llama.
- Un buzón de voz cuenta como contestado: conecta Language Model para saberlo por
voicemaily para que la llamada termine en cuanto se detecta. - Para muchas llamadas seguidas, desactiva Wait For Answer y consulta los resultados en el historial.
- Cumple la normativa de llamadas comerciales: horarios, consentimiento y listas de exclusión son responsabilidad del flujo que llama.
Componentes relacionados
- Voice Agent: el agente que hace la llamada.
- Voice Agent Realtime: también puede hacer la llamada.
- Transfer Call: usa el mismo trunk de salida para pasar llamadas a un teléfono.