Introducción
Documentación para ejecutar agentes de voz en producción mediante llamadas telefónicas reales y widgets web integrables: inicios rápidos, guías y la referencia completa de la API de ThunderPhone.
ThunderPhone te permite crear agentes de voz con IA que realizan y responden llamadas telefónicas reales, e impulsan conversaciones mediante micrófono en tu sitio web. La documentación se divide en cuatro pestañas:
Guías de inicio rápido, conceptos e instrucciones para el panel y la API. Empieza aquí si eres nuevo.
Cada endpoint, campo de solicitud y estructura de respuesta.
El widget web integrable: componente de React, hook headless y etiqueta de script de CDN.
Eventos en tiempo real, firma y semántica de entrega.
Lo que puedes crear
Responde llamadas a un número que posees con un agente de IA que sigue tu prompt, usa tus herramientas y transfiere a personas cuando es necesario.
Realiza llamadas programáticas desde tu código: flujos de encuestas, seguimiento o confirmación.
Agrega nuestro widget web integrable a tu sitio para que quienes llaman puedan hacer clic para hablar. No se requiere número telefónico.
Ejecuta escenarios predefinidos con tu agente en lotes para detectar regresiones antes de que las escuchen quienes llaman.
Dos formas de empezar
En el panel (recomendado para tu primer agente): regístrate y el panel te guía mediante un asistente de configuración de cinco pasos: crear un agente, configurar la facturación, agregar un número telefónico, ejecutar una simulación y revisar la llamada. La guía de inicio rápido del panel replica ese asistente paso a paso.
Desde tu terminal: la guía de inicio rápido de la API realiza esa misma primera llamada en cuatro llamadas REST.
- Revisa los conceptos
Conceptos: un mapa de cada objeto que usarás y dónde se encuentra cada uno en el panel.
- Ejecuta una guía de inicio rápido
Guía de inicio rápido del panel o guía de inicio rápido de la API: realiza tu primera llamada con un agente de IA.
- Elige una guía
Sigue una guía práctica para tu escenario o consulta la referencia de la API.
Explora las guías
Crea un agente, agrega fondos, obtén un número, simula y revisa llamadas.
Aplicaciones OAuth, API personalizadas, servidores MCP y proveedores de VoIP.
Informes, observabilidad, experimentos, incidencias y alertas.
Invitaciones y roles, claves de API, seguridad y SSO.
URL base
https://api.thunderphone.com/v1
La autenticación usa el esquema Bearer estándar de OAuth 2.0 con una
clave de API de organización sk_live_. Tu clave identifica automáticamente la
organización de destino; no hay un id de organización en las rutas de URL. Consulta
Autenticación para obtener más detalles.