Visão geral
O Coexistence permite que um número conectado pela WhatsApp Cloud API continue sendo usado também no app oficial do WhatsApp Business no celular, ao mesmo tempo em que a plataforma atende. É a "coexistência" entre o aplicativo e a API: o que acontece em um lado aparece no outro.
Na prática, o Coexistence faz três coisas:
- Sincroniza o histórico de conversas existentes do app para a plataforma.
- Sincroniza os contatos do app para a plataforma.
- Reflete os echoes — mensagens que um atendente enviou pelo app oficial aparecem também na conversa da plataforma, mantendo o histórico completo e único.
A ativação desconecta os aparelhos conectados. Ao ativar a coexistência, a Meta desconecta todos os aparelhos conectados do WhatsApp Business — inclusive uma caixa do WhatsApp Web que já estivesse pareada nesse número. Por isso, conecte sempre a Coexistência primeiro, aguarde a sincronização da Meta (pode levar até ~24 horas) e só então conecte/pareie o WhatsApp Web. O repareamento não perde nada: a mesma caixa é reaproveitada — número, conversas, contatos e histórico permanecem.
Pré-requisitos
- Uma caixa de entrada de WhatsApp Cloud já conectada (via Embedded Signup).
- O número precisa estar em modo de coexistência habilitado na Meta para esse número.
- Coexistence é um recurso do WhatsApp Cloud — não se aplica ao WhatsApp Web (QR).
- Em alguns ambientes, a sincronização precisa ser habilitada pela operação.
Passo a passo
- Conecte (ou confirme) a caixa de entrada de WhatsApp Cloud pelo Embedded Signup.
- Garanta que o número esteja com a coexistência habilitada na Meta.
- Após a conexão, a plataforma inicia a sincronização do histórico das conversas recentes.
- Os contatos do app oficial são importados para a base de contatos.
- A partir daí, mensagens enviadas pelo app oficial aparecem automaticamente nas conversas (echoes), e tudo o que a equipe envia pela plataforma também chega ao app.
Configurações & opções
- Histórico: a sincronização traz as conversas recentes disponíveis no app; mensagens muito antigas podem não vir, conforme o que a Meta disponibiliza.
- Contatos: a importação cria/atualiza contatos a partir da agenda da conta no WhatsApp.
- Echoes: mensagens enviadas pelo celular ficam marcadas como saídas na conversa, preservando a autoria da operação.
- Mídia: anexos sincronizados também ficam disponíveis na conversa.
Casos de uso
- Continuar atendendo casos urgentes pelo celular sem perder o registro na plataforma.
- Migrar de uma operação 100% no app oficial para a plataforma sem perder o histórico.
- Manter um time híbrido (alguns no app, outros na plataforma) com histórico unificado.
Dicas, limites e boas práticas
- A sincronização de histórico é pontual (ocorre na conexão/ativação) — mensagens novas chegam em tempo real depois disso.
- Prefira, no dia a dia, atender pela plataforma para aproveitar atribuição, automações e relatórios.
- Como o histórico depende do que a Meta disponibiliza, trate-o como melhor esforço, não como backup completo.
- A sincronização inicial da Meta pode levar até ~24 horas; só considere a caixa pronta quando ela estiver recebendo e enviando normalmente.
- Abra o app WhatsApp Business pelo menos uma vez a cada ~14 dias no celular do número. Sem isso, a coexistência perde a saúde e pode parar de sincronizar.
Solução de problemas
- O histórico não apareceu: confirme que a coexistência está habilitada na Meta para o número e aguarde a sincronização concluir.
- Mensagens do app não aparecem (echoes): verifique se o número está realmente em coexistência e se a caixa Cloud está conectada.
- Contatos faltando: a importação reflete a agenda disponível no momento da sincronização; novos contatos passam a aparecer conforme conversam.
- A caixa do WhatsApp Web ficou "desconectada da conta" depois de ativar a coexistência: é o comportamento esperado — a ativação desconecta todos os aparelhos conectados. Gere um novo QR na tela de conexão da caixa do WhatsApp Web e pareie novamente; nada se perde.
- A caixa Cloud sumiu da lista de pareamento depois de reconectar pela Meta: corrigido. A reconexão pelo Embedded Signup passou a gravar a mesma marca de coexistência que a criação já gravava; antes ela era perdida na reautorização e a caixa deixava de ser oferecida para parear. Qualquer caixa nessa situação se conserta sozinha na próxima reconexão — não é preciso recriar nada.
- A lista de pareamento não mostra a caixa que eu esperava: a lista agora oferece só o que o pareamento vai aceitar de fato. Uma caixa Cloud comum (token colado à mão, sem o app WhatsApp Business no aparelho) não é coexistência e, por isso, não aparece — antes ela aparecia e o clique terminava em erro sem explicação.
- Ordem de conexão: conecte a Coexistência (Cloud) primeiro, espere a sincronização da Meta concluir e só então conecte a caixa do WhatsApp Web no mesmo número. Se fizer o contrário, a caixa Web mostra um aviso de que o número já tem outra caixa — é só um aviso, e some quando você parear as duas.