Experimente o Omnifox grátis 7 dias grátis. Sem cartão de crédito.
Guias

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

Guia 2026 para configurar a WhatsApp Cloud API do zero: conta Meta Business, número, verificação, templates e sua primeira mensagem de teste.

July 11, 2026
WhatsApp Cloud API: guia de configuração passo a passo (2026)
Neste artigo

    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.

    Pronto para testar no seu negócio?

    Reúna WhatsApp, Instagram, Messenger, e-mail e chamadas em uma só caixa de entrada e deixe a IA dar a primeira resposta. Configure hoje mesmo.

    7 dias grátis. Sem cartão de crédito.

    Comentários (0)

    Ainda não há comentários. Seja o primeiro a compartilhar.

    Deixe um comentário

    Seu email nunca é publicado. Os comentários são moderados antes de aparecer.

    Markdown suportado. HTML é removido.

    Leia mais

    Fale conosco no WhatsApp