WhatsApp Cloud API: guia de configuração passo a passo (2026)

Colocar a WhatsApp Cloud API para funcionar parece intimidante se você nunca fez isso, mas em 2026 o processo está mais organizado do que nunca. Este guia leva você passo a passo, desde criar a conta comercial da Meta até enviar sua primeira mensagem de teste, sem supor que você já é desenvolvedor.

Antes de começar: a Cloud API é a versão hospedada pela Meta (acabou o servidor on-premise, que a Meta descontinuou). A hospedagem é gratuita; você paga apenas pelas conversas que envia.

O que você precisa antes de começar

Reúna isto para não travar no meio do caminho:

• Uma conta Meta Business (Business Manager) verificada ou verificável.
• Um número de telefone que NÃO esteja ativo no app normal do WhatsApp (ou que você esteja disposto a migrar).
• Acesso ao telefone/SMS desse número para receber o código de verificação.
• O nome de exibição do seu negócio, exatamente como você quer que apareça.

Passo 1: crie sua conta e app na Meta

1. Entre em business.facebook.com e crie (ou use) seu Business Manager.
2. Vá em developers.facebook.com e crie um app do tipo Business.
3. Adicione o produto WhatsApp ao app.

A Meta te dá um ambiente de testes com um número de teste e um token temporário. Serve para experimentar, mas para produção você precisa do seu próprio número.

Passo 2: adicione e verifique seu número

No painel do WhatsApp do seu app:

1. Adicione o número de telefone do seu negócio.
2. Escolha o método de verificação (SMS ou ligação).
3. Digite o código que receber.
4. Configure o nome de exibição. A Meta revisa e pode levar de minutos a horas.

Dica: o nome de exibição precisa seguir as políticas da Meta (não pode ser genérico nem enganoso). Um nome rejeitado atrasa tudo.

Passo 3: entenda o token de acesso

É aqui que muita gente empaca. Existem dois tipos de token:

• Token temporário: dura 24 horas, útil só para testar.
• Token permanente (System User): o que você vai usar em produção, gerado a partir de um usuário do sistema no Business Manager.

Para produção, crie um System User, atribua a ele o ativo do WhatsApp e gere um token permanente com as permissões whatsapp_business_messaging e whatsapp_business_management. Guarde com segurança: é a chave da sua conta.

Passo 4: configure o webhook

O webhook é o que permite receber mensagens, não só enviar. Você precisa de:

1. Uma URL HTTPS pública que responda ao challenge de verificação da Meta.
2. Um verify token que você inventa e a Meta devolve para confirmar.
3. Assinar os campos messages para receber mensagens recebidas.

Se você não quer programar o servidor de webhooks, uma plataforma como o Omnifox resolve toda essa parte: você conecta seu número pelo Embedded Signup oficial da Meta e a caixa de entrada recebe e envia sem você tocar em uma linha de webhook.

Passo 5: crie seu primeiro template

Fora da janela de 24 horas, você só pode iniciar conversa com templates aprovados. Crie um:

• Escolha a categoria: utility, marketing ou authentication.
• Escreva o corpo com variáveis {{1}} para personalizar.
• Envie para revisão. A aprovação costuma levar de minutos a um dia.

Evite misturar tom promocional num template utility: é a causa número um de rejeições.

Passo 6: envie sua mensagem de teste

Com o token e o número prontos, um POST no endpoint /messages com o corpo do template envia sua primeira mensagem. Se você receber um objeto messages com um id na resposta, funcionou!

Erros típicos nesta etapa:

• Erro 131009: parâmetro inválido, revise o formato do número (E.164, com +).
• Erro 190: token expirado ou inválido; gere um permanente.
• Número fora da allowlist: em modo de testes você só escreve para números verificados.

Do sandbox para a produção

Para escalar você precisa:

1. Verificar seu negócio na Meta (Business Verification).
2. Subir o limite de mensagens (começa em 250/1.000 conversas/dia e cresce com bom comportamento).
3. Cuidar da qualidade do número (verde/amarelo/vermelho): muitos bloqueios a degradam.

Conclusão

Configurar a WhatsApp Cloud API em 2026 são seis passos claros: criar o app, verificar o número, gerar um token permanente, montar o webhook, criar um template e enviar o teste. A parte técnica que mais assusta —webhooks e tokens— é justamente a que uma plataforma omnichannel te poupa.

Se você prefere pular o trabalho de servidor e ter seu número ativo hoje, conecte o WhatsApp com o Omnifox pelo Embedded Signup oficial e comece a conversar em minutos.