WhatsApp Coexistence: Como usar a Cloud API Oficial da Meta junto com Evolution API

1. Arquitetura e pré-requisitos no ambiente

Operações maduras combinam números na API Oficial da Meta (para disparos em massa via templates aprovados e zero risco de bloqueio no número principal) com instâncias QR Code para atendimento consultivo de vendedores.

• Aplicativo criado no Meta for Developers com produto WhatsApp Business configurado.
• Token Permanente do Usuário do Sistema no Gerenciador de Negócios (BM) e Phone Number ID.

2. Passo a passo de implementação e validação

1. Ao criar a instância na Evolution API v2 (ou diretamente na Inbox WhatsApp Cloud do Chatwoot), selecione a integração WHATSAPP-BUSINESS (Meta Cloud API).
2. Informe o Token Permanente, o Phone Number ID e o Business Account ID (WABA).
3. Copie a URL de Webhook e o Verify Token gerados e cole no painel do Meta for Developers assinando o campo messages.
4. Teste o envio de um Template HSM aprovado e valide o recebimento da resposta do cliente no Chatwoot/n8n.

3. Boas práticas de produção, segurança e escala

Com ambas as conexões centralizadas na sua VPS em São Paulo, seu time atende na mesma tela do Chatwoot independentemente do tipo de conexão do número.

• Monitore a classificação de qualidade (Verde/Amarela/Vermelha) do número no painel da Meta.