Transferencia de Datos
- Cómo exportar los datos de tu empresa como un archivo ZIP
- Cómo importar datos — incluidos los ZIP de ejemplo listos para usar de esta documentación
- Qué se incluye y qué no en una transferencia
La página de Transferencia de Datos exporta e importa los datos de tu empresa. Úsala para exportar las colecciones que selecciones, mover datos entre empresas o instalar los ZIP de ejemplo listos para importar de esta documentación. Una exportación no es una copia de seguridad completa de la empresa — consulta Exportar datos más abajo para saber qué cubre un ZIP y qué no incluye nunca. Ábrela desde el grupo Empresa de la barra lateral: Empresa > Transferencia de Datos.
La página tiene dos pestañas: Exportar e Importar. Actualmente ambas requieren el área Exportación de datos de Administración de la cuenta (consulta Roles y permisos) — importar se controla con la misma área que exportar. Los propietarios siempre la tienen.
Exportar datos
La pestaña Exportar lista tus colecciones exportables con un conteo de documentos en vivo, agrupadas así:
| Grupo | Colecciones |
|---|---|
| Datos principales | Contactos, Tipos Personalizados, Documentos de tipos personalizados |
| Mensajería | Canales, Conversaciones, Mensajes, Plantillas de mensajes |
| Automatización | Agentes, Workflows, Ejecuciones de Workflow |
| Otros | Webhooks, Notificaciones |
Marca las colecciones que quieras (la casilla en el encabezado de un grupo selecciona todo el grupo) y haz clic en Exportar ZIP. Tu navegador descarga un archivo llamado autotalk-export-<empresa>-<fecha>.zip.
Dentro del ZIP encontrarás un manifest.json que describe la exportación más un archivo JSON por colección (por ejemplo contacts.json).
Las exportaciones contienen solo las colecciones de datos seleccionadas. Los Tipos Personalizados viajan como dos colecciones propias — las definiciones (custom_types) y sus documentos (custom_type_docs) — así que marca Datos principales para incluir ambas. Los registros de cuenta y equipo, los datos de facturación, las variables secretas y los logs nunca se incluyen en una exportación, y por eso una exportación no es una copia de seguridad completa de la empresa.
Importar datos
La pestaña Importar requiere la misma área Exportación de datos que la exportación — los propietarios siempre la tienen. Acepta dos tipos de archivos:
- Un único ZIP — una exportación de AutoTalk, o uno de los ZIP de ejemplo de la sección Ejemplos (usan el mismo formato, que también puede incluir definiciones de Tipos Personalizados y sus documentos).
- Uno o más archivos JSON — cada uno nombrado según una colección, como
contacts.jsonoworkflows.json.
Compatibilidad de generación CEL
Las exportaciones actuales registran celSchemaGeneration: "4" en
manifest.json. Un ZIP con configuración CEL debe declarar la generación 4,
y su petición de importación debe usar la generación 4. Los archivos de la
generación 3, o sin generación, se rechazan antes de cualquier escritura cuando
contienen código CEL. El importador no reescribe expresiones; migra y revisa
el código antes de restaurar esa configuración.
Los archivos JSON independientes de colecciones con código CEL usan un objeto
de archivo con celSchemaGeneration igual a "4" y el array de registros en
documents. Los arrays antiguos sin envoltorio que contienen código CEL se
rechazan aunque el navegador que importa use la generación 4. Migra y revisa
el código antiguo antes de asignar la generación 4; el importador no lo
reescribe. Las entradas de colecciones dentro de un ZIP siguen siendo arrays,
con su generación registrada en el manifest del ZIP.
Los archivos y arrays JSON antiguos que solo contienen datos, como contactos y
conversaciones sin configuración CEL, siguen siendo compatibles. Las
importaciones por API con código CEL también envían
X-Autotalk-Cel-Schema: 4; tanto la petición como los metadatos del archivo
deben identificar la generación actual. La creación y edición JSON directa
por CRUD usa solo el header, sin el envoltorio de importación de archivo.
Para importar:
- Suelta el archivo en el área de subida ("Suelta el archivo ZIP aquí o haz clic para seleccionar"), o haz clic en ella para elegir un archivo. No mezcles archivos ZIP y JSON en una misma importación.
- Revisa la tarjeta de Vista previa del archivo, que muestra las colecciones y los conteos de documentos encontrados en el archivo.
- Haz clic en Importar ZIP y confirma. La confirmación te recuerda que esto creará o actualizará documentos en tu empresa y no se puede deshacer.
- Cuando la importación termina, una tabla de resultados muestra la cantidad de documentos Creados y Actualizados — y cualquier Error — por colección.
Cómo se manejan los documentos:
- Un documento cuyo ID ya existe en tu empresa se actualiza en su lugar.
- Todo lo demás se crea como un registro nuevo con un ID nuevo, y las referencias entre los documentos importados (por ejemplo, un mensaje que apunta a su conversación) se reasignan para que sigan apuntándose entre sí.
- El archivo subido se elimina del almacenamiento de tu empresa una vez que la importación se completa.
Las importaciones están limitadas a 500 MB por archivo.
Cada ejemplo de la sección Ejemplos se distribuye como un ZIP descargable creado para esta página — descárgalo y luego impórtalo aquí para obtener un agente, un workflow o un conjunto de datos inicial funcional en un solo paso.
Próximos pasos
- Ejemplos — Agentes, workflows y datos iniciales listos para importar
- Explorador de Almacenamiento — Explora y gestiona los archivos de tu empresa
- Roles y permisos — Otorga el área Exportación de datos