Como ativar o WhatsApp Coexistence: passo a passo sem sustos

Para ativar o WhatsApp Coexistence você precisa de três coisas: o número no aplicativo WhatsApp Business (não no WhatsApp pessoal), esse número sem ligação com outra API e o dono do número com o celular em mãos. A ativação acontece pelo Embedded Signup da Meta: você inicia a conexão no provedor, autoriza no fluxo da Meta, escaneia um QR code no app e espera a sincronização do histórico terminar. Depois, testa se as conversas aparecem dos dois lados. O processo é curto. O que costuma dar errado está antes (requisito não conferido) e depois (ninguém testa nada).

Antes de começar: a lista de verificação

Metade dos problemas de ativação some se você passar por esta lista antes de clicar em qualquer botão:

• o número está no aplicativo WhatsApp Business, o verde de empresa
• o número não está conectado a outra API, em nenhum outro provedor
• quem vai fazer a conexão tem acesso ao aparelho com o app instalado
• você escolheu um horário em que ninguém vai mexer na configuração nas horas seguintes
• a equipe sabe que listas de transmissão e alguns recursos do app vão ficar travados
• você já sabe o que quer fazer primeiro com a API: medir, enviar confirmação, receber relatório

O segundo item é o que mais trava. Um número só pode estar em uma API por vez. Se em algum momento alguém ligou esse número a uma plataforma de disparo ou de atendimento, ele precisa ser desligado lá antes. Os detalhes de cada requisito estão em requisitos da coexistência.

E o quinto item é o que mais gera reclamação depois. Enquanto a API estiver conectada, o app perde as listas de transmissão, as mensagens temporárias, a visualização única e a localização ao vivo. Os grupos continuam no celular, mas ficam fora da API. Se alguém da equipe depende de lista de transmissão para avisar cliente, combine antes como isso vai ser feito.

Passo 1: comece a conexão pelo provedor

A coexistência não se ativa dentro do aplicativo. Ela começa na plataforma do provedor que vai se conectar ao seu número, que abre o fluxo oficial da Meta, o Embedded Signup.

Antes de começar, confirme com o provedor duas coisas: se ele oferece coexistência (e não só migração) e como cobra. São duas contas separadas: a da Meta, por mensagem enviada pela API, e a do provedor. Se a proposta só fala em "conectar o WhatsApp", pergunte com todas as letras: "a equipe continua atendendo pelo app no mesmo número?".

Passo 2: autorize no fluxo da Meta

O Embedded Signup é uma janela da própria Meta. É ali que o dono do número autoriza a conexão. O provedor não recebe senha e não precisa do seu celular: quem decide é você, dentro do ambiente da Meta.

Um cuidado prático: faça esta etapa com quem realmente responde pelo número e pela conta da empresa. Delegar para um freelancer ou um estagiário que não tem esse acesso costuma terminar com a conexão parada no meio.

Passo 3: escaneie o QR code no aplicativo

Em algum ponto do fluxo, aparece um QR code. Ele é escaneado pelo aplicativo WhatsApp Business do celular do número. É esse passo que liga o app à API sem tirar o número do aparelho.

Se o número estiver no WhatsApp pessoal, este passo não funciona. A coexistência exige o app de empresa.

Passo 4: deixe a sincronização terminar

Depois do QR code, a Meta sincroniza até 6 meses de histórico do aplicativo. Isso leva de minutos a horas e acontece uma vez só. A partir daí, tudo o que entra e sai é registrado ao vivo.

Não dá para prometer um tempo exato, porque depende do volume de conversas. O que dá para fazer é não atrapalhar: não reinicie o processo, não desconecte para "tentar de novo", não comece outra conexão em paralelo. Como a sincronização acontece uma vez só, interromper no meio é o jeito mais fácil de ficar com um histórico incompleto. Mais detalhes em como funciona a sincronização.

Passo 5: o que conferir depois de ativar

Ativar não é o fim. É agora que você descobre se ficou tudo certo, e a conferência é rápida. Use a tabela:

Um detalhe sobre o teste de envio: a janela de 24 horas da Cloud API só abre com mensagem do cliente. Por isso o teste começa com uma mensagem de fora para o número. Mensagem que a sua equipe envia pelo app não abre, não estende e não afeta essa janela, e também não é cobrada. Fora da janela, mensagem iniciada pela empresa pela API exige modelo aprovado pela Meta.

Os cuidados das primeiras semanas

A ativação deu certo. Agora vêm os erros que aparecem só com o tempo:

Abra o app de vez em quando. Se ninguém abrir o WhatsApp Business por cerca de 14 dias, a Meta pode derrubar a conexão. Isso pega principalmente números que só recebem lead de anúncio e que ninguém olha todo dia.

Não troque disparo por envio manual em massa. Com a lista de transmissão travada, a tentação é mandar a mesma mensagem para dezenas de contatos pelo celular. Esse é exatamente o padrão que a Meta pune. A qualidade do número cai e os bloqueios continuam valendo. Veja qualidade do número no WhatsApp.

Respeite o teto. O número passa a ter limite de 20 mensagens por segundo. Para atendimento, sobra. Para quem planejava disparo grande, é um dado a considerar.

Comece por uma automação só. Confirmação de agendamento, aviso de recebimento, relatório interno. O plano das primeiras semanas está em primeiros 30 dias com coexistência.

Se algo der errado na ativação

Os travamentos mais comuns e o que fazer:

O fluxo não aceita o número. O mais comum é ele ainda estar ligado a outra API. Desligue no provedor anterior e tente de novo. Um número só fica em uma API por vez.

O QR code não funciona. Confira se você está escaneando pelo aplicativo WhatsApp Business, e não pelo WhatsApp pessoal, e se é o aparelho do número certo.

A sincronização parece parada. Ela pode levar horas. Antes de concluir que deu erro, espere. Recomeçar o processo no meio costuma piorar.

A conexão caiu semanas depois. Quase sempre é o app que ficou fechado por cerca de 14 dias. Combine com a equipe quem abre o WhatsApp Business do número com regularidade.

Os outros tropeços que aparecem depois da ativação estão em erros comuns da coexistência.

Próximo passo

Passe pela lista de verificação, confirme que o número está no app de empresa e livre de outra API, e reserve um horário tranquilo para conectar. Se você quer ver como o módulo funciona antes, a página de WhatsApp Coexistence mostra o que ele faz. Para começar, crie sua conta: os primeiros 7 dias custam R$ 9,90.