Transferência de Dados
- Como exportar os dados da sua empresa como um arquivo ZIP
- Como importar dados — incluindo os ZIPs de exemplo prontos desta documentação
- O que está e o que não está incluído em uma transferência
A página de Transferência de Dados exporta e importa os dados da sua empresa. Use-a para exportar as coleções que você selecionar, mover dados entre empresas ou instalar os ZIPs de exemplo prontos para importação desta documentação. Uma exportação não é um backup completo da empresa — veja Exportando dados abaixo para saber o que um ZIP cobre e o que ele nunca inclui. Abra-a pelo grupo Empresa na barra lateral: Empresa > Transferência de Dados.
A página tem duas abas: Exportar e Importar. Atualmente ambas exigem a área Exportação de dados da Administração da conta (veja Papéis e permissões) — importar é controlado pela mesma área que exportar. Proprietários sempre a possuem.
Exportando dados
A aba Exportar lista suas coleções exportáveis com uma contagem de documentos ao vivo, agrupadas como:
| Grupo | Coleções |
|---|---|
| Dados Principais | Contatos, Tipos Personalizados, Documentos de tipos personalizados |
| Mensagens | Canais, Conversas, Mensagens, Modelos de mensagem |
| Automação | Agentes, Workflows, Execuções de Workflow |
| Outros | Webhooks, Notificações |
Marque as coleções que você quer (a caixa de seleção no cabeçalho de um grupo seleciona o grupo inteiro) e clique em Exportar ZIP. Seu navegador baixa um arquivo chamado autotalk-export-<empresa>-<data>.zip.
Dentro do ZIP você encontrará um manifest.json descrevendo a exportação, além de um arquivo JSON por coleção (por exemplo contacts.json).
As exportações contêm apenas as coleções de dados selecionadas. Os Tipos Personalizados viajam como duas coleções próprias — as definições (custom_types) e seus documentos (custom_type_docs) — então marque Dados Principais para incluir ambas. Registros de conta e de equipe, dados de faturamento, variáveis secretas e logs nunca são incluídos em uma exportação, e é por isso que uma exportação não é um backup completo da empresa.
Importando dados
A aba Importar exige a mesma área Exportação de dados que a exportação — proprietários sempre a possuem. Ela aceita dois tipos de arquivo:
- Um único ZIP — uma exportação do AutoTalk, ou um dos ZIPs de exemplo da seção Exemplos (eles usam o mesmo formato, que também pode carregar definições de Tipos Personalizados e seus documentos).
- Um ou mais arquivos JSON — cada um nomeado conforme uma coleção, como
contacts.jsonouworkflows.json.
Compatibilidade de geração CEL
Exportações atuais registram celSchemaGeneration: "4" em manifest.json.
Um ZIP com configuração CEL precisa declarar a geração 4, e a requisição de
importação precisa usar a geração 4. Arquivos da geração 3 ou sem geração são
rejeitados antes de qualquer escrita quando contêm código CEL. O importador
não reescreve expressões; migre e revise o código antes de restaurar essa
configuração.
Arquivos JSON avulsos de coleções com código CEL usam um objeto de arquivo com
celSchemaGeneration igual a "4" e o array de registros em documents.
Arrays antigos sem envelope que contêm código CEL são rejeitados mesmo quando
o navegador que importa usa a geração 4. Migre e revise o código antigo antes de atribuir a
geração 4; o importador não o reescreve. As entradas de coleções dentro de
um ZIP continuam sendo arrays, com a geração registrada no manifest do ZIP.
Arquivos e arrays JSON antigos contendo apenas dados, como contatos e conversas
sem configuração CEL, continuam compatíveis. Importações por API com código
CEL também enviam X-Autotalk-Cel-Schema: 4; tanto a requisição quanto os
metadados do arquivo precisam identificar a geração atual. A criação e edição
JSON direta via CRUD usa apenas o header, sem o envelope de importação de arquivo.
Para importar:
- Solte o arquivo na área de upload ("Solte o arquivo ZIP aqui ou clique para selecionar"), ou clique nela para escolher um arquivo. Não misture arquivos ZIP e JSON em uma mesma importação.
- Revise o cartão de Prévia do Arquivo, que mostra as coleções e as contagens de documentos encontradas no arquivo.
- Clique em Importar ZIP e confirme. A confirmação lembra que isso criará ou atualizará documentos na sua empresa e não pode ser desfeito.
- Quando a importação terminar, uma tabela de resultados mostra o número de documentos Criados e Atualizados — e quaisquer Erros — por coleção.
Como os documentos são tratados:
- Um documento cujo ID já existe na sua empresa é atualizado no lugar.
- Todo o resto é criado como um novo registro com um novo ID, e as referências entre os documentos importados (por exemplo, uma mensagem apontando para sua conversa) são remapeadas para que continuem apontando umas para as outras.
- O arquivo enviado é removido do armazenamento da sua empresa assim que a importação é concluída.
As importações são limitadas a 500 MB por arquivo.
Todo exemplo da seção Exemplos é distribuído como um ZIP para download feito para esta página — baixe-o e importe-o aqui para obter um agente, workflow ou conjunto de dados inicial funcionando em uma única etapa.
Próximos passos
- Exemplos — Agentes, workflows e dados iniciais prontos para importar
- Explorador de Armazenamento — Navegue e gerencie os arquivos da sua empresa
- Papéis e permissões — Conceda a área Exportação de dados