Guia
API Cloud × Coexistência: prós, contras e quando escolher
Senha incorreta.
Tem a senha deste guia ou da comunidade? A da comunidade vale para todos os materiais.
Quero fazer parte e receber esse tipo de conteúdoAPI Cloud × Coexistência: prós, contras e quando escolher
Dois jeitos de conectar o mesmo número à API Oficial. Este material organiza vantagens, riscos e critérios práticos para decidir.
Última atualização: 30 de março de 2026
Contexto rápido
A API Oficial do WhatsApp Business é o caminho profissional: múltiplos atendentes, automação, integração com CRM, menor risco de banimento que soluções não oficiais. Na hora de conectar o número, aparecem dois modelos: Cloud (embedded signup “clássico”) e Coexistência (CoEx). A escolha errada gera atrito operacional, sobretudo quando o time ainda depende do celular ou do histórico antigo.
Conexão Cloud
O número é registrado na API via Meta Business Manager, migrado para a nuvem da Meta e o WhatsApp Business App é desconectado do celular. Todo o tráfego passa pela plataforma ligada à API; não há mais atendimento pelo app no telefone.
Prós (Cloud)
- Controle centralizado: nada fica “só no celular” de alguém.
- Estabilidade: não depende de aparelho ligado, internet móvel ou app aberto.
- Automação completa: filas, bots e triagem sem interferência do app.
- Sem risco de resposta duplicada entre app e plataforma (porque o app some da equação).
Contras (Cloud)
- Sem WhatsApp no celular para aquele número: é definitivo nesse modelo.
- Histórico anterior não é transferido para a plataforma.
- Transição brusca para quem “vivia” no app.
- Conforme a referência, o selo azul (Meta Verified) pode ser perdido na migração Cloud. Confirme sempre a central de ajuda e seu BSP.
Coexistência (CoEx)
O número permanece ativo no WhatsApp Business App e a plataforma fica conectada à mesma linha. Mensagens e contatos sincronizam entre app e API: duas portas para o mesmo número.
Prós (Coexistência)
- Transição gradual: sócio no celular, equipe na plataforma.
- Histórico preservado: conversas seguem no app; a referência cita importação de até 6 meses de chats 1:1 para a plataforma (mídias com janela menor, conforme documentação Meta/parceiros).
- Sincronização de contatos automática (na Cloud isso não se aplica da mesma forma).
- Mensagens enviadas pelo app continuam no modelo “gratuito” do app; o que passa pela API segue a tabela de preços da Meta.
Contras (Coexistência)
- Disciplina operacional: sem processo, duas pessoas podem responder o mesmo cliente.
- Automations do app (boas-vindas, ausência) devem ser desligadas para não duplicar respostas com o bot da plataforma.
- Estabilidade parcialmente ligada ao app: conforme as WhatsApp Coexistence Guidelines oficiais, o app primário precisa ser aberto pelo menos a cada 14 dias para manter a sincronização ativa. Sem isso, a conexão pode ser desativada.
- Dispositivos vinculados limitados: na prática citada, Web e WhatsApp para Mac; Windows e WearOS podem não sincronizar como esperado.
- Requisitos (conforme guidelines oficiais): app em versão mínima suportada (verifique a versão atual na documentação Meta), número ativo no app por tempo mínimo (recomendação de semanas a meses de uso ativo), número não preso a outra API não oficial.
- Selo Meta Verified não é garantido; migrações podem afetar verificação. Trate como risco a validar com suporte.
- Grupos não entram na importação da plataforma como 1:1; permanecem no app.
Comparativo direto
| Aspecto | Cloud | Coexistência |
|---|---|---|
| Histórico do número na plataforma | Não transferido | Mantido / importável (1:1, limites de tempo) |
| WhatsApp no celular (mesmo número) | Não | Sim |
| Atendimento | Só plataforma | App + plataforma |
| Risco de dupla resposta | Baixo | Alto se não houver regra |
| Dependência do aparelho | Baixa | Maior (sync / app) |
| Custo da API (mensagens) | Tabela Meta | Mesma tabela Meta para tráfego API |
Como funciona o routing de mensagens na Coexistência
Na coexistência, mensagens recebidas chegam simultaneamente no app e na plataforma conectada à API. O comportamento de envio depende da origem:
- Mensagem enviada pelo app: é uma mensagem "normal" do WhatsApp (gratuita, sem passar pela API). A plataforma recebe a notificação via webhook, mas a conversa foi iniciada pelo app.
- Mensagem enviada pela API: segue a tabela de preços da Meta (por conversa). Aparece também no app como mensagem enviada.
- Risco operacional: se alguém responde pelo app ao mesmo tempo que um bot responde pela API, o cliente recebe duas respostas. Defina regras claras de quem responde por qual canal.
Quando escolher cada uma
Cloud faz sentido quando ninguém precisa do app no celular, o histórico antigo não é crítico (ou o número é novo) e você quer tudo fechado na plataforma.
Coexistência costuma ser melhor quando preservar histórico e hábito no celular importa, ou quando você quer adoção gradual. Depois de estável, é possível evoluir para cenário mais “só nuvem”, conforme política do BSP. O inverso tende a ser mais trabalhoso.
Fonte principal: chatjuridico.com.br/api-oficial-conexao-cloud-vs-coexistencia/