Skip to content

Importar Histórico de Mensagens

O ChatDigi permite importar conversas antigas do WhatsApp para que o histórico do cliente fique visível nos atendimentos, mesmo antes da implantação do sistema.

Há dois mecanismos disponíveis: importação via Baileys (nativa, usa o backup do celular) e importação via Z-API (usa credenciais de API externa).


Importação Baileys (nativa)

Importa diretamente do backup do WhatsApp conectado via Baileys.

Quando usar

  • Você tem uma conexão Baileys ativa
  • Quer trazer conversas do período anterior à implantação do ChatDigi

Progresso em tempo real

Enquanto a importação roda, um banner de progresso aparece no topo da tela de Conexões com:

  • Percentual concluído
  • Data da mensagem que está sendo processada no momento
  • Quantidade de mensagens processadas / total
  • Erros encontrados (se houver)
  • Botão Cancelar para interromper

Banner de importação nativa


Importação via Z-API (ou Baileys conectado)

Para usar esta opção, você precisa de uma conexão WhatsApp ativa.

Passo a passo

  1. Acesse Conexões no menu lateral
  2. Clique em Importar Mensagens (botão no topo da tela)
  3. O modal de importação abre

Modal de Importação

  1. Preencha os campos:

    CampoOpçõesO que faz
    ConexãoLista de conexões ativasQual número vai ser a fonte das mensagens
    Data InícioDataPonto de partida da importação
    Data FimDataAté quando importar
    Tipo de MensagemTodas / Individual / GrupoFiltra o tipo de conversa a importar
    Status do TicketAberto / FechadoComo os tickets importados ficam
  2. Clique em Importar

Progresso da importação

Enquanto roda, o modal exibe:

  • Indicador de progresso (barra + percentual)
  • Estágio atual: Conectando → Buscando chats → Processando chat X de Y
  • Contadores: Mensagens / Tickets / Contatos importados / Erros

Progresso de importação

  • Log em tempo real: painel escuro com entradas cronológicas do que está sendo processado
  • Botão Cancelar Importação: interrompe o processo no ponto atual

Resultado

Ao concluir, uma mensagem de sucesso exibe:

"Importação concluída! X mensagens, Y tickets, Z contatos importados."


O que é importado

  • Mensagens de texto, mídia e documentos das conversas selecionadas
  • Cada conversa se torna um ticket no ChatDigi
  • Cada número se torna um contato

O que não é importado

  • Mensagens apagadas antes da importação
  • Status do WhatsApp (stories)
  • Grupos (se o filtro "Individual" for selecionado)

Problemas comuns

O botão "Importar Mensagens" não aparece ou dá erro

  • É necessário ter pelo menos uma conexão WhatsApp com status Conectado

A importação travou ou ficou muito lenta

  • Importações de períodos longos (vários meses) podem levar muitos minutos. Aguarde.
  • Se o banner sumir sem conclusão, a importação pode ter falhado. Tente novamente com um período menor.

Os tickets importados vieram sem fila definida

  • Defina uma fila padrão no campo "Fila para importar as mensagens" na configuração da conexão antes de rodar a importação

Quero cancelar a importação

  • Clique em Cancelar Importação no modal ou no botão Cancelar no banner de progresso. A importação para no ponto atual; dados já importados são mantidos.