Resposta rápida (TL;DR)
Obter a API oficial do WhatsApp exige, na ordem: um portfólio de negócios na Meta, uma conta de WhatsApp Business dentro dele, um número elegível (de sua propriedade, com código de país e de área, capaz de receber SMS ou chamada de voz, e que não esteja ativo no aplicativo WhatsApp), um nome de exibição, um PIN de verificação em duas etapas e a chamada final ao endpoint de registro. Adicionar o número pelo Gerenciador do WhatsApp comprova a posse, mas não conclui o registro. O número só envia e recebe quando o status fica CONNECTED. A verificação da empresa é o que libera até 20 números e até 6.000 modelos por conta.
O que precisa existir antes de começar
Três recursos precedem qualquer etapa técnica. O portfólio de negócios é o contêiner de todos os ativos da empresa na Meta e é obrigatório para usar a plataforma. Dentro dele fica a conta de WhatsApp Business, que guarda os metadados, os números e os modelos de mensagem. E fica o número de negócio, real ou virtual, que envia e recebe as mensagens.
Vale saber desde já: portfólio recém-criado é limitado a dois números registrados. Esse teto sobe automaticamente para 20 quando a empresa é verificada ou quando o limite de mensagens do portfólio chega a 2.000.
Passo a passo do começo ao primeiro envio
- Criar o portfólio de negócios na Meta, com dados cadastrais reais da empresa.
- Criar a conta de WhatsApp Business dentro do portfólio, pelo Meta Business Suite ou pelo painel do aplicativo de desenvolvedor.
- Escolher o caminho de conexão: contratar um provedor, que entrega a interface de atendimento junto e usa o fluxo de Embedded Signup, ou conectar direto na Cloud API, o que exige time técnico.
- Adicionar o número pelo Gerenciador do WhatsApp, pelo Meta Business Suite, pelo painel do aplicativo ou pelo Embedded Signup do provedor.
- Verificar a posse do número com o código recebido por SMS ou por chamada de voz.
- Definir o nome de exibição e o PIN de verificação em duas etapas, ambos obrigatórios no registro.
- Registrar o número na Cloud API. Este é o passo que a maioria esquece: adicionar o número pelos painéis comprova a posse, mas não conclui o registro. É preciso chamar o endpoint de registro para o número ficar utilizável.
- Criar os primeiros modelos de mensagem e esperar a aprovação, que sai em até 24 horas.
Só depois disso o número passa ao status CONNECTED, que é a condição exigida pela Meta para enviar e receber mensagens pela API.
Qual número é elegível
A documentação lista quatro requisitos: o número precisa ser de sua propriedade, ter código de país e de área (códigos curtos não são aceitos), conseguir receber chamada de voz ou SMS e ter capacidades escaladas habilitadas. Além disso, um número já em uso no WhatsApp não pode ser registrado sem que a conta dele seja apagada antes, e um número banido precisa ser desbanido por recurso antes de qualquer tentativa.
O tipo de linha muda a chance de a verificação passar de primeira:
| Tipo de linha | Código por SMS | Código por voz | Observação |
|---|---|---|---|
| Móvel | Padrão | Padrão | Opção recomendada pela Meta |
| Fixa | Não recomendado | Padrão | Desligar desvio de chamada e URA antes |
| VoIP | Não recomendado | Padrão | Confirmar com o provedor o recebimento internacional |
| 0800 e gratuitas | Não recomendado | Padrão | A chamada de registro não navega por URA |
No caso de número atrás de URA, a Meta informa de qual número a ligação de registro vai partir para que a empresa crie uma lista de permissão e redirecione a chamada a uma pessoa capaz de anotar o código. Linha atrás de URA que não consegue receber a ligação de registro não é suportada.
Verificação da empresa: o que ela realmente destrava
Verificar a empresa é o envio de documentos que comprovam a existência jurídica do negócio. Ela não é obrigatória para o primeiro envio, mas é o gargalo real de quem quer operar de verdade, porque destrava três coisas ao mesmo tempo: o caminho para o limite de 2.000 destinatários por 24 horas, o aumento do teto de números registrados de dois para 20 e a subida do teto de modelos de 250 para 6.000 por conta de WhatsApp Business.
Existe uma alternativa oficial: quem foi integrado por um provedor pode ter a verificação conduzida por ele. E existe um caminho sem documento nenhum, que é entregar 2.000 mensagens fora da janela de atendimento para números únicos em 30 dias usando modelos com nota alta de qualidade. Os três caminhos levam ao mesmo lugar, como detalha o guia sobre limites da API oficial do WhatsApp.
Nome de exibição: a etapa que mais atrasa
O nome de exibição é o texto que aparece no perfil do número e, em certas condições, no topo da conversa e na lista de conversas. Ele é obrigatório no registro e segue as diretrizes de nomes da Meta.
Dois detalhes pouco conhecidos governam essa etapa. Primeiro, a verificação do nome dispara automaticamente quando o número alcança um limite de mensagens maior, e o resultado chega por webhook e notificação, deixando o campo de status como APPROVED ou DECLINED. Segundo, depois que uma alteração de nome é aprovada, a empresa tem 14 dias para registrar o número de novo. Se a janela de 14 dias passar, o nome precisa ser submetido a análise outra vez. O nome pode ser alterado até 10 vezes a cada 30 dias.
Prazos reais e o que trava cada etapa
| Etapa | O que costuma travar | Sinal de que travou |
|---|---|---|
| Verificação do número | Linha fixa, VoIP ou URA que não entrega o código | Código nunca chega por SMS |
| Registro na Cloud API | Achar que adicionar o número já registra | Status diferente de CONNECTED |
| Nome de exibição | Nome fora das diretrizes da Meta | Status DECLINED no número |
| Verificação da empresa | Documento que não bate com o cadastro do portfólio | Pedido devolvido pedindo mais informação |
| Primeiro modelo | Falta de exemplo nas variáveis ou categoria errada | Modelo volta como rejeitado |
A parte técnica raramente é o gargalo. O que segura o cronograma é documentação da empresa e aprovação de nome. Quando a análise da elegibilidade para escalar é negada, a Meta envia um alerta indicando o caminho alternativo a seguir, em vez de simplesmente recusar.
Como testar antes de valer para valer
Ao concluir o início rápido da Cloud API, a Meta cria automaticamente uma conta de WhatsApp Business de teste e um número de teste já registrado. Esses recursos têm limites relaxados e não exigem meio de pagamento cadastrado para enviar modelos, o que permite validar integração, webhook e formato de mensagem antes de comprometer o número real do negócio.
Erros comuns na contratação
- Usar o número principal sem plano de saída. Ao registrar, ele deixa de funcionar no aplicativo WhatsApp e o histórico do aparelho não migra.
- Parar no cadastro do número. Sem a chamada de registro, o número nunca fica CONNECTED.
- Deixar a verificação da empresa para depois. Sem ela, o teto fica em dois números e 250 modelos.
- Perder a janela de 14 dias após a aprovação do nome de exibição, o que obriga a submeter tudo de novo.
- Subir modelos sem exemplo de variável. Modelo com variável exige valor de exemplo, e o recurso contra a rejeição também exige. O checklist está em como aprovar um modelo de mensagem no WhatsApp.
- Enviar antes de ter opt-in. A política da Meta exige consentimento antes de qualquer modelo, e o consentimento precisa deixar claro o nome da empresa.
Perguntas frequentes (FAQ)
Como faço para conseguir a API oficial do WhatsApp para minha empresa?
Crie um portfólio de negócios na Meta, abra uma conta de WhatsApp Business dentro dele, escolha entre um provedor ou a conexão direta pela Cloud API, adicione um número elegível, verifique a posse por SMS ou chamada, defina nome de exibição e PIN de duas etapas e chame o endpoint de registro. Só então o número fica com status CONNECTED e passa a enviar e receber mensagens.
Qual número posso usar na API oficial do WhatsApp?
Precisa ser um número de sua propriedade, com código de país e de área, capaz de receber SMS ou chamada de voz e com capacidades escaladas habilitadas. Códigos curtos não são aceitos. Linha móvel é a recomendação da Meta: fixa, VoIP e 0800 recebem código por voz, mas não são recomendadas para SMS. Número já ativo no aplicativo WhatsApp precisa ter a conta apagada antes.
Preciso verificar minha empresa na Meta para usar a API?
Não para o primeiro envio, mas sim para operar em escala. A verificação da empresa destrava o caminho até 2.000 destinatários por 24 horas, aumenta o teto de números registrados de dois para 20 e eleva o limite de modelos de 250 para 6.000 por conta. Quem foi integrado por um provedor pode ter a verificação conduzida por ele.
Quanto tempo demora para liberar a API oficial do WhatsApp?
A parte técnica é rápida, e a análise de um modelo de mensagem sai em até 24 horas. O que define o cronograma real é a verificação da empresa e a aprovação do nome de exibição, que dependem de documentação e análise da Meta. Vale reservar folga: depois que uma mudança de nome é aprovada, você tem 14 dias para registrar o número de novo.
Dá para testar a API do WhatsApp antes de usar o número da empresa?
Sim. Ao concluir o início rápido da Cloud API, a Meta cria automaticamente uma conta de WhatsApp Business de teste e um número de teste já registrado. Eles têm limites relaxados e não exigem meio de pagamento cadastrado para enviar modelos, o que permite validar integração, webhook e formato de mensagem antes de comprometer o número real do negócio.
Continue lendo
- API oficial do WhatsApp: guia completo
- API oficial x aplicativo WhatsApp Business
- Como migrar para a API oficial do WhatsApp
Histórico de revisões
- 2026-07-27 · v1.0 · publicação inicial.
Sobre as marcas mencionadas
Este portal cita marcas de terceiros para fins editoriais e comparativos. Todas as marcas são propriedade de seus respectivos donos e não possuem vínculo formal com este site. Os dados apresentados foram coletados de fontes públicas e podem mudar. Em caso de erro factual, escreva para contato@botaihub.com.br.