---
title: "Dejar ThunderPhone"
description: "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."
ui: zeus
---

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](#export-an-agent), 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](#call-history-and-recordings), 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](#phone-numbers) |

## 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

<CodeGroup>
```bash cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip
```
</CodeGroup>

El 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}`](/api-reference/agents#agent-object), 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](/es/webhooks/endpoints) 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`](/api-reference/knowledge-bases#download-the-original-file).

### 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](#call-history-and-recordings).
- **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`](/api-reference/agents#version-history).
- **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](/es/guides/coding-agents):

```bash
npx skills add thunderphone/skills
```

Luego 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_format` de 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](/es/guides/verify-webhook-signatures)
  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](/es/guides/bring-your-own-numbers))
  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](/api-reference/phone-numbers#release-a-phone-number)
  con `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` y no
  envíes `release_at_provider`.
- **Un número proporcionado por ThunderPhone.** Contacta con
  [soporte](mailto:support@thunderphone.com) 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/export`](/api-reference/calls#export-calls)
  devuelve hasta 1,000 llamadas por solicitud como CSV (metadatos) o JSON (con
  transcripciones). Filtra por `agent_id` y pagina tu historial con
  `start_date` y `end_date`. El encabezado de respuesta `X-Truncated` es `true`
  cuando coincidieron más llamadas de las que se devolvieron.
- **Grabaciones.** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  devuelve una URL de corta duración para la grabación de una llamada. No hay
  descarga masiva de grabaciones.

<CodeGroup>
```bash cURL
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.json
```
</CodeGroup>

## Lo 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](/es/guides/pricing), 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](https://thunderphone.com/terms#term-termination), en
**Plazo del servicio; suspensión; finalización**. Los Términos prevalecen; esto es un resumen.

## Relacionado

- [Importa agentes desde otra plataforma](/es/guides/import-agents)
- [Habilidades para agentes de programación](/es/guides/coding-agents)
- [API de agentes](/api-reference/agents)
- [API de llamadas](/api-reference/calls)
