Sobre este artigo
Este é um artigo de referência que compara as duas formas de conectar WhatsApp à Nuvia. Você aprenderá as diferenças técnicas, quando usar cada uma e qual escolher para sua operação.
O que são essas duas conexões?
WhatsApp Cloud API (Meta)
A forma oficial de conectar WhatsApp desenvolvida pelo Meta. Seus dados ficam hospedados nos servidores do Meta, e você usa a plataforma Nuvia como intermediária.
Características:
API oficial do Meta
Suportada completamente pela Nuvia
Exige configuração de credenciais (Phone ID, Business ID, Token)
Oferece HSM templates nativamente
Suporta janela de 72h (Click to WhatsApp ads)
Escalabilidade garantida
WhatsApp Business (Evolution API)
Uma alternativa não-oficial que usa a API Evolution. Permite conectar um número de WhatsApp de forma mais simples, via QR code ou número + senha.
Características:
API não-oficial (Evolution)
Setup mais simples (menos campos técnicos)
Permite envio de mensagens livres
Não suporta HSM templates nativamente
Sem suporte garantido para CTWA 72h
Menos estável que Cloud API
Comparativo detalhado
Critério
| WhatsApp Cloud API
| WhatsApp Business (Evolution)
|
Status
| Oficial do Meta
| Não-oficial (terceiros)
|
Setup
| Complexo (exige API keys)
| Simples (QR code ou credenciais)
|
HSM Templates
| Sim, nativo
| Não
|
Janela 72h (CTWA)
| Sim, garantido
| Não (sem garantia)
|
Mensagens livres
| Só dentro janela 24h
| Sim, sem restrições
|
Escalabilidade
| Até Tier 4 (sem limite/dia)
| Limitada (~1.000 msg/dia)
|
Confiabilidade
| Muito alta (Data center Meta)
| Moderada (depende de terceiros)
|
Taxa de erro
| <0,1%
| 1–5%
|
Suporte técnico
| Meta + Nuvia
| Nuvia apenas
|
Custo
| Pagamento por mensagem ao Meta
| Geralmente sem custo direto
|
Recomendado para
| Empresas em escala, campanhas, SLAs
| Testes, pequenas equipes, flexibilidade
|
Quando usar cada um?
Use WhatsApp Cloud API se:
Você vai enviar mais de 1.000 mensagens por dia
Precisa de HSM templates (outbound em frio)
Quer usar CTWA 72h (anúncios Meta com janela estendida)
Precisa de confiabilidade e SLA (seu negócio depende disso)
Você opera campanhas de escala (10K+ contatos)
Seu time é grande ou você usa múltiplos números
Você integra com Salesforce, HubSpot ou CRM enterprise
Cloud API é o recomendado para 99% dos casos.
Use WhatsApp Business (Evolution) se:
Você está testando o produto antes de comprometer
Sua operação é pequena (<500 contatos/mês)
Você quer flexibilidade máxima (enviar mensagens livres sem template)
Você não vai fazer outbound em frio (só responder a inbound)
Você não precisa de SLA/suporte premium
Você quer evitar pagamento por mensagem ao Meta
Você está usando um número pessoal ou número de teste
Setup de cada uma
WhatsApp Cloud API
Requisitos antes de começar:
Conta Meta Business (com acesso a Meta Business Manager)
Número de telefone verificado
Phone ID, Business ID e Business Token
Fluxo na Nuvia:
Menu lateral > Plataforma > Canais
Clique em + Conectar WhatsApp
Escolha WhatsApp Cloud API
Cole os valores:
Phone Number ID
WABA (WhatsApp Business Account) ID
Business Token
Configure webhook (URL que o Meta envia atualizações de mensagens)
Clique em Conectar
⚠️ Tokens são confidenciais. Nunca compartilhe em chats, e-mails ou documentos públicos.
A Nuvia testará a conexão automaticamente. Se sucesso, você verá "Conectado" e consegue começar a enviar mensagens.
WhatsApp Business (Evolution API)
Requisitos:
Um número de WhatsApp ativo
Acesso ao telefone para escanear QR code (ou credenciais de login)
Fluxo na Nuvia:
Menu lateral > Plataforma > Canais
Clique em + Conectar WhatsApp
Escolha WhatsApp Business (Evolution)
Você verá um QR code; abra WhatsApp Web no navegador (web.whatsapp.com) e escaneie
Authorize a Nuvia a acessar sua conta
Clique em Conectar
Conexão é estabelecida em segundos. Se QR code expirar, regenere clicando em Novo QR code.
💡 QR code é mais seguro que usar credenciais diretas.
Janela de 72h (apenas Cloud API)
Se você usa Click to WhatsApp ads (anúncios de Meta que levam a WhatsApp), o Meta oferece uma janela estendida de 72 horas para responder. Isso só funciona com Cloud API.
Requisitos:
WhatsApp Cloud API conectada
Campanhas de anúncio configuradas no Meta Ads Manager
Lead vem do anúncio (Click to WhatsApp)
Quando ativado, a Nuvia automaticamente oferece 72h em vez de 24h para mensagens livres.
Coexistência de ambas no mesmo workspace
Você pode ter Cloud API e Evolution conectadas simultaneamente no mesmo workspace. Elas operam como canais separados:
Cada uma tem sua própria seção em Canais
Cada uma tem seus próprios templates (se Cloud API)
Você escolhe qual usar ao criar uma campanha
⚠️ Restrição: O mesmo número não pode estar conectado em ambas ao mesmo tempo. Se você tem um único número, escolha uma.
Caso de uso comum: número principal em Cloud API, número de backup/teste em Evolution.
Escalabilidade e limites
WhatsApp Cloud API
Métrica
| Limite
|
Mensagens/dia
| Depende do Tier (1K, 10K, 100K ou unlimited)
|
Templates por número
| Até 6.000
|
Conversas simultâneas
| Sem limite técnico
|
Taxa de entrega
| >99%
|
Latência
| <1 segundo (geralmente)
|
Você começa em Tier 1 e progride demonstrando qualidade (baixa taxa de bloqueios) por 7 dias.
WhatsApp Business (Evolution)
Métrica
| Limite
|
Mensagens/dia
| ~1.000 (varia)
|
Escalabilidade
| Não recomendado para escala
|
Taxa de entrega
| 95–98%
|
Latência
| 2–5 segundos (mais variável)
|
Confiabilidade
| Sujeita a degradação por uso
|
FAQ
P: Qual devo escolher se estou começando do zero?
R: Cloud API. Sim, o setup é um pouco mais complexo, mas vale a pena desde o início. Evita retrabalho depois. Se você não quer lidar com API keys agora, comece com Evolution, mas planeje migrar para Cloud API em 1–2 meses.
P: Posso migrar de Evolution para Cloud API depois?
R: Sim. Você cria uma nova conexão Cloud API, configura templates, e muda suas campanhas/funis. Contatos e históricos de conversa permanecem intactos. Recomendamos fazer isso fora do horário de pico.
P: Se eu usar Evolution, perco minhas mensagens quando desconecto?
R: Não. Histórico de conversa fica armazenado na Nuvia. Mas futuros agentes de IA precisarão de Cloud API (Evolution não suporta agentes robusto).
P: Qual é mais barato?
R: Evolution normalmente é gratuito ou de custo muito baixo. Cloud API cobra por mensagem ao Meta (~R$ 0,10–0,20 por mensagem, dependendo do país). Para 10K mensagens/mês, Cloud API custa ~R$ 1K–2K. Vale a pena se sua taxa de conversão justifica.
P: Cloud API suporta múltiplos números da mesma empresa?
R: Sim. Você cria múltiplas conexões (uma por número) e cada uma tem seus templates. Recomendado para empresas com equipes separadas ou produtos distintos.
P: E se meu token Cloud API vencer?
R: Tokens Meta não "vencem" no sentido de expiração de data. Mas se você revogar acesso no Meta Business Manager ou trocar senha, o token fica inválido. Você precisa regenerar e atualizar na Nuvia.
P: A Evolution API vai ser descontinuada?
R: Não há anúncio oficial disso, mas Meta sempre favoreceu Cloud API. Não é garantido que Evolution terá suporte indefinido. Planeje uma migração para Cloud API em médio prazo.
P: Posso usar Cloud API sem ser Meta Partner?
R: Sim. Qualquer conta Meta Business pode usar Cloud API. Você não precisa ser "partner" ou certificado.
P: Qual oferece melhor qualidade de dados?
R: Cloud API, porque é oficial. Meta rejeita padrões de spam com mais rigor em Cloud API, o que significa que números de Cloud API têm reputação mais forte.
Próximos passos
Escolha qual conexão faz sentido para você
Siga o guia de setup apropriado em Plataforma > Canais
Leia Entendendo as regras do WhatsApp para aprender sobre HSM e janelas
Configure seus primeiros templates (se Cloud API) ou comece a enviar (se Evolution)