Sincronização do histórico de conversas do WhatsApp Coexistence: como funciona, por que falha e como corrigir

Resumo

• O Coexistence pode importar até 6 meses (180 dias) do histórico de conversas individuais do app WhatsApp Business, em uma única importação retroativa no momento da conexão.
• A empresa precisa escolher compartilhar as conversas durante a integração, e a sincronização deve ser concluída dentro de 24 horas após a conexão.
• É permitido apenas uma solicitação de sincronização do histórico por integração. Se ela for ignorada ou falhar, a solução é desconectar e fazer a integração novamente.
• As mídias completas são importadas apenas para aproximadamente os últimos 14 dias. As mensagens mais antigas chegam como texto, com marcadores de mídia.
• Configure os webhooks antes de conectar, mantenha o app aberto e online, e o histórico será enviado para sua caixa de entrada e seu CRM.

Você acabou de conectar seu número do WhatsApp Business à Plataforma Business pelo Coexistence. A conexão funciona. Novas mensagens estão chegando à caixa de entrada da sua equipe. Seus contatos estão lá.

Mas o histórico de conversas dos 6 meses que você esperava? Não está em lugar nenhum.

Se essa é a sua situação agora, saiba que você não está sozinho. A sincronização do histórico de conversas é a parte mais mal compreendida da configuração do Coexistence. É um processo único, baseado em consentimento e com um prazo rigoroso. Se qualquer uma das condições não for cumprida, você acaba com uma conexão funcionando, mas sem histórico.

Este guia explica o que é a sincronização do histórico de conversas (e o que ela não inclui), como configurá-la corretamente desde a primeira vez, os motivos mais comuns para ela falhar, como solucionar o problema e como transferir o histórico para seu CRM. As perguntas frequentes no final respondem às dúvidas que mais ouvimos.

O que é a sincronização do histórico de conversas no WhatsApp Coexistence?

Ao conectar um número do app WhatsApp Business à Plataforma WhatsApp Business pelo Coexistence, a empresa pode escolher compartilhar até 6 meses de histórico de conversas com o lado da API. Isso acontece uma única vez, como uma importação retroativa no momento da conexão.

O objetivo é começar com contexto. A caixa de entrada da sua equipe, os atendentes e o CRM já têm o contexto das conversas existentes com clientes, em vez de começarem do zero.

Alguns pontos explicam a maior parte das dúvidas:

• Apenas conversas individuais. As conversas em grupo não são sincronizadas. Elas permanecem no app.
• Uma única importação retroativa. Após a sincronização inicial, as novas mensagens chegam em tempo real pela API. A importação dos últimos 6 meses acontece apenas uma vez.
• Baseada em consentimento. O histórico só é sincronizado se a empresa optar por compartilhar as conversas durante a integração. Se o compartilhamento de conversas estiver desativado, a importação será rejeitada e nada será transferido.
• Prazo de 24 horas e uma solicitação. A sincronização deve ser solicitada e concluída dentro de 24 horas após a conexão, e apenas uma solicitação de histórico é permitida por integração.
• Os contatos também são sincronizados. Os contatos e o histórico de conversas são importados durante a configuração do Coexistence.

O que é e o que não é sincronizado

O porém das mídias: a sincronização inclui mídias completas apenas de aproximadamente 14 dias antes da conexão. Para mensagens mais antigas, o texto chega, mas imagens, vídeos e documentos podem aparecer como marcadores de posição, em vez de arquivos. Uma conversa de 5 meses atrás será exibida corretamente, mas o PDF da proposta compartilhado em março talvez não esteja anexado.

Na prática, quanto tempo leva: a sincronização inicial pode levar de alguns minutos a várias horas, dependendo do volume de conversas. Um número usado por dois representantes de vendas termina rapidamente. Um número de suporte movimentado, com muito tráfego, pode levar bem mais tempo. Planeje a integração levando isso em conta (veja as etapas abaixo).

Como configurar a sincronização do histórico de conversas (passo a passo)

A sincronização do histórico de conversas faz parte da integração do Coexistence. Não há uma configuração separada depois, e é exatamente por isso que ela passa despercebida.

Antes de começar:

1. Configure primeiro os webhooks na plataforma do seu provedor de API. Essa é a etapa mais importante. O histórico chega como uma enxurrada de eventos de webhook. Se os webhooks não estiverem prontos antes da conexão, não haverá onde receber o histórico, e ele não será enviado novamente mais tarde por padrão.
2. Atualize o app WhatsApp Business para a versão mais recente no dispositivo principal.
3. Use uma rede Wi-Fi estável, mantenha o celular carregando e escolha um horário tranquilo. Para números com alto volume, a sincronização pode levar horas, e o app precisa permanecer aberto e conectado durante todo o processo.
4. Confirme a conta e seu nível de acesso. Saiba qual número você está conectando e confirme que tem direitos de administrador no seu portfólio empresarial da Meta.

Durante a integração do Coexistence:

1. Conecte seu número pelo fluxo de cadastro integrado.
2. Quando o app WhatsApp Business perguntar, escolha compartilhar suas conversas. Leia esta tela com atenção: essa escolha é o recurso inteiro.
3. Mantenha o app WhatsApp Business aberto e online enquanto a sincronização é realizada. Não feche o app, não force o encerramento nem deixe o celular entrar em suspensão com uma conexão fraca.
4. Aguarde a conclusão. O histórico aparece gradualmente na caixa de entrada do seu provedor e, se os webhooks estiverem conectados, no seu CRM, ao longo de minutos ou horas.
5. Quando terminar, confira uma conversa antiga, de preferência uma com mídias mais antigas, para saber como são os marcadores de posição.

O histórico de conversas do WhatsApp não está sincronizando? 6 motivos comuns

Se o histórico não chegou, quase sempre o motivo é um destes:

1. O compartilhamento de conversas não foi selecionado. De longe, a causa mais comum. É fácil passar rápido pela opção, e não é possível simplesmente ativá-la depois, pois ela está vinculada à integração.

2. O app foi fechado durante a sincronização. O app Business é a fonte do histórico, então precisa permanecer aberto para que a transferência seja concluída. Se você deslizar para fechá-lo, deixá-lo em segundo plano por muito tempo ou o celular reiniciar, a sincronização será interrompida.

3. Problemas com a internet. Uma queda na conexão interrompe a transferência. O app pode parecer estar funcionando normalmente, enquanto o fluxo do histórico para silenciosamente.

4. Versão desatualizada do app. A sincronização do histórico exige uma versão recente do app WhatsApp Business. Versões mais antigas podem falhar sem exibir um erro claro.

5. Os webhooks não foram configurados primeiro. Esse problema pode passar despercebido. A sincronização pode ter ocorrido, mas os eventos foram enviados para um endpoint inexistente. Na prática, os dados se perdem, por isso é essencial verificar os webhooks antes da configuração.

6. O prazo de 24 horas foi perdido. O histórico precisa ser solicitado e sincronizado dentro de 24 horas após a conexão. Depois desse prazo, não é possível solicitá-lo na mesma integração.

Como solucionar problemas na sincronização do histórico de conversas, passo a passo

Siga estas etapas na ordem.

Etapa 1: confira se os contatos foram sincronizados. Essa é sua primeira pista. Se os contatos aparecerem, a conexão está funcionando e o problema é específico do histórico. Se os contatos também estiverem faltando, verifique a conexão: o app, a internet ou uma integração que não foi concluída.

Etapa 2: peça ao seu provedor de API para verificar a solicitação do histórico. A sincronização do histórico é gerenciada entre a Meta e seu provedor. Se ainda estiver dentro do prazo de 24 horas após a conexão e a solicitação não tiver sido feita, seu provedor poderá fazê-la agora. Só é permitida uma solicitação por integração, então corrija as condições primeiro (app aberto, internet estável, webhooks funcionando) antes de iniciá-la.

Etapa 3: confira o básico no celular. O app está atualizado? Está aberto, e não apenas instalado? A internet está estável? São verificações simples, mas resolvem um número surpreendente de casos.

Etapa 4: confirme se os webhooks estão configurados e funcionando. Procure erros de webhook ou eventos perdidos no painel do seu provedor. Se o histórico foi enviado, mas seu endpoint o rejeitou, você encontrou a resposta.

Etapa 5: desconecte e reconecte. Se o prazo de 24 horas tiver passado ou a única solicitação já tiver sido usada, esta é a única maneira de obter o histórico novamente. Uma nova integração do Coexistence dá a você uma nova oportunidade de compartilhar conversas e fazer uma nova sincronização. Lembre-se de que a desconexão pode interromper o fluxo de mensagens, e você precisará repetir a integração com atenção desta vez: webhooks confirmados, compartilhamento de conversas selecionado, app aberto e internet estável.

Etapa 6: uma solução temporária para conversas importantes. Se uma ou duas conversas não puderem esperar, use a opção de exportação de conversas integrada ao WhatsApp (abra a conversa, toque no menu e depois em Exportar conversa, com ou sem mídias). É manual e funciona uma conversa por vez, mas pode ajudar a destravar a revisão de negócios de amanhã cedo.

É possível exportar o histórico de conversas para um CRM?

Sim, desde que seus webhooks tenham sido configurados antes da configuração do Coexistence.

O histórico não chega como um arquivo para download. Ele chega como um fluxo de eventos de webhook enviado ao seu provedor de API no momento da conexão. Em seguida, seu provedor associa essas mensagens, mídias, horários e status aos registros de contato certos no seu CRM.

Dois pontos práticos:

• A ordem importa. Configurar os webhooks antes da integração garante o histórico completo no seu CRM. Configurá-los depois significa perder os eventos de preenchimento retroativo.
• O CRM recebe exatamente o que foi sincronizado. Isso significa apenas conversas individuais, mídias completas somente de aproximadamente 14 dias e nenhum grupo ou registro de chamadas. Alinhe as expectativas com sua equipe antes que alguém procure a conversa em grupo do último trimestre.

Se você usa Chakra, o histórico de conversas chega à caixa de entrada da equipe e sincroniza com seu CRM pela integração bidirecional. O guia de configuração mostra a etapa dos webhooks na ordem certa.

Perguntas frequentes

Por que meus contatos foram sincronizados, mas não o histórico de conversas? São sincronizações separadas. Para sincronizar o histórico de conversas, a empresa também precisa escolher compartilhar as conversas durante a integração, manter o app online e deixar os webhooks prontos. Se os contatos aparecem, mas não há histórico, geralmente a conexão está funcionando e a etapa do histórico foi ignorada ou interrompida.

Meu provedor de API pode sincronizar manualmente o histórico de conversas? Somente nas primeiras 24 horas após a conexão e apenas uma vez por integração. Se a solicitação não for feita nesse período, ou se for usada e falhar, a única opção é desconectar e fazer a integração novamente.

Quanto tempo leva a sincronização inicial? De alguns minutos a várias horas, dependendo do volume de conversas. Para números com muita atividade, mantenha o celular carregando, conectado ao Wi-Fi e com o app aberto.

O histórico de conversas em grupo é sincronizado? Não. A sincronização do histórico inclui apenas conversas individuais. Grupos, canais, atualizações de status e registros de chamadas permanecem no app.

O que acontece com as mídias com mais de duas semanas? O texto da mensagem é sincronizado, mas o arquivo de mídia pode aparecer como um marcador no lugar do arquivo original. A sincronização completa das mídias é garantida apenas para aproximadamente os últimos 14 dias.

As novas mensagens são sincronizadas depois da carga retroativa inicial? Sim. A importação de 6 meses acontece uma única vez. Depois disso, as mensagens individuais chegam em tempo real pela API, como tráfego normal de Coexistência.

Posso executar a sincronização do histórico de conversas novamente mais tarde? Não durante a mesma integração. Para sincronizar o histórico novamente, desconecte e reconecte o número. Isso inicia uma nova integração e oferece uma nova oportunidade para compartilhar conversas. Espere uma breve interrupção no fluxo de mensagens durante a troca.

Em resumo

A sincronização do histórico de conversas é um recurso útil, mas tem regras rígidas: escolha compartilhar as conversas, configure os webhooks primeiro, mantenha o app aberto e conectado e conclua a sincronização em até 24 horas, com uma solicitação por integração. Quase toda história de “meu histórico não foi sincronizado” se deve ao descumprimento de uma dessas etapas.

Faça tudo certo e seu CRM já começará aquecido, com seis meses de contexto desde o primeiro dia, em vez de começar do zero.