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.
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.
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.