Exportação

Nesse painel é possível configurar rotinas de exportação e backup de dados específicos de cada empresa (Tenant), garantindo que informações críticas como contatos, tickets e mensagens estejam seguras

circle-exclamation

Visão Geral e Escopo

A ferramenta de exportação foi desenhada para extrair apenas dados de negócio do tenant (identificados pelo tenantId).

O sistema realiza uma separação inteligente dos dados:

  • Inclui: Dados operacionais, configurações do cliente, históricos de conversa e cadastros.

  • Exclui: Logs temporários, sessões de conexão (Baileys), caches e configurações internas do sistema que não são relevantes para backup de negócio.


Etapa 1: Configurações de Exportação por Tenant

Para que o backup ou exportação ocorra, é necessário definir uma política de armazenamento para o Tenant desejado.

  1. Acesse o menu Central de Dados (ou Configurações > Exportação).

  2. Na seção "Configurações de Exportação por Tenant", utilize o seletor para escolher a empresa (Tenant) que deseja configurar.

  3. Clique em + NOVA CONFIGURAÇÃO.

Aba 1: Armazenamento

Nesta etapa, você define onde os arquivos serão salvos.

  • Tipo de Armazenamento: Selecione entre Local (no próprio servidor) ou Cloud (S3, MinIO, etc, conforme disponibilidade).

  • Caminho do Armazenamento: Defina a pasta onde os arquivos serão depositados.

    • Exemplo: ./backup

Etapa 2: Configurações de Exportação e Política de Retenção

Na seção "Geral", você tem uma visão gerencial de todas as políticas ativas no sistema.

Nesta lista é possível:

  • Visualizar o ID e Nome do Tenant.

  • Verificar o Tipo de Armazenamento e Dias de Retenção.

  • Verificar o Status da configuração.

  • Ações Rápidas: Editar a configuração (lápis), Recriar/Atualizar (seta circular) ou Excluir a rotina (lixeira).

Etapa 3: Exportação Manual e Limpeza

Além das rotinas automáticas, o sistema executa processos de manutenção:

  • Exportação Individual: Ao selecionar um Tenant, você pode forçar a geração de uma exportação imediata dos dados atuais.

  • Limpeza de Dados Antigos: O sistema possui uma rotina automática que remove arquivos de backup que ultrapassaram os "Dias de Retenção" configurados, garantindo a saúde do disco do servidor.


Apêndice: Detalhamento dos Dados (Modelos)

Para fins de auditoria e conformidade técnica, listamos abaixo exatamente quais tabelas do banco de dados são processadas durante a exportação.

✅ Dados INCLUÍDOS na Exportação

Estes são os dados de negócio que compõem o backup do cliente:

Categoria

Modelos (Tabelas)

Atendimento

Tickets, Messages, MessageUpserts, TicketNotes, TicketEvaluations, TicketProtocols, TicketShareds, CallLogs, LogTickets

Cadastros

Users, Contacts, Whatsapps, Queues, Plans, ContactWallets

CRM & Organização

Opportunities, Pipelines, Stages, Kanbans, Tags, ContactTags, TodoLists

Automação

ChatFlows, AutoReplies, FastReplies, Campaigns, ApiConfigs, ApiMessages

Grupos e Listas

ParticipantsLists, BanLists, WordLists, GhostLists, GroupMessages, GroupLinkLists, PrivateMessages

Configurações

Settings, Notifications, GreetingMessages, FarewellMessages, Reasons, Tutorials, TenantApis

❌ Dados EXCLUÍDOS da Exportação

Estes dados não são exportados pois são referentes a logs de sistema, sessões temporárias ou caches que não devem ser migrados entre ambientes:

  • Sessão e Conexão: Baileys, BaileysSessions, UserWhatsapp.

  • Logs Voláteis: MessageOffLine, UserMessagesLog, AutoReplyLogs, LicenseRequestLog, LicenseActivationLog.

  • Controle Interno: QueueManager, StepsReply, StepsReplyAction, UsersQueues.

  • Backup e Licença: BackupConfig, BackupResult, License.

circle-info

Nota Técnica: A exclusão desses itens torna o arquivo de backup mais leve e previne conflitos de sessão ao restaurar os dados em uma nova instância.

Atualizado