Capítulo 3 de 13
Business, aplicativo, número, verificação da empresa e a chave que não expira. É a parte chata, e ela vem primeiro.
Manual gratuito de Certu · Atualizado em 30 de agosto de 2026 · ver o manual inteiro
Resposta curta
Você cria uma conta no Meta Business, cria um aplicativo no portal de desenvolvedores, adiciona o produto WhatsApp, cadastra e verifica um número de telefone, envia os documentos da empresa para a verificação e gera uma chave permanente por um usuário do sistema. Tudo gratuito, e a verificação leva de horas a alguns dias.
Sete passos. Os cinco primeiros levam meia hora, o sexto depende da Meta.
Em business.facebook.com, crie a conta da empresa com o nome oficial, o mesmo do CNPJ. Nome diferente do documento é o motivo mais comum de a verificação ser recusada depois.
Em developers.facebook.com, vá em Meus aplicativos e crie um novo. Escolha o tipo voltado a negócios e ligue esse aplicativo à conta do Business que você acabou de criar.
Dentro do aplicativo, adicione o WhatsApp. A Meta cria automaticamente uma conta do WhatsApp Business e um número de teste que já manda mensagem para até cinco telefones que você cadastrar. Serve para testar tudo antes de mexer no seu número.
Na tela de configuração da API você encontra o identificador do número (phone number ID), o identificador da conta do WhatsApp Business (WABA ID) e uma chave temporária. Guarde os dois identificadores: eles entram no código dos próximos capítulos.
Ainda na configuração da API, adicione o número do chip novo e confirme o código que chega por SMS ou por ligação. Se o número estiver ativo em algum aplicativo do WhatsApp, apague a conta dele no aplicativo antes, senão o cadastro falha.
Nas configurações do Business, em Central de segurança, inicie a verificação da empresa e envie os documentos. Enquanto ela não sai, você fica no degrau mais baixo de envio e não consegue aprovar modelo de mensagem.
Nas configurações do Business, crie um usuário do sistema, dê a ele acesso ao aplicativo e gere uma chave com as permissões whatsapp_business_messaging e whatsapp_business_management, sem prazo de validade. É essa chave que vai para o código.
Onde as pessoas se queimam
A chave que aparece na primeira tela da API expira em 24 horas. Quase todo mundo perde meia hora achando que o código quebrou, quando o que aconteceu é que a chave venceu durante a noite. Só a chave do usuário do sistema, do passo 7, dura.
Antes de escrever qualquer linha, mande uma mensagem pelo terminal.
Troque o identificador do número, a chave e o telefone de destino. O telefone vai sem sinal de mais e sem traço, começando pelo código do país: 55, o DDD e o número.
Se voltar um JSON com um identificador começando em wamid, funcionou. Se voltar erro 190, a chave venceu ou está errada. Se voltar 131030, o telefone de destino não está na lista de testes permitidos, coisa que só acontece enquanto você usa o número de teste da Meta.
curl -X POST \
"https://graph.facebook.com/v26.0/SEU_PHONE_NUMBER_ID/messages" \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5548999999999",
"type": "text",
"text": { "body": "primeira mensagem pela API" }
}'De algumas horas a alguns dias. Não há como acelerar, e não adianta reenviar o mesmo documento várias vezes.
Enquanto espera, siga o manual usando o número de teste. Todo o código dos próximos capítulos funciona igual com ele.
Não. Criar o Business, o aplicativo, a conta do WhatsApp Business e cadastrar o número é gratuito. A cobrança só existe por mensagem que você inicia.
Na maioria das vezes porque o nome cadastrado no Business é diferente do nome no documento, ou porque o endereço enviado não bate com o do cartão do CNPJ. Corrija o cadastro e envie de novo.
Pode, desde que ele receba a ligação de verificação. A Meta oferece verificação por chamada telefônica justamente para números fixos.
Contas novas começam em um degrau baixo de conversas iniciadas por você em 24 horas e sobem conforme a verificação sai e a qualidade do número se mantém. Responder quem te procurou não entra nesse limite.
E onde entra Certu
Este capítulo é o que Certu resolve com o botão de conectar: a conta, o aplicativo, a chave e a verificação já estão no lugar do outro lado, porque Certu é provedora de tecnologia da plataforma do WhatsApp Business da Meta. Fazendo sozinho, o trabalho é exatamente o descrito aqui, e ele é uma vez só.
Ver o que Certu faz e quanto custa