Logo depois de conectar um número de WhatsApp ao Syncro, suas conversas anteriores não aparecem automaticamente — o Syncro só registra as mensagens a partir do momento da conexão. Pra trazer o histórico recente (últimos 7, 15 ou 30 dias), use o recurso de importação.
A importação puxa as conversas do seu WhatsApp via QR Code, cria os contatos no CRM e popula a caixa de entrada com o histórico. É uma ação opcional — se você prefere começar do zero, basta não importar.
⚠️ Atenção: a importação só está disponível pra números conectados via QR Code. A WhatsApp Cloud API não suporta importação retroativa de histórico — você só verá mensagens trocadas depois da conexão.
Pré-requisitos
- Número WhatsApp já conectado via QR Code.
- Permissão de admin.
- O processo roda em segundo plano e pode levar de alguns minutos a algumas horas dependendo do volume de conversas.
Passo a passo
- Acesse Configurações → Integrações.
- No card WhatsApp Business, encontre a instância que você quer importar e clique no botão Importar Mensagens (ícone de download).
- O Syncro abre o modal Importar Mensagens com o subtítulo "Importa o histórico de conversas do WhatsApp para o CRM".
- Selecione o Período que você quer importar:
- Últimos 7 dias — recomendado pra começar
- Últimos 15 dias
- Últimos 30 dias — máximo permitido
- Leia a observação: "A importação roda em segundo plano. Mensagens já existentes serão ignoradas."
- Clique em Importar.
- O modal mostra o estado Importando Mensagens.... Você pode fechar e continuar usando o Syncro normalmente — o processo continua rodando.
- Quando finalizar, aparece Importação Concluída e a caixa de entrada já reflete as conversas.
O que é importado
Pra cada conversa do período selecionado, o Syncro:
- Cria a conversa na caixa de entrada com o nome do contato (PushName do WhatsApp)
- Salva todas as mensagens com seu tipo original (texto, áudio, imagem, vídeo, documento, sticker)
- Baixa as mídias localmente pra que continuem disponíveis mesmo depois que o WhatsApp expirar a URL
- Cria o lead automaticamente se sua configuração de pipeline tem auto criação a partir do WhatsApp ativada (veja Auto-criar leads do WhatsApp e Instagram)
O que não é importado
- Mensagens mais antigas do que o período selecionado.
- Conversas que não tiveram movimento no período (mesmo que existam mais antigas).
- Mensagens deletadas no celular antes da importação.
- Reações e replies citados podem não ter o snapshot completo (depende do que o QR Code expõe).
Erros comuns
"A importação não conclui"
Conversas grandes (centenas de mensagens) podem demorar. Aguarde até 1 hora antes de suspeitar de problema. Se passar disso e o status não mudar, contate o suporte com o ID da instância.
"Vejo conversas duplicadas"
O Syncro deduplica por ID da mensagem do WhatsApp. Se aparecerem duplicatas, geralmente é porque a importação rodou enquanto novas mensagens estavam chegando em paralelo. As novas conversas continuam funcionando normalmente — é seguro ignorar duplicatas até suporte resolver.
"As fotos de perfil não apareceram"
URLs de fotos de perfil do WhatsApp expiram em horas. O Syncro tenta baixar localmente no momento da importação, mas pode falhar pra alguns contatos. Não afeta o funcionamento das conversas.
Importar mais de uma vez
Você pode rodar a importação várias vezes. O Syncro deduplica mensagens já importadas, então rodar de novo não cria registros repetidos. Use isso pra:
- Ampliar o período: importou 7 dias e quer agora 30 dias — basta selecionar 30 dias e rodar.
- Recuperar conversas que falharam: se uma conversa específica não veio, importe de novo.
Limite de histórico
O período máximo é de 30 dias. Esse limite vem do próprio protocolo do QR Code — não é uma restrição do Syncro. Pra mensagens mais antigas que isso, não há como importar via integração; elas continuam só no celular.