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)

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).

  1. Acesse developers.facebook.com e faça login.
  2. Vá em "Meus apps" e clique em "Criar aplicativo".
  3. Selecione o caso de uso: "Conectar-se com clientes pelo WhatsApp".
  4. 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.

  1. No painel do seu app, vá em Configurações > Básica.
  2. 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.
  3. Salve as alterações.
  4. 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".

  1. No menu lateral, vá em Casos de uso > Personalizar (dentro da opção do WhatsApp).
  2. 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.

  1. Ainda no painel de "Personalizar", encontre a opção "Configurar cadastro incorporado".
  2. 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_management e whatsapp_business_messaging estejam selecionadas.
    • Salve a configuração.
  3. 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.

  1. No menu do app, vá em Análise do app > Solicitações.
  2. Solicite as permissões avançadas, como whatsapp_business_management, whatsapp_business_messaging e business_management.
  3. 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!