Fundamentos
Interacción
Monitoreo en vivo y
campañas salientes.
Conexiones
Apps, API, servidores MCP y proveedores de VoIP que
tus agentes pueden usar.
Calidad y pruebas
Organización
Eventos
Webhooks y herramientas de funciones para
tu propio código.
Organizaciones
Una organización es la unidad de tenencia. Todos los demás recursos — agentes, números de teléfono, llamadas, claves — pertenecen exactamente a una organización. Tu cuenta puede pertenecer a muchas organizaciones; cada una tiene su propio saldo, sus propias claves y su propia lista de miembros. La clave de APIsk_live_ que creas en Organización → Claves
está vinculada a una organización. Esta vinculación es lo que hace que la API REST sea tan
simple: nunca incluyes un id de organización en las rutas de URL, porque tu clave ya
la identifica.
En el dashboard: el selector de organización (en el pie de la barra lateral) y
la configuración de Organización — pestañas de General, Claves, Alertas, Configuración
de facturación e Historial de facturación.
En la API: /v1/orgs,
/v1/developer/api-keys.
Agentes
Un agente es la configuración de IA que opera una llamada. Incluye:- Un prompt que determina lo que dice el agente y cómo se comporta — incluidas acciones de llamada como transferencias, pulsaciones de teclado y colgadas, que son líneas simples del prompt en lugar de una configuración separada.
- Un nivel de motor (
spark,bolt,storm-*): Spark está optimizado para el costo, Bolt para la velocidad y Storm para la inteligencia en prompts complejos. - Una voz junto con un idioma principal e idiomas adicionales opcionales — el agente cambia automáticamente cuando quien llama cambia de idioma. Consulta Idiomas compatibles.
- Capacidades adjuntas: apps conectadas, conexiones de API, bases de conocimiento, servidores MCP y herramientas de funciones en línea.
- Controles de comportamiento: orden de habla, modo de confirmación, pista de fondo, tiempo de espera en espera.
/dashboard/agents). Consulta
Crea tu primer agente de voz.
En la API: /v1/agents — CRUD,
duplicar, transferir, historial de versiones y asistentes de prompts.
Números de teléfono
Un número de teléfono pertenece a una organización y enruta llamadas entrantes a un agente (y puede realizar llamadas salientes). Dos fuentes:- Números de demostración — números reales de EE. UU. aprovisionados del grupo de ThunderPhone, activos en segundos. Solo entrantes, responden con un breve aviso hablado y el dashboard limita a una organización a 10 de ellos. Perfectos para una primera prueba; no para producción.
- Números VoIP — proporcionados desde tu propio proveedor mediante una conexión VoIP. Twilio y Telnyx se conectan directamente (Telnyx tiene una configuración guiada); SignalWire y Vonage estarán disponibles pronto — hoy puedes acceder a ellos mediante configuración manual de SIP, que acepta cualquier troncal SIP. Una vez importados y verificados, los números VoIP admiten llamadas entrantes y salientes.
/dashboard/phone-numbers).
Consulta Obtén un número de teléfono.
En la API: /v1/phone-numbers,
/v1/voip-connections,
/v1/phone-number-labels.
Llamadas
Cada llamada entrante, llamada saliente, simulación y sesión de widget se convierte en un registro de llamada. Una llamada incluye la transcripción completa con roles etiquetados, el historial estructurado de turnos (incluidas las llamadas a herramientas), una grabación, el total de facturación y calificación por IA e informes de problemas opcionales. Mientras una llamada está en curso, puedes abrirla y escuchar en vivo — te unes en silencio y nadie en la llamada te escucha. Una vez que estás escuchando, puedes susurrar: escribe una instrucción que llegue directamente a tu agente durante la llamada; quien llama nunca la escucha y el agente la sigue en tiempo real. En el dashboard: Historial de llamadas (/dashboard/call-history) para
el archivo y los detalles de cada llamada; En vivo para las llamadas en curso. Consulta
Revisa, escucha y guía tus llamadas.
En la API: /v1/calls — lista, transcripción,
historial, audio, calificación, exportación;
/v1/issue-reports.
Widgets web
El widget web ofrece a los visitantes de tu sitio una conversación basada en micrófono con un agente — no se necesita número de teléfono. Se autentica con una clave publicable (pk_live_...) restringida por origen a tus
dominios permitidos, por lo que es segura en código del lado del cliente.
Las claves funcionan en uno de dos modos: agent (vinculada estáticamente a un agente)
o webhook (tu servidor selecciona la configuración por visitante — consulta
Configuración dinámica por llamada). Las sesiones de widget
fluyen por la misma infraestructura de llamadas que las llamadas telefónicas.
En el dashboard: Widgets web (/dashboard/web-widgets) —
crea widgets, establece el modo y el agente, administra los dominios permitidos y
copia el fragmento de inserción. Consulta
Crea un widget web.
En la API: /v1/publishable-key,
/v1/mic-session y la
documentación del SDK de widgets.
Bases de conocimientos
Una base de conocimientos es un conjunto de documentos que tu agente puede buscar durante una llamada para fundamentar sus respuestas — carga archivos directamente o importa desde Google Drive y, luego, adjunta la base de conocimientos a un agente en el constructor. El agente la consulta con una herramienta de búsqueda integrada cuando la conversación lo requiere. En el dashboard: Conocimiento (/dashboard/knowledge) para la
biblioteca de documentos; la sección Conocimiento del constructor para adjuntar una a
un agente. Consulta
Proporciona una base de conocimientos a tu agente.
Conexiones
Las conexiones permiten que los agentes lleguen al mundo exterior. Cuatro tipos, un grupo en la barra lateral:- Apps (
/dashboard/app-connections) — conexiones OAuth con Slack, HubSpot, Salesforce, Google Calendar, Google Sheets y Cal.com. Conéctalas una vez y luego activa herramientas por operación (publicar un mensaje de Slack, crear o actualizar un contacto de HubSpot, reservar un horario de Cal.com…) en cualquier agente. Consulta Conectar apps. - APIs (
/dashboard/api-connections) — convierte cualquier API HTTP en una acción del agente. Pega un comando cURL y el asistente de IA redactará la definición de la herramienta, o créala manualmente; un botón de Probar solicitud realiza una llamada de sandbox antes de lanzar. Consulta Conexiones de API — la interfaz del dashboard de/v1/integrations. - MCP (
/dashboard/mcp-connections) — agrega un servidor de Model Context Protocol mediante URL y permite que el agente use las herramientas que expone. Consulta Agregar un servidor MCP. - VoIP (
/dashboard/voip-connections) — credenciales de proveedor para usar tus propios números telefónicos. Consulta Conectar un proveedor de VoIP.
/v1/integrations y
/v1/voip-connections; consulta también
Crear una integración de herramientas.
Campañas
Una campaña realiza llamadas salientes a escala: carga un CSV de contactos, elige el agente y el número de origen, y configura el horario de llamadas (días y horas, según la zona horaria), la concurrencia y la política de reintentos (intentos máximos y qué resultados — sin respuesta, buzón de voz, fallida — se reintentan). La campaña recorre la lista y registra cada llamada en el Historial de llamadas. En el dashboard: Campañas (/dashboard/campaigns). Consulta
Ejecutar una campaña de llamadas salientes.
Para llamadas programáticas únicas: la
API de llamadas salientes.
Monitoreo en vivo
En vivo muestra cada llamada en curso en toda la organización y te permite abrir cualquiera de ellas para escuchar e intervenir en tiempo real. Es el espacio de supervisión: observa cómo un prompt nuevo recibe su primer tráfico real o vigila una campaña en ejecución. En el dashboard: En vivo (/dashboard/live). Consulta
Observar y supervisar llamadas en vivo.
Simulaciones
Una simulación es una persona que llama con IA y mantiene una conversación real con tu agente — misma ruta de telefonía, transcripción real, evaluación real — para que puedas realizar pruebas antes (y después) de lanzar. Dirígela a un agente o a un número telefónico, escribe tú mismo el escenario de quien llama o genera escenarios con IA a partir del prompt del agente (incluidos casos límite, si los solicitas), y observa la llamada en vivo. Los escenarios se agrupan en suites que fijan una tasa mínima de aprobación y pueden condicionar versiones en CI; las regresiones respecto a la línea base aceptada se informan por escenario. En el dashboard: Simulaciones (/dashboard/simulations), además de
el botón Simulación dentro del creador de agentes. Consulta
Simular una llamada.
En la API: /v1/test-calls y el
ejecutor de suites — consulta Probar un agente de principio a fin.
Experimentos
Un experimento realiza pruebas A/B de configuraciones de agentes con tráfico real: define variantes (distintos prompts, motores o configuraciones), divide el tráfico entre ellas y compara los resultados por variante. Úsalo en lugar de desarrollar manualmente lógica de segmentación en un webhook. En el dashboard: Experimentos (/dashboard/experiments) y
la pestaña A/B en el creador de agentes. Consulta
Experimentos (pruebas A/B).
Problemas
Un problema es un inconveniente marcado en una llamada específica, registrado por un revisor humano o detectado por la evaluación con IA. Los problemas incluyen gravedad, origen y estado, y la página Problemas es la cola de triaje: filtra, inspecciona la llamada problemática y da seguimiento a las correcciones. En el dashboard: Problemas (/dashboard/issues), además del marcado por llamada en Historial de llamadas. Consulta Triaje de problemas.
En la API: /v1/issue-reports.
Informes
Un informe responde una pregunta en lenguaje natural sobre los datos de tus llamadas (“¿Cuáles fueron las tres razones principales por las que quienes llaman pidieron hablar con una persona la semana pasada?”) con un análisis escrito por IA, limitado a los agentes y al intervalo de fechas que elijas. En el dashboard: Informes (/dashboard/reports). Consulta
Informes.
Observabilidad
La observabilidad es la sección de métricas: volumen de llamadas, resultados y calidad a lo largo del tiempo, filtrable por agente e intervalo de tiempo, con exportación para análisis posteriores. En el dashboard: Observabilidad (/dashboard/observability).
Consulta Observabilidad.
Alertas
Una regla de alerta supervisa una métrica (tasa de éxito, tasa de fallas, puntuación promedio, volumen de llamadas, regresiones de suites) durante un intervalo de tiempo y se activa cuando supera tu umbral. Las notificaciones se envían por correo electrónico y Slack, y activan un eventoalert.triggered para tus
endpoints de webhook.
En el dashboard: Organización → Alertas. Consulta
Alertas.
Webhooks
ThunderPhone envía webhooks HTTP POST a tu servidor cuando ocurren eventos durante y después de una llamada. Hay dos modelos de entrega:- Endpoints de webhook (recomendado): administra muchas URL en
/v1/developer/webhook-endpointscon secretos por endpoint y suscripciones a eventos por endpoint. - Webhook heredado de una sola URL: una URL por organización. Se administra en
/v1/webhooko en Organización → General. Se mantiene por compatibilidad con versiones anteriores.
- Los eventos bloqueantes esperan que tu servidor responda con una configuración que determine la llamada en curso: los
eventos de llamadas entrantes
(
telephony.incoming/web.incoming). Tienes hasta 10 segundos para responder; si se agota el tiempo, el agente asignado estáticamente atiende la llamada. - Los eventos no bloqueantes son notificaciones de envío único, reintentadas con espera exponencial: consulta semántica de entrega.
X-ThunderPhone-Signature. Consulta
Verificación de firma.
Herramientas de función
Una herramienta de función es un endpoint HTTP que tu agente puede llamar durante una conversación. Proporcionas a ThunderPhone un esquema de función al estilo de OpenAI junto con una URL de endpoint; el agente decide cuándo llamarlo, y ThunderPhone realiza la solicitud HTTP firmada desde sus servidores y devuelve el resultado al agente. Los agentes también incluyen capacidades integradas de llamada: transferir la llamada, enviar entrada de teclado (DTMF), finalizar la llamada y esperar en espera, que habilitas con líneas simples en el prompt en lugar de definiciones de herramientas. En el dashboard: la sección Conexiones API del creador (consulta Conexiones). En la API:/v1/integrations y
la especificación de herramientas de función.
Equipo y roles
Cada organización tiene una lista de miembros con dos roles: los Miembros crean y operan agentes; los Administradores también administran el equipo y la facturación. Invita por correo electrónico: las invitaciones vencen después de 7 días y se pueden revocar; el menú ⋯ en la fila de un miembro cambia roles o elimina a alguien. El inicio de sesión único se puede configurar para toda la organización: consulta SSO. En el dashboard: Organización → General. Consulta Invita a tu equipo. En la API:/v1/members,
/v1/invites.
Facturación
ThunderPhone es prepago. Cada organización tiene un saldo en USD; las llamadas lo debitan según la tarifa por minuto del agente (nivel del motor más recargos: el constructor muestra la tarifa total en tiempo real a medida que cambias la configuración, y los idiomas premium agregan 2¢/min). Cuando el saldo llega a cero, las llamadas entrantes se rechazan y las llamadas salientes devuelven402 Payment Required.
Agrega fondos manualmente o habilita la recarga automática con un umbral de saldo, un
monto de recarga y un límite mensual de gasto opcional, para que una llamada
nunca se corte a mitad de una oración.
En el panel: Organización → Configuración de facturación e
Historial de facturación. Consulta
Agregar fondos y activar la recarga automática.
En la API: /v1/billing.
El copiloto en la aplicación
El panel incluye un copiloto integrado: pregúntale “¿cómo hago X?” y responderá con base en esta documentación, ofrecerá recorridos paso a paso que resaltan los controles reales y podrá reproducir cualquiera de los recorridos guiados. Es la forma más rápida de encontrar un control que se menciona en esta página. Consulta Preguntar al copiloto en la aplicación.Todo en conjunto
Inicio rápido del panel
El asistente de cinco pasos: agente → facturación → número → simulación → revisión.
Inicio rápido de la API
La misma primera llamada en cuatro solicitudes REST.
Uso del panel
Crea un agente, agrégale fondos, obtén un número, simula y revisa llamadas.
Conecta herramientas y datos
Aplicaciones OAuth, API personalizadas, servidores MCP y proveedores de VoIP.
Analiza y mejora
Informes, observabilidad, experimentos, incidencias y alertas.
Equipo y cuenta
Invitaciones y roles, claves de API, seguridad y SSO.
Recetario para desarrolladores
Las recetas de la API: llamadas entrantes, salientes, configuración dinámica, herramientas y pruebas.
Verifica las firmas de webhooks
Configura correctamente la verificación HMAC una vez y reutilízala en todas partes.