> ## 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.
# Referencia de configuración del agente de voz
> Explicación de cada configuración del agente de voz de ThunderPhone: niveles, voces, idiomas, confirmaciones, herramientas, orden de habla, buzón de voz, anuncios de consentimiento, manejo de silencios, pruebas y despliegue.
Abre **Agentes de voz**, selecciona un agente y usa su pestaña **Configuración** para controlar
cómo suena, razona, inicia llamadas, usa herramientas, gestiona el silencio y el buzón de voz,
y contacta a quienes llaman. Los cambios se guardan automáticamente en un borrador; el tráfico de
producción no cambia hasta que selecciones **Implementar**.
Esta página es la referencia completa del panel. Para ver nombres de campos y ejemplos de
solicitudes, usa la [referencia de la API de agentes](/api-reference/agents).
## Prompt e identidad
El nombre del agente lo identifica en todo el panel, los informes, el historial de llamadas
y los portales de clientes. El prompt es el guion operativo del agente: personalidad,
información de la empresa, preguntas obligatorias, política de escalamiento y acciones de llamada.
El editor de prompts muestra tokens estimados y señala problemas comunes, como un
prompt vacío, marcadores de posición de plantilla sin resolver, una ruta de escalamiento faltante o
un prompt muy extenso. Los primeros **5,000 tokens estimados** están incluidos; los
prompts más largos usan [precios con recargo por bloques](/es/guides/pricing).
Puedes escribir directamente en el prompt las transferencias, pulsaciones del teclado, comportamiento en espera
y decisiones para colgar. Conecta herramientas de API, aplicaciones, MCP o conocimiento cuando el
agente necesite datos o acciones externos.
## Nivel de modelo
| Nivel | Precio base | Uso recomendado |
| --------- | ----------: | --------------------------------------------------------------- |
| **Spark** | 2¢/min | Llamadas sencillas y con sensibilidad al costo. |
| **Bolt** | 5¢/min | Respuestas rápidas y flujos de trabajo cotidianos equilibrados. |
| **Storm** | 9¢/min | Instrucciones complejas, comprensión de audio y razonamiento. |
Storm ofrece dos controles opcionales:
* **Confirmación** — **Ninguna** permanece en silencio mientras prepara la respuesta completa;
**Tick** reproduce un suave sonido de espera; **Verbal** dice una breve confirmación
y añade **2¢/min**. El texto verbal puede generarse a partir del prompt principal o
proporcionarse manualmente mediante la API.
* **Inteligencia adicional** — añade razonamiento más profundo para llamadas complejas y
**3¢/min**.
El creador muestra continuamente el **costo total por minuto** del agente, incluidos
el nivel, la ruta de voz/idioma, la longitud del prompt, la confirmación verbal, la inteligencia
adicional y la supervisión.
## Voz, fondo e idiomas
Selecciona una voz y reproduce su muestra antes de implementar. El selector solo ofrece
voces compatibles con todos los idiomas seleccionados y marca las combinaciones premium
con su recargo. Tus voces personalizadas aparecerán en el mismo selector cuando estén listas.
Consulta [Biblioteca de voces y voces personalizadas](/es/guides/voice-library).
La **pista de fondo** puede ser:
* **Ninguna** — sin audio ambiental.
* **Centro de llamadas** — una ambientación de centro de llamadas, con vista previa en el panel.
Configura un **idioma principal** y luego cualquier cantidad de **idiomas adicionales**. El
agente detecta automáticamente cuando quien llama cambia a un idioma seleccionado y
responde en ese idioma. Algunas combinaciones de voz/idioma añaden **3¢/min**; consulta el
catálogo generado de [Idiomas compatibles](/es/guides/supported-languages).
## Capacidades conectadas
La pestaña Configuración tiene cuatro secciones de capacidades que puedes conectar de forma independiente:
| Sección | Úsala para |
| --------------------------- | ---------------------------------------------------------------------------------------------- |
| **Aplicaciones conectadas** | Operaciones aprobadas en Google Calendar, Google Sheets, Slack, HubSpot, Salesforce o Cal.com. |
| **Conexiones de API** | Tus propios endpoints HTTP, descritos como funciones invocables. |
| **Conocimiento** | Archivos o contenido web que el agente puede buscar durante una llamada. |
| **Servidores MCP** | Herramientas en caché detectadas desde servidores remotos de Model Context Protocol. |
Una vinculación forma parte del borrador y queda disponible para las llamadas de producción
después de la implementación. Primero configura los recursos en **Conexiones** o
**Conocimiento** y luego conéctalos al agente.
## Endpoints telefónicos y web
En **Números de teléfono**, conecta un número existente, aprovisiona un número de demostración o
importa un número mediante una conexión VoIP. Un número puede usar distintos agentes
para direcciones entrantes y salientes.
En **Widgets web**, conecta un widget para que los visitantes puedan hablar con el agente desde un
sitio. La disponibilidad del widget también se puede activar o desactivar como parte de la
configuración del agente.
## Comportamiento avanzado
Expande **Avanzado** en la parte inferior de Configuración para acceder a los siguientes controles.
### Supervisión
Cuando está activada, un segundo monitor de IA verifica cada turno del agente con las instrucciones y puede intervenir de forma silenciosa. La supervisión agrega **8¢/min** y no está disponible en Bolt.
### Tono de conexión
Reproduce un tono corto inmediatamente después de que se conecte la llamada y antes de que cualquiera de las partes hable.
### Sonido de herramienta
Elige el sonido que emite la herramienta de sonido invocable mediante prompt:
* **Ninguno** — la herramienta no se ofrece.
* **Campanilla**, **Tintineo** o **Bip** — cada uno puede previsualizarse en el editor.
### Quién habla primero
Configura las llamadas entrantes y salientes por separado:
* **Entrantes:** el agente habla primero o habla primero quien llama.
* **Salientes:** el agente habla primero o habla primero la persona llamada.
Esta configuración es útil para marcadores salientes que deben esperar a una persona o a un menú telefónico antes de comenzar el guion.
### Gestión del buzón de voz
Elige qué sucede cuando una llamada saliente llega al buzón de voz:
| Opción | Comportamiento |
| ----------------------------------- | ------------------------------------------------------------------------------ |
| **Dejar que el agente decida** | El prompt y el contexto de la conversación determinan si debe hablar o colgar. |
| **Colgar en silencio** | Finaliza sin dejar un mensaje. |
| **Dejar un mensaje y luego colgar** | Reproduce el mensaje configurado y finaliza la llamada. |
Los mensajes del buzón de voz pueden contener hasta **2,000 caracteres** y admiten
`{agent_name}` y `{org_name}`. Consulta
[Precios](/es/guides/pricing) para saber cómo se factura
el tiempo de llamada.
### Anuncio de consentimiento
De forma predeterminada, un anuncio breve al inicio de cada llamada informa a quien llama
que está hablando con un asistente de IA y que la llamada se graba. Puedes editar el texto
del anuncio, con un máximo de **2,000 caracteres**; se reproduce literalmente
en el idioma del agente.
Desactivar el anuncio en un agente que cumple los requisitos requiere que un administrador de la organización
confirme que la organización proporcionará cualquier aviso legalmente requerido y
obtendrá cualquier consentimiento legalmente requerido. Volver a activarlo y desactivarlo
más adelante requiere una nueva confirmación. Revisa la
[guía sobre leyes de consentimiento para grabaciones](/es/guides/recording-consent-laws) antes de cambiar
esta configuración.
### Verificaciones de silencio
Cuando está activada, el agente verifica si quien llama sigue presente después de un
período de silencio, repite hasta el límite que establezcas y luego cuelga:
* **Segundos antes de la verificación:** 10–120 segundos.
* **Máximo de verificaciones:** 1–10.
Los valores predeterminados son 15 segundos y 3 verificaciones.
## Pestañas y ciclo de vida del editor
| Pestaña o acción | Propósito |
| -------------------- | --------------------------------------------------------------------------------------------------------------- |
| **En vivo / Hablar** | Habla con el borrador actual en tu navegador e inspecciona la transcripción y la actividad de las herramientas. |
| **Llamadas** | Revisa las llamadas gestionadas por este agente. |
| **A/B** | Crea variantes de prompts o configuraciones y compara resultados en vivo. |
| **Simular** | Ejecuta escenarios guardados o ad hoc de quienes llaman mediante IA con el borrador. |
| **Validación** | Reproduce turnos congelados de llamadas reales con el borrador antes de la implementación. |
| **Historial** | Compara revisiones implementadas y restaura una en el borrador. |
| **Descartar** | Revierte cada configuración pendiente del borrador a la versión implementada. |
| **Implementar** | Promueve de forma atómica el borrador completo y crea una revisión. |
Si otro editor guarda el mismo agente después de que lo hayas cargado, ThunderPhone
detiene el guardado o la implementación en conflicto y te pide actualizar en lugar de sobrescribir
sus cambios.
## Administra agentes desde la lista
La página **Agentes de voz** también admite acciones del ciclo de vida a nivel de organización:
* **Duplica** un agente como nuevo punto de partida en la misma organización.
* **Transfiere** un agente a otra organización a la que perteneces. **Copiar** conserva
el origen; **Mover** lo elimina de la organización actual y requiere
acceso de administrador.
* Selecciona uno o más agentes y exporta su configuración mostrada como
**CSV** o **JSON**.
* Elimina un agente o elimina en bloque los agentes seleccionados, tras confirmarlo.
Copiar o mover un agente entre organizaciones no otorga silenciosamente a la
organización de destino acceso a conexiones exclusivas de la organización de origen. Revisa las
vinculaciones de la app, API, conocimientos, MCP, números telefónicos y widgets del agente copiado antes de
implementarlo allí.
## Páginas relacionadas
Un recorrido conciso para crear un agente de principio a fin.
Planes base, complementos, medición de llamadas, números y cargos únicos.
Congela turnos de llamadas reales y reprodúcelos antes de implementar.
Campos de solicitud, borradores, implementaciones, versiones y ejemplos.