Introdução à Coexistência
Coexistência (CoEx) é a capacidade de usar o app WhatsApp Business e a Cloud API simultaneamente no mesmo número de telefone. Com a Coexistência, as conversas individuais 1-a-1 continuam a fluir pelo app, enquanto sua integração aproveita a Cloud API para automação, webhooks e fluxos estruturados. O WhatsApp mantém contatos e histórico de mensagens automaticamente sincronizados entre os dois ambientes.Por que usar Coexistência?
A Coexistência é ideal para migrações suaves de um provedor para outro ou para empresas que desejam manter operadores usando o app enquanto constroem automações paralelas:- Migração sem perda de histórico: você não perde conversas, contatos ou contexto ao ativar a Cloud API
- Contatos sincronizados: nomes, números de telefone e informações de contato permanecem consistentes entre o app e a API
- Histórico compartilhado: mensagens anteriores ficarão disponíveis em ambas as plataformas
- Transição gradual: adapte seus processos à Cloud API no seu próprio ritmo
Elegibilidade
Para usar a Coexistência, você precisa atender aos seguintes requisitos:Caso tenha dúvidas sobre seu status de parceiro ou elegibilidade, consulte o guia oficial de onboarding da Meta.
Limitações importantes
Fluxo de Coexistência
O processo de ativação da Coexistência segue estas etapas:- Embedded Signup: o cliente acessa a Coexistência dentro do app WhatsApp Business
- Sincronização de contatos: importação de contatos armazenados no app para a nuvem
- Sincronização de histórico: importação de conversas anteriores em fases (até 180 dias)
- Espelhamento de mensagens: mensagens enviadas via app são replicadas para a Cloud API (via
smb_message_echoes) - Operação normal: ambas as plataformas funcionam em paralelo