Como contratar e ativar a API oficial do WhatsApp passo a passo
O caminho completo para ativar a API oficial do WhatsApp: documentos, verificação da empresa, conexão do número, nome de exibição e o que reprova cada etapa.
Resumo por IA
Resumo gerado por IA, revisado pela redação.
Ativar a API oficial do WhatsApp leva de um dia a algumas semanas, e o que decide o prazo não é a parte técnica: é a verificação da sua empresa na Meta. O caminho curto, para quem não tem programador, é contratar um fornecedor e deixar a conexão com ele. O caminho direto, sem intermediário, está detalhado abaixo — com os pontos exatos em que a maioria trava.
Adicione ao Google NotíciasNeste artigo
Antes de começar: reúna isto
Metade das reprovações acontece por documento que não bate. Separe antes:
- Um número de telefone elegível. Precisa receber SMS ou ligação e não pode estar ativo em outra conta de API. Número que já está no aplicativo WhatsApp Business só entra por coexistência ou depois de ser desvinculado de lá.
- CNPJ ativo e o nome empresarial exatamente como consta no registro.
- Comprovante no nome da empresa: conta de luz, água, telefone, extrato bancário ou contrato social recente. O endereço precisa bater com o que você vai cadastrar.
- Um e-mail e um perfil do Facebook que serão os administradores. Guarde o acesso: perder essa conta depois é dor de cabeça.
Use um número que não esteja em uso pessoal. Depois de conectado à API, aquele número não volta a funcionar no aplicativo comum — a não ser em coexistência, que exige fornecedor com status de Tech Provider.
Crie o portfólio empresarial
Entre no Gerenciador de Negócios da Meta e crie o portfólio da sua empresa, se ainda não existir. É o cofre onde ficam a Página, a conta de anúncios e, agora, a conta do WhatsApp. Cadastre a razão social correta, o endereço e o e-mail corporativo. Esses dados são os que a verificação vai conferir.
Verifique a empresa
É a etapa mais longa e a que mais reprova. Você envia os documentos e a Meta confere se a empresa existe e se é sua. Costuma levar de alguns dias a duas semanas, e pode voltar pedindo correção.
O que mais derruba:
- Razão social abreviada no cadastro e por extenso no documento, ou o contrário.
- Endereço desatualizado — mudou de sala, de número, de CEP.
- Comprovante em nome do sócio, e não da empresa.
- Documento legível pela metade, foto torta, arquivo cortado.
Antes de enviar, abra o cadastro do portfólio e o documento lado a lado e compare caractere por caractere: razão social, CNPJ e endereço. Divergência de pontuação já é motivo de recusa, e cada reenvio custa dias.
Conecte o número
Aqui o caminho se divide.
Pelo fornecedor
No painel dele existe um botão de conectar. Abre uma janela da Meta, você entra com o Facebook administrador do portfólio, escolhe a conta do WhatsApp e confirma o número. São poucos cliques e não exige mexer em nada técnico. Se o fornecedor for Tech Provider e você quiser manter o número também no aplicativo, é neste momento que a opção de coexistência aparece.
Direto com a Meta
No painel de desenvolvedores, crie um aplicativo do tipo empresarial e adicione o produto do WhatsApp. Depois:
- Associe o aplicativo ao portfólio empresarial que você verificou.
- Adicione o número na conta do WhatsApp e confirme o código recebido por SMS ou ligação.
- Registre o número definindo um PIN de seis dígitos. Anote esse PIN: ele é pedido de novo em qualquer migração futura, e recuperá-lo é burocrático.
- Configure o endereço que vai receber as mensagens e assine os eventos da conta — sem isso você envia, mas não recebe nada de volta.
O erro mais frequente de quem vai direto é achar que terminou ao conseguir enviar a primeira mensagem de teste. Sem assinar os eventos da conta, nenhuma resposta do cliente chega ao seu sistema — e o problema só aparece quando alguém responde e ninguém vê.
Cadastre o nome de exibição
É o nome que o cliente vê no topo da conversa. A Meta aprova ou reprova conforme a relação dele com a sua marca. Nome genérico ou que não tem ligação com a empresa cadastrada é recusado; o mais seguro é usar a marca como ela aparece no site e nas redes.
A aprovação costuma sair em algumas horas. Enquanto não sai, o número funciona exibindo o telefone no lugar do nome.
Crie os modelos de mensagem
Para iniciar conversa com alguém — ou falar com quem não responde há mais de 24 horas — você precisa de um modelo aprovado. Comece pelos três que quase toda operação usa:
- Confirmação de pedido, com número do pedido e valor. Categoria: utilidade.
- Aviso de envio, com código de rastreio. Categoria: utilidade.
- Retomada de atendimento, para reabrir conversa parada. Categoria: utilidade, se não tiver apelo de venda.
Cada modelo passa por revisão, que leva de minutos a algumas horas. Dê sempre um exemplo preenchido para cada campo variável e nunca comece nem termine o texto com uma variável solta — são as duas causas mais comuns de reprovação.
Teste antes de abrir ao público
- Mande um modelo aprovado para o seu próprio celular e confirme que chega com o nome de exibição certo.
- Responda por esse celular e confirme que a mensagem aparece no seu sistema. É o teste que prova que o recebimento está configurado.
- Responda de volta em texto livre, dentro da janela aberta, e veja se sai sem erro.
- Confira no painel se o consumo apareceu na categoria esperada. Modelo que você criou como utilidade e aparece cobrado como marketing foi reclassificado — corrija o texto antes de escalar.
Empresa verificada, número conectado, nome de exibição aprovado, um modelo de utilidade aprovado e o teste de ida e volta funcionando: a operação está pronta para receber clientes de verdade.
Quanto tempo leva cada etapa
| Etapa | Prazo típico | O que atrasa |
|---|---|---|
| Criar o portfólio | Minutos | — |
| Verificação da empresa | Dias a 2 semanas | Documento que não bate com o cadastro |
| Conectar o número | Minutos | Número já em uso em outra conta |
| Nome de exibição | Horas | Nome sem ligação com a marca |
| Aprovar modelo | Minutos a horas | Variável solta, exemplo faltando |
Perguntas frequentes
Como contratar a API oficial do WhatsApp?
Pelo caminho curto, contratando um fornecedor que conecta o seu número em poucos cliques. Pelo caminho direto, criando o portfólio empresarial na Meta, verificando a empresa, criando um aplicativo com o produto do WhatsApp e registrando o número com um PIN de seis dígitos.
Preciso de CNPJ?
Sim. A verificação da empresa é exigida e se baseia em documentos empresariais. Não há caminho para pessoa física na API oficial.
Posso usar o número que já está no WhatsApp Business?
Só por coexistência, que mantém o aplicativo e a API funcionando no mesmo número e depende de um fornecedor com status de Tech Provider. Fora disso, o número precisa ser desvinculado do aplicativo antes de entrar na API.
Quanto custa ativar?
A ativação é gratuita: a Meta não cobra adesão nem mensalidade. O custo aparece depois, por mensagem enviada, e no que o fornecedor cobrar pela plataforma.
Por que minha verificação foi reprovada?
Quase sempre por divergência entre o cadastro e o documento: razão social abreviada de um lado e por extenso do outro, endereço desatualizado ou comprovante no nome do sócio em vez da empresa. Corrija o cadastro antes de reenviar.
Dá para testar antes de verificar a empresa?
Dá. O ambiente de testes da Meta permite enviar para um pequeno conjunto de números cadastrados antes de qualquer verificação — serve para validar a integração, não para atender clientes.
Este tutorial faz parte do guia API oficial do WhatsApp: o que é, quanto custa e como ter. Veja também: Quanto custa a API oficial do WhatsApp: o preço por mensagem · Coexistência no WhatsApp: app e API oficial no mesmo número · API oficial da Meta ou solução não oficial: qual usar no WhatsApp da empresa · WhatsApp Cloud API: o que é e como começar sem servidor · Disparo em massa no WhatsApp: o que a API oficial permite e o que derruba a conta · Meta Tech Provider: o que é e como se tornar um
