Como conectar o WhatsApp a uma API sem perder suas conversas

Por que conectar à API costumava fazer perder as conversas?

Porque o caminho antigo era uma migração, não um acréscimo. Registrar um número na Cloud API o tirava do app do WhatsApp Business, e o app era onde toda conversa morava. O número voltava como endpoint de API, sem histórico e sem app, e é por isso que tantos negócios olharam a API uma vez e desistiram.

Esse custo era real e foi o maior motivo isolado para pequenos negócios ficarem fora da API oficial. Também empurrou gente para gateways não oficiais, que mantinham o app funcionando fingindo ser um dispositivo vinculado e, em troca, colocavam o número sob risco de banimento.

O que a Coexistência faz de diferente?

Ela acrescenta a API sem remover o app. O número é registrado na Meta como número de API enquanto o app do WhatsApp Business segue vinculado a ele, então os dois funcionam ao mesmo tempo no mesmo número.

As conversas nunca se movem. Estão no celular, no app, exatamente onde estavam antes, e continuam lá independente do que aconteça com a conexão de API depois. Quando o número conecta pela primeira vez, a Meta sincroniza o histórico recente para o lado da API, para que uma automação ou um agente tenha contexto de uma conversa em andamento em vez de responder às cegas, mas isso é uma cópia adiante, não uma transferência. Nada sai do aparelho.

Uma mensagem de cliente depois disso chega nos dois lugares: no app do celular e no seu webhook. A equipe responde no app se quiser, seu sistema responde se for o caso, e os dois aparecem na mesma conversa.

O que exatamente sincroniza, e o que não?

O histórico recente de mensagens sincroniza, dentro de uma janela após a conexão. É suficiente para uma automação ou um agente ter contexto de uma conversa em andamento.

O que não sincroniza é tudo o que for mais antigo, mídia anterior à conexão e conversas em grupo. Nada disso se perde. Está no celular, no app, legível pela sua equipe exatamente como antes. Só não é copiado para o lado da API, porque a sincronização é um ponto de partida para automação, não um arquivo histórico.

Se você precisa do histórico completo em outro lugar, exporte do app. Isso é um trabalho separado de conectar o número, e vale não confundir os dois.

O que acontece se desconectarmos depois?

O app continua e as conversas seguem lá, porque elas nunca saíram.

Desconectar remove o lado de API do número. O app do WhatsApp Business segue funcionando com cada conversa intacta, e o negócio volta exatamente ao ponto de partida, sem nada para restaurar. Essa é a rede de segurança que vale entender antes de começar: a decisão é reversível de um jeito que a migração antiga nunca foi.

O número também permanece o tempo todo no seu próprio Portfólio de Negócios da Meta. Um provedor o conecta como Tech Provider, que é uma permissão que você concede e pode retirar, então sair de um provedor não significa recuperar um número das mãos dele.

Erros comuns

• Exportar tudo antes por medo. As conversas não vão a lugar nenhum.
• Esperar o histórico completo do lado da API. A sincronização é contexto recente, não arquivo.
• Usar gateway não oficial para manter o app funcionando. A Coexistência faz isso sem risco de banimento.

Perguntas frequentes

Continue lendo