Skip to main content
Las llamadas salientes te permiten proporcionar un número de destino y una configuración de agente a ThunderPhone para que la IA realice la llamada en tu nombre. Casos de uso habituales:
  • Confirmaciones de citas
  • Llamadas de seguimiento de encuestas
  • Seguimientos de “segundo intento” después de una llamada perdida
  • Notificaciones de tipo despacho
¿Llamas a una lista completa? La función Campañas del dashboard (/dashboard/campaigns) recibe un CSV de contactos y gestiona por ti las ventanas de llamadas según las zonas horarias, la concurrencia y la política de reintentos. Esta guía cubre llamadas programáticas individuales.

​
Requisitos previos

1

Usa un número de VoIP

Las llamadas salientes requieren que tengas el from_number mediante una conexión de VoIP. Los números de demostración son solo para llamadas entrantes. Consulta Usa tus propios números.
2

Crea un agente

Un prompt orientado a llamadas salientes suele comenzar con el agente identificándose y explicando su propósito: “Hola, le habla Acme para confirmar su cita de mañana a las 3 p. m.…” Configura outbound_speak_order como agent_first (el valor predeterminado).
3

Mantén un saldo positivo

Las llamadas salientes devuelven 402 Payment Required si el saldo es ≤ $0.00. Recarga saldo mediante POST /v1/billing/top-up o activa la recarga automática.

​
Realiza una llamada con un agente guardado

La forma más sencilla: referencia un agente por ID:
Respuesta:
status: "initiated" solo significa que se aceptó la solicitud: la llamada aún no está conectada. Consulta GET /v1/calls/{call_id} para ver el estado en tiempo real (in_progress → completed / failed).

​
Realiza una llamada con configuración en línea

Si quieres un prompt único que no vale la pena guardar como agente, pasa config en su lugar. La estructura coincide con el esquema de respuesta del webhook call.incoming:

​
Sigue la llamada

En paralelo, suscríbete al webhook telephony.complete: es la forma más rápida de saber que una llamada terminó. Si no puedes aceptar webhooks entrantes, consulta GET /v1/calls/{call_id} cada pocos segundos; el registro incluye end_reason, duration_seconds y la URL de la grabación una vez que termina la llamada.

​
Errores que vale la pena controlar

​
Control del tiempo en espera

Las llamadas salientes que se prolongan porque la persona que recibe la llamada tarda en responder (árboles IVR, colas) se pueden limitar con max_hold_seconds:
El agente cuelga si no ha recibido audio humano en los últimos N segundos. El valor predeterminado es 900 (15 minutos).

​
Próximos pasos

Referencia de llamadas salientes

Cada campo de solicitud y código de error.

Recibir call.complete

Transmite llamadas salientes finalizadas a tu sistema.

Facturación

Recarga automática para que las llamadas salientes nunca fallen por saldo.

Probar agentes salientes

Ejecuta una prueba de tu agente saliente antes de producción.