> ## Documentation Index > Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt > Use this file to discover all available pages before exploring further. # Conceptos básicos > Un mapa de todo lo que hay en la plataforma: qué hace cada objeto, dónde se encuentra en el panel y qué API lo utiliza. ThunderPhone es una plataforma integral para crear, operar y mejorar agentes de voz con IA. Esta página es el mapa: todos los conceptos que encontrarás, una sección breve para cada uno, con la interfaz del dashboard y la API que lo respalda. Revísala una vez y vuelve cuando necesites aclarar algún término. La barra lateral del dashboard refleja esta estructura: [Agentes](#agents), [números de teléfono](#phone-numbers), [widgets web](#web-widgets), [llamadas](#calls), [bases de conocimiento](#knowledge-bases). [Monitoreo en vivo](#live-monitoring) y [campañas](#campaigns) salientes. [Apps, API, servidores MCP y proveedores de VoIP](#connections) que tus agentes pueden usar. [Simulaciones](#simulations), [experimentos](#experiments), [problemas](#issues), [informes](#reports), [observabilidad](#observability). [Equipo y roles](#team-and-roles), [claves de API](#organizations), [alertas](#alerts), [facturación](#billing). [Webhooks](#webhooks) y [herramientas de funciones](#function-tools) 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 API `sk_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`](/api-reference/organizations), [`/v1/developer/api-keys`](/api-reference/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](/es/guides/supported-languages). * Capacidades adjuntas: [apps conectadas](#connections), [conexiones de API](#connections), [bases de conocimiento](#knowledge-bases), [servidores MCP](#connections) y [herramientas de funciones](#function-tools) en línea. * Controles de comportamiento: orden de habla, modo de confirmación, pista de fondo, tiempo de espera en espera. Las modificaciones en el creador se **guardan automáticamente en un borrador**; nada se publica hasta que hagas clic en **Implementar**. Cada implementación se guarda como una instantánea en la pestaña **Historial** del creador, para que puedas inspeccionar y restaurar cualquier versión anterior. **En el dashboard:** **Agentes de voz** → el creador de agentes (`/dashboard/agents`). Consulta [Crea tu primer agente de voz](/es/guides/build-an-agent). **En la API:** [`/v1/agents`](/api-reference/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](#connections). 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. Cada fila de número te permite establecer un modo de enrutamiento, seleccionar el agente entrante y etiquetar el número. **En el dashboard:** **Números de teléfono** (`/dashboard/phone-numbers`). Consulta [Obtén un número de teléfono](/es/guides/get-a-phone-number). **En la API:** [`/v1/phone-numbers`](/api-reference/phone-numbers), [`/v1/voip-connections`](/api-reference/voip-connections), [`/v1/phone-number-labels`](/api-reference/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](/es/guides/review-calls). **En la API:** [`/v1/calls`](/api-reference/calls) — lista, transcripción, historial, audio, calificación, exportación; [`/v1/issue-reports`](/api-reference/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](/es/guides/dynamic-call-config)). 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](/es/guides/embed-a-web-widget-dashboard). **En la API:** [`/v1/publishable-key`](/api-reference/publishable-keys), [`/v1/mic-session`](/api-reference/mic-sessions) y la [documentación del SDK de widgets](/es/widget/overview). *** ## 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](/es/guides/knowledge-base). *** ## 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](/es/guides/connect-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](/es/guides/api-connections) — la interfaz del dashboard de [`/v1/integrations`](/api-reference/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](/es/guides/mcp-servers). * **VoIP** (`/dashboard/voip-connections`) — credenciales de proveedor para [usar tus propios números telefónicos](#phone-numbers). Consulta [Conectar un proveedor de VoIP](/es/guides/voip-providers). **En la API:** [`/v1/integrations`](/api-reference/integrations) y [`/v1/voip-connections`](/api-reference/voip-connections); consulta también [Crear una integración de herramientas](/es/guides/build-tool-integration). *** ## 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](/es/guides/outbound-campaigns). **Para llamadas programáticas únicas:** la [API de llamadas salientes](/es/guides/place-outbound-calls). *** ## 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](#calls) 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](/es/guides/monitor-live-calls). *** ## 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](/es/guides/simulate-a-call). **En la API:** [`/v1/test-calls`](/api-reference/test-calls) y el ejecutor de suites — consulta [Probar un agente de principio a fin](/es/guides/test-agents). *** ## 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)](/es/guides/experiments-ab-testing). *** ## 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](/es/guides/issues). **En la API:** [`/v1/issue-reports`](/api-reference/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](/es/guides/reports). *** ## 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](/es/guides/observability). *** ## 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 evento `alert.triggered` para tus [endpoints de webhook](/es/webhooks/endpoints). **En el dashboard:** **Organización → Alertas**. Consulta [Alertas](/es/guides/alerts). *** ## 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-endpoints`](/es/webhooks/endpoints) con secretos por endpoint y suscripciones a eventos por endpoint. * **Webhook heredado de una sola URL**: una URL por organización. Se administra en [`/v1/webhook`](/api-reference/organizations#legacy-single-url-webhook) o en **Organización → General**. Se mantiene por compatibilidad con versiones anteriores. Los eventos se dividen en dos clases: * Los **eventos bloqueantes** esperan que tu servidor responda con una configuración que determine la llamada en curso: los [eventos de llamadas entrantes](/es/webhooks/call-incoming) (`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](/es/webhooks/overview). Cada solicitud incluye una firma HMAC-SHA256 en `X-ThunderPhone-Signature`. Consulta [Verificación de firma](/es/webhooks/overview). *** ## 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](#connections)). **En la API:** [`/v1/integrations`](/api-reference/integrations) y la [especificación de herramientas de función](/es/tools/overview). *** ## 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](/es/guides/sso). **En el dashboard:** **Organización → General**. Consulta [Invita a tu equipo](/es/guides/invite-your-team). **En la API:** [`/v1/members`](/api-reference/members), [`/v1/invites`](/api-reference/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](/es/guides/supported-languages) agregan 2¢/min). Cuando el saldo llega a cero, las llamadas entrantes se rechazan y las llamadas salientes devuelven `402 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](/es/guides/billing-and-topups). **En la API:** [`/v1/billing`](/api-reference/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](/es/guides/ask-the-copilot). *** ## Todo en conjunto El asistente de cinco pasos: agente → facturación → número → simulación → revisión. La misma primera llamada en cuatro solicitudes REST. Crea un agente, agrégale 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. Las recetas de la API: llamadas entrantes, salientes, configuración dinámica, herramientas y pruebas. Configura correctamente la verificación HMAC una vez y reutilízala en todas partes.