Alexgub84/meta-whatsapp-cloud-api

O que meta-whatsapp-cloud-api faz?

Este procedimento foi testado pela última vez no Meta Business Suite e no console de desenvolvedor reais em 2026-11-08. A Meta altera essas telas, nomes de campos e fluxos de assistente com frequência e sem aviso prévio — se alguma etapa abaixo não corresponder ao que você vê, abra uma issue neste repositório em vez de adivinhar, e envie um PR com a correção se encontrar uma.

Nunca

• Reenviar uma verificação rejeitada no mesmo dia da rejeição. Corrija o problema real, aguarde 24 horas e então envie. Tentativas no mesmo dia tendem a ser sinalizadas para uma revisão ainda mais longa.
• Adivinhar ou "limpar" o nome legal, endereço ou número de telefone inseridos nas informações da empresa. Copie-os caractere por caractere do documento que será enviado para comprová-los.
• Tratar um status pending de longa duração como "a Meta está apenas lenta" sem verificar novamente o campo de status real (veja §2). Ele pode silenciosamente se tornar "precisa de mais informações", e o e-mail de notificação tende a cair em uma caixa de entrada que ninguém monitora ativamente.
• Oferecer um certificado de registro fiscal de profissional liberal como prova de nome legal ou endereço, se o equivalente da jurisdição local não estiver na lista de documentos aceitos da Meta para esse fim — veja o exemplo prático na §1. A Meta afirma claramente quando um documento "não é um tipo aceito"; leia essa mensagem em vez de assumir que um documento local conhecido será aceito por ser oficial.
• Enviar com o nome legal da empresa ausente da página inicial real do site. A Meta busca /, e não uma página Sobre ou Termos, e falha na verificação especificamente por isso se o nome não estiver lá.
• Adicionar colaboradores externos como usuários completos do portfólio apenas para obter ajuda com uma tarefa. Esse é um motivo explícito de rejeição na própria lista da Meta — use um nível de acesso mais restrito de parceiro/colaborador.
• Digitar um código de verificação, um PIN de duas etapas ou qualquer senha em qualquer lugar que não seja o console da Meta, digitado pelo titular da conta.

1. Verificação de negócio

O que a verificação é, e não é

A verificação de negócio no Meta Business Suite é uma coisa diferente da assinatura paga Meta Verified, e não produz um selo verificado. A Meta afirma isso diretamente: "Verificar sua empresa no Meta Business Suite é diferente do Meta Verified para empresas e não lhe dará um selo verificado." (Central de Ajuda do Meta Business, "Como verificar sua empresa no Meta Business Suite", https://www.facebook.com/business/help/2058515294227817, lido em 2026-11-09 — a mesma frase é repetida em https://www.facebook.com/business/help/2342133782492969, lido em 2026-11-09). O selo verificado é especificamente um benefício do Meta Verified: "O Meta Verified para empresas é uma assinatura paga que fornece ferramentas para ajudá-lo a construir mais confiança com novos públicos e proteger sua marca. Esta assinatura vem com benefícios como o selo verificado, suporte aprimorado, proteção contra falsificação e muito mais." (https://www.facebook.com/business/help/308979828303560, lido em 2026-11-09). O Meta Verified é cobrado de forma recorrente e é uma compra separada do procedimento de verificação gratuito que este skill cobre.

O que a verificação de negócio realmente desbloqueia, nas próprias palavras da Meta: "A verificação de empresa é necessária para acessar certos recursos de publicidade, desenvolvedor, faturamento e gastos." (https://www.facebook.com/business/help/2058515294227817, lido em 2026-11-09). Detalhado em https://www.facebook.com/business/help/1095661473946872 (lido em 2026-11-09): o limite de gastos diário, recursos elegíveis de desenvolvedor, acesso a Parceiros de Negócios da Meta, o Índice de Páginas de Notícias, a Plataforma WhatsApp Business, transparência de Página, agências baseadas na China e o status de anunciante de serviços financeiros. Para a Plataforma WhatsApp Business especificamente, a mesma página diz: "Empresas que usam a Plataforma WhatsApp Business podem precisar concluir a verificação para acessar certos recursos." Do lado do desenvolvedor: "O Acesso Avançado agora requer Verificação de Empresa... Os aplicativos que solicitam acesso avançado para permissões e aplicativos que permitem que outras empresas acessem seus próprios dados devem estar conectados a uma empresa que tenha concluído a Verificação de Empresa." (https://developers.facebook.com/docs/development/release/business-verification/, lido em 2026-11-09).

Verificado e não encontrado em nenhuma das páginas acima, ou na página de escalonamento de conta da Meta para WhatsApp (https://www.facebook.com/business/help/595597942906808, lido em 2026-11-09): qualquer declaração da Meta sobre quantas vezes reenviar antes de parar, ou conselho para corrigir documentos na raiz em vez de reenviar novamente. Esse conselho é comum em blogs de agências terceirizadas, mas a Meta não o diz em nenhum lugar verificado para este skill, então não é repetido aqui como fato. A lista "Nunca" abaixo se limita ao que as próprias páginas da Meta suportam: uma regra de tempo, não uma contagem.

Escolhendo o conjunto de documentos certo

As categorias de documentos aceitos pela Meta (lidas diretamente de sua caixa de diálogo "Detalhes e próximas etapas", que só aparece depois que uma tentativa de verificação foi realmente executada):

Comprova	Tipos aceitos
Nome legal da empresa	Certificado/Contrato Social, licença ou alvará comercial, extrato bancário ou carta bancária
Endereço	Os mesmos quatro, mais uma conta de serviço público — água, gás, eletricidade ou telefone

Para uma empresa registrada, o certificado de incorporação geralmente é o documento único mais limpo. Para um profissional liberal sem registro de empresa, muitas vezes não há um equivalente exato — não presuma que o certificado genérico de registro fiscal para pequenas empresas da jurisdição conta, mesmo que pareça o documento óbvio. Exemplo prático (Israel): o certificado de עוסק פטור/עוסק מורשה de um profissional liberal israelense é explicitamente rejeitado pela Meta ("não é um tipo aceito"), mesmo sendo a prova padrão de status comercial legal em Israel. O que funcionou foi uma carta de titularidade de conta bancária para o nome legal (a maioria dos bancos pode emitir uma mediante solicitação, especificamente para verificação de negócio) mais uma conta de serviço público para o endereço — um documento de cada uma das duas categorias aceitas, cada um imprimindo o nome ou endereço exatamente como inserido nas informações da empresa.

Regras gerais que valem independentemente da jurisdição:

• Um único documento que contenha o nome e o endereço completos e claramente satisfaz ambos os requisitos em um único upload.
• Hebraico, ou qualquer outro alfabeto não latino, é aceito como está — sem necessidade de tradução — mas escolha um idioma para nome/endereço e use-o consistentemente nas informações da empresa, na página inicial do site e nos próprios documentos.
• Rejeitar, à primeira vista, como não valendo a pena tentar: contratos de locação, uma conta pessoal (não comercial), uma captura de tela de uma página de portal, qualquer coisa cortada, anotada ou editada de outra forma, e qualquer documento com mais de cerca de 90 dias, exceto papéis de registro formais.
• Uma renderização fiel de página inteira de um formato de arquivo para outro (PDF para um PNG de alta resolução, por exemplo) é aceitável; cortar ou redigitar qualquer parte não é.

Preparando o portfólio antes de enviar

• Os campos de informações da empresa devem espelhar exatamente o documento enviado, incluindo pontuação e sufixos legais (um sufixo de empresa como "Ltda" aparece em ambos os lugares ou em nenhum). Decida em qual idioma padronizar e use-o em todos os lugares.
• O site deve estar acessível, servir HTTPS, não mostrar nenhum erro ou estado "em construção" em nenhuma página e — isso é verificado separadamente e falha independentemente da acessibilidade — mostrar o nome legal exato na página inicial especificamente. Um domínio registrado muito recentemente também tem maior probabilidade de levantar suspeitas; um domínio com algum tempo de existência se sai melhor.
• O e-mail comercial deve estar no mesmo domínio do site. Um domínio de e-mail gratuito para consumidor aumenta mensuravelmente a taxa de rejeição e retarda a revisão quando não é o caso.
• Escolha uma categoria de listagem que corresponda honestamente ao negócio — uma categoria sensível (finanças, saúde, jogos de azar, álcool) atrai escrutínio extra e documentos adicionais exigidos.
• Dois administradores no portfólio com autenticação de dois fatores ativada em ambos tende a reduzir o atrito; um único administrador desprotegido é por si só listado como um gatilho de rejeição.
• Qualquer ativo que precise ser verificado (geralmente uma WABA) já deve estar anexado ao portfólio antes de começar — caso contrário, o próprio ponto de entrada de verificação fica acinzentado como "não elegível".

Se o site continuar falhando em sua própria verificação mesmo depois que o acima for corrigido, a Meta documenta duas maneiras alternativas de confirmar a identidade da empresa em vez de um site funcional: um e-mail de confirmação em um domínio diferente genuinamente associado à empresa, ou confirmar pelo número de telefone comercial.

O canal de confirmação altera quais documentos você precisa

Qualquer que seja o canal de confirmação escolhido durante o assistente, muda o que a etapa de upload realmente solicita:

• Canal de ligação telefônica, SMS ou mensagem do WhatsApp → o assistente então solicita documentos comprovando o nome legal e um número de telefone.
• Canal de e-mail → o assistente solicita documentos comprovando o nome legal e um endereço ou número de telefone.

Portanto, escolha o canal para coincidir com os documentos que são realmente mais fáceis de obter, e não o contrário — se uma carta bancária e uma conta de serviço público estão disponíveis, escolha e-mail.

Enviando

Vá para o ponto de entrada de verificação (Central de Segurança, no layout atual da Meta), escolha o caso de uso que corresponde ao que está sendo verificado (geralmente há uma opção separada especificamente para configurar uma conta comercial do WhatsApp — prefira essa em vez de uma opção genérica de "permissões de aplicativo" se ambas existirem) e siga o assistente: país, tipo de empresa (um profissional liberal não registrado geralmente é "Empresário Individual", e muitas vezes ainda é respondido como "Registrado" se a autoridade fiscal local emitiu algum número de registro para ele, mesmo sem uma empresa formal), detalhes da empresa, um CAPTCHA (sempre concluído por um humano, nunca por um agente automatizado), uma etapa de correspondência de registros públicos, o canal de confirmação, upload de documento e uma etapa final de revisão/envio.

Duas armadilhas que valem a pena esperar nessa etapa de registros públicos e na etapa de upload:

• A Meta pode oferecer uma correspondência de registros públicos que parece plausível, mas pertence a uma entidade diferente e não relacionada com um nome semelhante. Verifique cada detalhe de identificação (endereço, domínio, qualquer número fiscal ou de registro mostrado) antes de aceitar uma correspondência — reivindicar o registro comercial de outra pessoa é uma violação de política que pode restringir todo o portfólio, não apenas falhar nesta verificação específica. Em caso de dúvida, escolha "minha empresa não está listada".
• Algumas etapas de upload de documento têm por padrão uma alternância fácil de ignorar ("seu documento incluía seu número de telefone ou endereço?") para "Não", o que então exige um segundo documento completamente separado que a maioria dos candidatos não tem à mão. Se o único documento já enviado contém ambas as informações, mude essa alternância para "Sim" e a etapa extra desaparece.

Após o envio, espere aproximadamente 1-2 dias úteis para uma submissão verificada por canal e 3-7 (até 14 durante as janelas periódicas de atualização de política da Meta) para uma baseada em documentos. Não mexa na submissão enquanto ela estiver "pendente" — não adicione administradores, mude configurações ou abra um tópico de suporte por capricho; nada disso acelera uma revisão em fila, e qualquer coisa que crie uma divergência com o que foi enviado só pode prejudicar.

Monitorando "precisa de mais informações" sem depender de e-mail

A notificação da Meta sobre uma mudança de status vai para o endereço de e-mail definido como contato de administrador do portfólio — que muitas vezes não é a caixa de entrada que alguém verifica diariamente. A única maneira confiável e sem navegador de verificar é uma chamada de API direta, uma vez que qualquer acesso à API já exista:

curl -s "https://graph.facebook.com/v21.0/$WABA_ID?fields=business_verification_status" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

Valores vistos na prática: pending (vez da Meta, nada a fazer além de esperar), pending_need_more_info (sua vez — vá ler exatamente o que está sendo solicitado no console, que este campo sozinho não diz), e verified. Consulte isso periodicamente em vez de esperar ser notificado — a lacuna entre um status que silenciosamente muda para "precisa de mais informações" e alguém realmente perceber já custou a submissões reais um ciclo completo de revisão.

2. Colocando a Cloud API em funcionamento (funciona antes da verificação também)

Cada etapa abaixo funciona em um portfólio não verificado — a verificação apenas altera o teto de volume de mensagens, não se a própria API funciona. Configure as duas coisas em paralelo em vez de esperar uma antes de começar a outra. Um portfólio de negócios já deve existir (criado em business.facebook.com) antes da etapa 1 — a etapa abaixo anexa um novo aplicativo a esse portfólio existente, não cria um novo.

1. Crie o aplicativo. No console de desenvolvedor, crie um aplicativo usando o caso de uso focado em WhatsApp ("conecte-se com clientes através do WhatsApp", ou o equivalente no que o console atual chamar) e anexe-o ao portfólio de negócios existente — nunca crie um novo portfólio para isso, o que reiniciaria a verificação do zero.
2. Anexe ou crie uma Conta Comercial do WhatsApp (WABA). O painel de configuração do WhatsApp do aplicativo se conecta a uma WABA existente ou cria uma nova. Registre o ID da WABA e o ID do número de telefone de teste em algum lugar durável.
3. Experimente primeiro o número de teste emitido pela Meta. É gratuito por um período de teste limitado, suporta alguns números de destinatários pré-aprovados (cada um precisa de um código único para ser colocado na lista de permissões) e é a maneira mais rápida de provar que o webhook e o código de envio de mensagens funcionam antes de envolver um SIM real.
4. Gere um token de acesso de usuário do sistema, não um token de usuário temporário. Um usuário do sistema com a função certa, atribuído ao aplicativo com acesso de gerenciamento, pode gerar um token sem expiração — as permissões necessárias são geralmente os escopos de gerenciamento de mensagens e WABA; um escopo mais amplo de gerenciamento de negócios também é necessário se a integração algum dia for ler o status de verificação ou excluir uma WABA via API em vez do console. Tokens temporários do quick-star

...

[truncated for translation]