WhatsApp Business API: implantação, verificação da empresa e selo#
Você decidiu pelo caminho oficial e agora precisa entender por que ele leva dias, quem são as empresas envolvidas e o que exatamente você precisa entregar. Esta página é o mapa dessa implantação.
Antes de começar#
Você vai precisar de:
- Um número de telefone que não esteja em uso em nenhuma conta de WhatsApp — nem comum, nem Business. Se estiver, ele precisa ser liberado antes, e essa liberação apaga o histórico daquele número.
- CNPJ ativo e os documentos que provam que a empresa existe.
- Um Business Manager da Meta com a empresa cadastrada.
- Um BSP — a empresa intermediária que revende o acesso à API. No Doot, os provedores prontos são 360dialog e Twilio. Veja O que é BSP e broker.
As três coisas que costumam ser confundidas#
| Coisa | O que é | Sem ela |
|---|---|---|
| Conta WABA | A conta de WhatsApp Business na Meta | Não existe número oficial |
| Verificação da empresa | A Meta confere que a sua empresa é real | Limites baixos de envio |
| Selo verde | Marca de conta oficial no perfil | Nada deixa de funcionar |
O selo verde não é requisito. Ele é concedido por critério de notoriedade da marca, e a maior parte dos provedores regionais não o obtém — sem que isso impeça nada. Não trave a implantação esperando por ele.
A verificação da empresa, sim, importa: sem ela os limites de envio ficam baixos, o que aparece como mensagens recusadas justamente no dia em que o volume sobe.
Como fazer#
- Escolha o BSP e contrate. É ele quem emite a chave de API.
- Crie ou conecte a conta WABA no Business Manager da Meta.
- Registre o número na WABA. O número sai do WhatsApp comum neste momento.
- Envie a documentação da empresa e aguarde a verificação.
- No Doot, em Configurações → Canais, crie o canal do provedor escolhido (360dialog WhatsApp ou Twilio WhatsApp).
- Informe a chave de API do canal e configure o webhook indicado pelo provedor.
- Cadastre os primeiros modelos de mensagem e espere a aprovação — veja Modelos de mensagem.
- Mande uma mensagem de teste e confirme que ela cai na fila.
As duas chaves do 360dialog, que não são a mesma#
Este é o engano mais previsível da implantação com 360dialog, e ele custa uma tarde:
| Chave | Endereço | Cabeçalho | Alcance |
|---|---|---|---|
| Do canal | waba-v2.360dialog.io | D360-API-KEY | Fala por um número |
| De parceiro | hub.360dialog.io | X-API-Key | Enxerga todos os canais |
A chave do canal é a que manda mensagem, e mora no cadastro do canal. A de parceiro é a que destrava criar formulários (Flows), e mora numa tela separada — justamente para não passar a impressão de que o alcance é o mesmo.
Existe um botão de testar a conexão de parceiro, e ele não é cortesia: "eu sou parceiro do 360dialog?" é uma pergunta que ninguém responde sozinho, porque a conta de desenvolvedor e a de parceiro se parecem no site deles. O teste responde com fato — se a chave abrir, a lista de canais volta; se não abrir, volta a recusa deles, com o texto deles. Melhor descobrir ali do que depois de montar o formulário inteiro.
O que muda no dia a dia depois de oficializar#
- Fora da janela de 24 horas, só modelo aprovado sai. Isso muda a rotina de quem faz contato ativo. Leia A janela de 24 horas.
- Cada conversa tem custo. Veja Categorias de cobrança.
- Botões, menus e formulários passam a existir de verdade.
Se algo der errado#
O número não aceita ser registrado. Ele ainda está vinculado a uma conta de WhatsApp. Remova-o de lá primeiro — e saiba que essa remoção apaga o histórico daquele número.
A verificação da empresa é recusada. Quase sempre é divergência entre o nome no documento e o cadastrado no Business Manager. Corrija o cadastro e reenvie.
As mensagens somem sem erro na conversa. Confira o webhook: se ele não está apontando para o seu servidor, o Doot não recebe o retorno. Veja Erros comuns da Cloud API.
O canal conecta mas nenhum modelo aparece. Modelo é objeto da conta na Meta, e leva tempo para propagar depois de aprovado. Confira o status em Modelos de mensagem.