Open in
Dejar ThunderPhone
Exporta un agente como archivos abiertos, recréalo en LiveKit Agents, Pipecat, Vapi o Retell con una habilidad de agente de programación y descarga tu historial de llamadas y grabaciones.
Puedes dejar ThunderPhone cuando quieras. Puedes exportar cualquier agente como un zip de archivos abiertos, sin costo, y una skill ayuda a tu agente de código a reconstruirlo en LiveKit Agents, Pipecat, Vapi o Retell. Esta página explica qué puedes llevarte, cómo exportarlo y qué debes rehacer del otro lado.
Qué puedes llevarte
| Qué | Cómo |
|---|---|
| Un agente: instrucciones, herramientas, números de transferencia, pasos, configuración, enrutamiento de números y webhooks | La exportación del agente, un zip por agente |
| Los archivos de conocimiento del agente | Dentro de la exportación del agente |
| Historial de llamadas y transcripciones | La exportación de llamadas, hasta 1,000 llamadas por solicitud |
| Grabaciones | Una grabación por solicitud, por llamada |
| Números de teléfono con tu propio operador | Nunca salieron de tu operador. Consulta Números de teléfono |
Exportar un agente
En Zeus
Abre el agente y ve a su configuración (Gestión de llamadas en el editor del agente). En la parte inferior, en Exportar, copiar o eliminar, elige Exportar. El archivo zip se descarga en tu computadora.
Con la API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipEl archivo zip se genera cuando lo solicitas. Cualquier persona que pueda leer el agente puede
exportarlo. El conocimiento, los números y los webhooks se incluyen solo cuando la
credencial puede leerlos: un token OAuth necesita knowledge:read,
numbers:read e integrations:read, y los webhooks también requieren ser administrador o
propietario. Una parte que se omite aparece en omitted en manifest.json.
La API responde 429 después de 30 exportaciones por minuto.
| Parámetro de consulta | Descripción |
|---|---|
include_url_paths | true conserva la ruta de cada URL en la exportación, como el punto de conexión de una herramienta. De forma predeterminada, cada URL se reduce a su host. Los nombres de usuario, las contraseñas y las cadenas de consulta se eliminan de las URL de cualquier manera |
Usa include_url_paths=true cuando estés a punto de reconstruir el agente
en otro lugar, porque allí se necesitan los puntos de conexión de las herramientas. Déjalo desactivado para
una copia que planees compartir.
Qué contiene el archivo zip
| Archivo | Contenido |
|---|---|
manifest.json | El formato (thunderphone.agent-export/v1), lo que se incluye y una lista omitted que indica todo lo que se omitió y por qué |
agent.json | El agente tal como lo devuelve GET /v1/agents/{agent_id}, sin credenciales |
prompt.md | Las instrucciones activas |
knowledge/index.json y los archivos junto a este | El conocimiento del agente. Cada documento es el archivo original cuando se almacena uno; de lo contrario, es su texto extraído |
numbers.json | Los números asignados a este agente, entrantes y salientes, con cualquier versión o variante fijada |
webhooks.json | Los puntos de conexión de webhook asociados a este agente, sin sus secretos |
README.md | Qué contiene cada archivo |
Un archivo de conocimiento de más de 25 MB se omite, al igual que cualquier contenido que supere
los 100 MB para toda la exportación. Cada uno aparece en manifest.json con el
punto de conexión que lo descarga,
GET /v1/knowledge/documents/{document_id}/original.
Lo que nunca se incluye
- Valores de credenciales. Los encabezados de una herramienta se enumeran solo por nombre. Los valores de los encabezados son de solo escritura en ThunderPhone: ninguna respuesta de la API los devuelve, por lo que ninguna exportación puede hacerlo. Vuelve a ingresarlos en el otro lado. Esto cubre las credenciales que ThunderPhone almacena como credenciales. Tus instrucciones y archivos de conocimiento se copian exactamente como los escribiste o cargaste, por lo que si alguna vez pegaste una clave en un prompt o un documento, estará en el archivo zip. Revísalo antes de compartirlo.
- Historial de llamadas y grabaciones. Tienen sus propias exportaciones; consulta Historial de llamadas y grabaciones.
- Historial de versiones. La exportación contiene el agente tal como está activo ahora. Las versiones
anteriores permanecen enumeradas en
GET /v1/agents/{agent_id}/versions. - Otros agentes a los que este deriva llamadas. Exporta cada uno de la misma manera.
Cambiar a otra plataforma
La habilidad migrate-off-thunderphone guía a tu agente de programación durante
el cambio. Instala las habilidades de ThunderPhone:
npx skills add thunderphone/skillsLuego pídele a tu agente de programación que migre un agente fuera de ThunderPhone e indique el destino: LiveKit Agents, Pipecat, Vapi o Retell. La habilidad descarga la exportación, te pide cada credencial, reconstruye el agente a partir de una asignación para ese destino y lo prueba allí antes de mover cualquier número. La conversión se ejecuta en tu agente de programación, con tus propias claves. ThunderPhone nunca escribe en tu cuenta de otra plataforma.
Lo que se transfiere, como archivos que la habilidad asigna por ti:
- Instrucciones, incluidas las instrucciones compartidas y los pasos.
- Herramientas: el mismo endpoint, método y esquema de parámetros. El
request_formatde cada herramienta registra la estructura del cuerpo que espera tu endpoint. - Números de transferencia y las configuraciones de finalizar llamada y teclado.
- Archivos de conocimiento.
- Configuraciones de buzón de voz, silencio y duración de llamadas.
- Los números que el agente contesta y desde los que realiza llamadas.
Lo que debes rehacer en el otro lado:
- Proveedores de voz, modelos de lenguaje y síntesis de voz. Los eliges en el destino. Nada garantiza que una voz, ni cómo suena una llamada, coincida.
- Credenciales. Valores de encabezados de herramientas y secretos de webhooks.
- Telefonía. La forma en que los números llegan al agente se configura de manera distinta en cada plataforma.
- Pasos y transferencias. Un destino con una función de flujo o transferencia los reconstruye allí. En otros casos, la habilidad integra los pasos en las instrucciones y te avisa.
- Configuraciones de ThunderPhone sin equivalente. La inteligencia, las configuraciones de escucha y velocidad de respuesta, las herramientas integradas de correo electrónico y mensajes de texto, y la evaluación de llamadas, los resúmenes y las etiquetas de resultado no se transfieren a menos que los reconstruyas.
- Firmas de solicitudes. ThunderPhone firma las solicitudes de herramientas y los webhooks que envía. Otra plataforma firma a su propia manera, por lo que un endpoint que verifica la firma de ThunderPhone necesita una nueva verificación.
- Pruebas. Prueba el agente reconstruido en el destino antes de mover un número.
Mantén el agente de ThunderPhone en su lugar hasta que el nuevo haya superado tus pruebas. Es tu forma de volver atrás.
Números de teléfono
Mueve los números al final, después de que el nuevo agente supere sus pruebas.
- Un número con tu propio operador (una conexión VoIP)
permanece con ese operador. Dirígelo a la nueva plataforma en la consola de tu operador.
Luego elige Liberar en el número de ThunderPhone y deja
También cancelar este número en mi cuenta de … sin marcar: el número se
desconecta de ThunderPhone y permanece en tu cuenta del operador. Mediante
la API, libéralo
con
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truey no envíesrelease_at_provider. - Un número proporcionado por ThunderPhone. Contacta con soporte antes de liberar un número que quieras conservar. Liberar un número de ThunderPhone es permanente: regresa al grupo disponible y puede asignarse a otro cliente.
Historial de llamadas y grabaciones
Estos elementos son independientes de la exportación del agente.
- Llamadas.
GET /v1/calls/exportdevuelve hasta 1,000 llamadas por solicitud como CSV (metadatos) o JSON (con transcripciones). Filtra poragent_idy pagina tu historial constart_dateyend_date. El encabezado de respuestaX-Truncatedestruecuando coincidieron más llamadas de las que se devolvieron. - Grabaciones.
GET /v1/calls/{call_id}/audiodevuelve una URL de corta duración para la grabación de una llamada. No hay descarga masiva de grabaciones.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.jsonLo que cuesta
Nada. La exportación de agentes, la exportación de llamadas y las descargas de grabaciones son gratuitas. ThunderPhone es de pago por uso, sin suscripción ni cargo por usuario. Un número de ThunderPhone deja de facturarse cuando lo liberas.
Después de irte
No hay un plazo fijo. Puedes finalizar el acuerdo mediante aviso por escrito a legal@thunderphone.com, enviado desde el correo administrativo de la cuenta u otro canal verificable. Un retraso en el pago puede suspender el servicio; por sí solo nunca finaliza el acuerdo ni activa la eliminación de los Datos del Cliente. Sobre los datos, los Términos indican: "Después de la finalización formal, el Proveedor devolverá o eliminará los Datos del Cliente dentro de sesenta (60) días, sujeto a los derechos de exportación del Cliente, los ciclos de respaldo, las retenciones legales, la conservación exigida por la ley, el DPA y cualquier BAA ejecutado."
El texto completo se encuentra en los Términos de servicio, en Plazo del servicio; suspensión; finalización. Los Términos prevalecen; esto es un resumen.