Crie sua API Oficial do WhatsApp do Zero (Passo a Passo)
Links importantes
API Oficial do WhatsApp: Guia Completo de Criação e Aprovação de Apps (2026)
Bora pra ação! Hoje vamos fazer um review completo do passo a passo atualizado para criar seu aplicativo na Meta e destravar todo o poder da API Oficial do WhatsApp. Se você está cansado dos problemas das APIs não oficiais (bloqueios, instabilidade), este guia é o seu ponto de partida para a migração definitiva.
Material de Apoio
Todo o passo a passo e os links mencionados estão detalhados logo acima nesta página para facilitar sua jornada.
Passo 1: Criando seu Aplicativo na Meta
O primeiro passo é criar um app no portal de desenvolvedores do Facebook. É gratuito e você só precisa de uma conta do Facebook e uma Business Manager (BM).
- Acesse developers.facebook.com e faça login.
- Vá em "Meus apps" e clique em "Criar aplicativo".
- Selecione o caso de uso: "Conectar-se com clientes pelo WhatsApp".
- Dê um nome ao seu aplicativo (ex: "App Z-PRO 2026") e associe-o à sua Business Manager.
Importante: Verifique sua Empresa na Business Manager!
Para usar recursos avançados como a Coexistência (usar a API e o WhatsApp no celular ao mesmo tempo), a Meta exige que sua empresa esteja verificada. O processo hoje é simples: basta enviar o CNPJ da sua empresa (até MEI é aceito) e seguir os passos de confirmação.
Passo 2: Configurações Básicas e Publicação
Antes de configurar o WhatsApp, seu app precisa ser publicado.
- No painel do seu app, vá em Configurações > Básica.
- Preencha os campos "URL da Política de Privacidade" e "URL dos Termos de Serviço". Se não tiver, pode usar os da ZDG como exemplo.
- Salve as alterações.
- No topo da página, mude o status do aplicativo de "Em desenvolvimento" para "Publicado".
Passo 3: Configurando o "Caso de Uso" do WhatsApp
A interface da Meta mudou. As configurações do WhatsApp agora ficam dentro da seção "Casos de Uso".
- No menu lateral, vá em Casos de uso > Personalizar (dentro da opção do WhatsApp).
- Você será levado ao painel de configuração da API, onde poderá testar envios, adicionar números e configurar webhooks.
Passo 4: Desbravando o Cadastro Incorporado (Embedded Signup)
Este é o recurso mais poderoso para quem tem um sistema SaaS. Ele permite que seus clientes conectem suas próprias contas do WhatsApp diretamente da sua plataforma, como fazemos no Z-PRO.
- Ainda no painel de "Personalizar", encontre a opção "Configurar cadastro incorporado".
- Crie uma Configuração de Login:
- Clique para criar uma nova configuração.
- Em "Produtos", marque "API de mensagens do WhatsApp".
- Em "Permissões", certifique-se de que
whatsapp_business_managementewhatsapp_business_messagingestejam selecionadas. - Salve a configuração.
- Gerencie os Domínios: Adicione aqui o domínio exato do seu sistema onde o fluxo de onboarding será executado (ex:
meta.zdg.com.br).
Com isso configurado, seu sistema poderá chamar o popup de login da Meta, permitindo que seus clientes façam todo o processo de conexão de forma segura e integrada.
Passo 5: A Análise do App (Necessária para Coexistência)
Embora você já possa usar o Cadastro Incorporado para adicionar novos números, para habilitar a Coexistência, seu app precisa ser aprovado pela Meta.
- No menu do app, vá em Análise do app > Solicitações.
- Solicite as permissões avançadas, como
whatsapp_business_management,whatsapp_business_messagingebusiness_management. - Preencha o Formulário: Este é o passo mais detalhado. Você precisará:
- Explicar detalhadamente como seu app usará cada permissão. (Dica: use o ChatGPT para te ajudar a criar respostas bem estruturadas).
- Gravar um vídeo de screencast mostrando o fluxo completo na sua plataforma, desde o login do usuário até a troca de mensagens via API.
- Fornecer credenciais de acesso (login e senha) para que um analista da Meta possa testar sua aplicação.
Após enviar, o processo de análise pode levar alguns dias. Com a aprovação, seu app estará totalmente liberado para usar todos os recursos avançados da API Oficial, incluindo a Coexistência.
A Meta está claramente facilitando o caminho para a API Oficial. Aproveite este momento para migrar sua operação e garantir mais segurança e estabilidade. E se você não quer passar por toda essa burocracia, o Z-PRO já oferece a integração OAuth, permitindo que você conecte seus clientes de forma rápida e validada.
Qualquer dúvida, é só chamar. Tamo junto!
