Skip to main content
¿Vas a crear tu primer agente manualmente? El dashboard te guía por este mismo flujo — crear el agente, agregar un número, simular, revisar — con un asistente guiado. Comienza con la guía de inicio rápido del dashboard.
El flujo canónico de “contestar un teléfono con IA”, desde tu terminal. Vas a:
  1. Crear un agente con un prompt y una voz.
  2. Aprovisionar (o traer) un número de teléfono y asignar el agente como su controlador de llamadas entrantes.
  3. Llamar al número. Observar el registro de llamadas, la transcripción y la grabación.
Total de llamadas a la API: cuatro. Tiempo total: menos de cinco minutos.

​
1. Crea un agente

Un agente reúne el prompt, la voz y el nivel de producto que gestionarán la llamada. Consulta Agentes para ver todos los campos de configuración; lo mínimo es:
Guarda el id devuelto; lo necesitarás en el paso 2.
Elige spark para preguntas y respuestas simples al menor costo, y bolt cuando la velocidad sea lo más importante. Actualiza a storm-base-with-ack cuando tu prompt necesite un razonamiento más profundo y pueda tolerar una frase de relleno de medio segundo mientras el modelo piensa. Consulta los niveles de producto.

​
2. Obtén un número de teléfono

Si solo necesitas un número al que llamar, aprovisiona un número de demostración del grupo de ThunderPhone:
La respuesta incluye un id y un number en E.164. Los números de demostración comienzan con status="provisioning" y pasan a active en unos segundos; consulta periódicamente GET /v1/phone-numbers/{id} para observar la transición si te interesa.
Para producción, omite los números de demostración y trae tus propios números mediante VoIP. Los números de demostración solo admiten llamadas entrantes y tienen un límite de volumen.

​
3. Asigna el agente

Asocia el agente del paso 1 con la dirección entrante del número:
Eso es todo: el número está activo. También puedes establecer outbound_agent_id en el mismo PATCH para que el número también esté listo para realizar llamadas salientes.

​
4. Atiende una llamada

Llama al número desde tu teléfono. El agente contesta, se presenta según tu prompt y comienza la conversación. Mientras la llamada está en curso, aparece en GET /v1/calls con status="in_progress". Cuando termina, el registro se actualiza con end_reason, duration_seconds, billable_minutes y, con el tiempo, una URL de grabación y una calificación de IA.

​
5. Revisa los resultados

Obtén la lista de llamadas recientes:
Obtén la transcripción:
Y la URL de la grabación (de corta duración y firmada):
Si te suscribiste al webhook telephony.complete, recibirás los mismos datos como un POST en tu servidor; consulta call.complete.

​
Próximos pasos

Configuración dinámica por llamada

Elige un agente diferente para cada persona que llama según el número de teléfono o una lógica personalizada en un webhook.

Agregar integraciones de herramientas

Permite que el agente llame a tus API durante la conversación.

Recibir webhooks de call.complete

Envía cada llamada finalizada a tu pipeline de CRM o analítica.

Evaluación con IA e informes de problemas

Evalúa cada llamada automáticamente y envía las marcadas para revisión.