Como aprovar seu App da Meta

Assinante Z-PRO: você já tem acesso ao App compartilhado da ZDG e pode conectar canais WABA, Instagram e Facebook sem precisar criar o seu próprio app. Este tutorial é para quem deseja ter um App Próprio — seja para isolar a reputação dos canais ou para operar como Tech Provider independente.

Se quiser saber mais sobre a diferença, leia Score do App Tech Provider.

Material de apoio pronto: descrições de permissões, screencasts e modelos de formulário para o Z-PRO estão disponíveis na página de apoio da comunidade. Copie, cole e adapte para acelerar o processo.

---

Pré-requisitos

Antes de começar, garanta que você tem:

• Uma conta de Facebook pessoal (será usada para acessar o Facebook Developers)

• Um Gerenciador de Negócios (BM) da Meta criado e com CNPJ verificado

• O CNPJ da sua empresa em mãos para a verificação de empresa

• URLs de política de privacidade e termos de uso do seu sistema (pode usar as do Z-PRO como referência: ajuda.zdg.com.br)

---

Etapa 1 — Verificações obrigatórias

Duas verificações são necessárias antes de ativar recursos avançados como cadastro incorporado e coexistência. Você pode criar o app primeiro e fazê-las depois, mas recomendamos concluí-las antes de avançar.

Verificação de empresa (CNPJ)

Acesse o seu Gerenciador de Negócios (business.facebook.com) → Configurações do Negócio → Informações do Negócio → inicie a verificação inserindo o CNPJ da empresa.

Verificação de atividade (Tech Provider)

Feita dentro do próprio aplicativo após criá-lo. Você descreve sua atividade — que fornece um sistema de atendimento omnichannel SaaS — e aguarda a aprovação da Meta.

Sem essas duas verificações, funcionalidades como cadastro incorporado (embedded signup) e coexistência não ficam disponíveis. O painel do app mostrará os três selos: Verificação de empresa, Verificação de acesso e Análise do app.

---

Etapa 2 — Criar o aplicativo

1. Acesse developers.facebook.com com sua conta de Facebook.

2. Crie ou acesse sua conta de desenvolvedor.

3. Navegue até Meus Apps → Criar App.

4. Selecione os casos de uso:

   • Interação de Messenger

   • Interação de Instagram

   • Interação de WhatsApp

   • Gerenciamento de conteúdo (gerenciar tudo na sua página)

5. Dê um nome ao app, informe o e-mail de contato do responsável.

6. Selecione a Business Manager associada (com verificação de empresa concluída).

7. Conclua a autenticação (o Authenticator pode ser solicitado) e aguarde a criação.

---

Etapa 3 — Configurações básicas

Acesse Configurações → Básico no painel lateral esquerdo do app.

Campo	O que preencher
Domínios do aplicativo	O domínio onde seu sistema está instalado. Para o Z-PRO: techprovider.com.br
Política de Privacidade	URL da sua política de privacidade
Termos de Serviço	URL dos seus termos de uso
Categoria	Mensagens
Ícone do app	Imagem 512×512 px — aparece no onboarding para o usuário final
Plataforma	Adicione Website com a URL de login do seu sistema

Instruções de acesso para o analista da Meta

No campo de instruções de acesso, informe como o time da Meta pode testar o seu sistema:

• URL de acesso (tela de login)

• E-mail e senha de um usuário de teste criado exclusivamente para eles

• Deixe claro que não há pagamento exigido para acessar

• Informe se há restrição de geolocalização (na maioria dos casos: não há)

Para o Z-PRO: crie um tenant de teste exclusivo para o analista da Meta e forneça um login dedicado. Nunca use credenciais de clientes reais.

Salve as configurações básicas antes de avançar.

---

Etapa 4 — Login incorporado do Facebook

O Login Incorporado (Embedded Login) é o popup que permite ao usuário final conectar suas contas da Meta ao seu sistema.

No painel lateral, acesse Login incorporado do Facebook → Configurações.

1. Habilite Login no navegador incorporado e Logout no navegador incorporado.

2. Em Subdomínios OAuth válidos, insira o domínio onde o seu app roda.

   • Para o Z-PRO: techprovider.com.br

3. Em URIs de redirecionamento do OAuth válidos, insira os endpoints de retorno após o onboarding:

   • https://oauth.techprovider.com.br/waba-signup

   • https://oauth.techprovider.com.br/instagram-signup

   • https://oauth.techprovider.com.br/facebook-signup

   Se você configurou um domínio OAuth customizado, substitua oauth.techprovider.com.br pelo seu subdomínio.

4. Salve as alterações.

---

Etapa 5 — Caso de uso: WhatsApp (WABA)

No painel lateral, acesse WhatsApp → Personalizar.

Permissões

Na aba Permissões e recursos, as permissões básicas (whatsapp_business_messaging, whatsapp_business_management, public_profile) já vêm pré-selecionadas. Adicione as permissões adicionais conforme o uso do seu sistema.

Para o Z-PRO: a lista completa de permissões necessárias está na página de apoio.

Webhook (recebimento de mensagens)

Na aba Configuração:

1. No campo URL de callback, insira a rota de webhook do Z-PRO.

   • Para configurar por tenant: acesse Z-PRO → Configuração → Integrações Meta e copie a rota de webhook do tenant.

   • Para configurar globalmente: use o Provedor Global no Superadmin.

2. No campo Token de verificação, insira o token configurado no Z-PRO para aquele webhook.

3. Clique em Verificar e salvar.

4. Na seção de campos do webhook, marque os eventos que deseja receber (messages, message_deliveries, message_reads, etc.). Se não souber quais, marque todos.

Cadastro incorporado (Embedded Signup)

O cadastro incorporado é o onboarding que permite conectar números WABA pelo painel do Z-PRO sem que o cliente precise sair do sistema.

O botão Começar a usar o cadastro incorporado só fica disponível após as três verificações estarem completas: empresa (CNPJ), acesso (atividade) e análise do app.

Para configurar:

1. Clique em Criar configuração → dê um nome (ex: waba) → salve.

2. O Config ID gerado deve ser inserido no Z-PRO em Superadmin → Redes Sociais e Marketplaces → App WABA.

3. Em Gerenciar lista de permissões de domínio, adicione o mesmo redirect URI configurado no Login Incorporado.

---

Etapa 6 — Caso de uso: Instagram

No painel lateral, acesse Instagram → Personalizar.

Permissões

Adicione as permissões que o seu sistema utilizará (instagram_basic, instagram_business_basic, pages_show_list, etc.).

Webhook

1. Acesse a aba Configuração de API.

2. Configure um webhook via Provedor Global no Z-PRO (Superadmin → Provedores Globais → Instagram) ou por tenant.

3. Cole a URL de callback e o token de verificação gerados no Z-PRO.

4. Clique em Verificar.

5. Marque os campos/eventos que deseja receber.

Redirect URI

Na seção de redirecionamento, adicione:

• https://oauth.techprovider.com.br/instagram-signup (ou seu domínio customizado)

O Z-PRO exibe essa URL ao criar um App WABA no Superadmin — copie diretamente de lá.

---

Etapa 7 — Caso de uso: Messenger

No painel lateral, acesse Messenger → Personalizar.

Permissões

Adicione as permissões necessárias para gerenciar conversas e páginas.

Webhook

Mesmo processo do Instagram: configure via Provedor Global ou por tenant no Z-PRO, cole URL de callback e token, verifique e marque os eventos desejados (messages, message_reads, messaging_referrals, etc.).

O redirect do Messenger já está coberto pelo Login Incorporado do Facebook configurado na Etapa 4 — não é necessário configurar um redirect separado.

---

Etapa 8 — Caso de uso: Gerenciamento de página

No painel lateral, acesse Gerenciamento de conteúdo → Personalizar.

Neste caso de uso, a configuração é apenas de permissões — não há webhook próprio. Adicione as permissões que o seu sistema utilizará para gerenciar posts, comentários, engajamento e metadados de páginas.

---

Etapa 9 — Gerar token permanente de sistema

O token permanente é necessário para autenticar as chamadas de API do Z-PRO com a Meta.

1. Acesse seu Gerenciador de Negócios (business.facebook.com).

2. Vá em Configurações do Negócio → Usuários → Usuários do Sistema.

3. Crie um Usuário do Sistema do tipo Admin (ex: token).

4. Atribua o aplicativo criado a esse usuário (aba Apps → Atribuir apps → selecione o seu app e marque Gerenciar app).

5. Clique em Gerar novo token → selecione o app → marque todas as permissões necessárias → gere e copie o token.

Este token vai no campo Token permanente de acesso no Z-PRO em Superadmin → Redes Sociais e Marketplaces → App WABA.

---

Etapa 10 — Publicar o app

Antes de submeter para análise, o app precisa ser publicado (modo produção).

No painel do app, acesse Publicação do app e habilite o modo de produção. O botão só fica disponível após as configurações básicas (domínio, política de privacidade, termos e plataforma) estarem preenchidas.

---

Etapa 11 — Análise do app (aprovação da Meta)

Esta é a etapa final e mais delicada. A Meta revisa todas as permissões solicitadas.

No painel lateral, acesse Análise do app.

Passo a passo da análise

1. Clique em Iniciar análise.

2. Para cada permissão listada, clique em Começar e preencha:

   • Descrição de uso: explique como e por que sua plataforma utiliza aquela permissão.

   • Screencast: grave um vídeo mostrando a funcionalidade em uso no seu sistema.

   • Chamadas de API (quando exigido): algumas permissões requerem chamadas de teste reais. Use o explorador de API da Meta ou uma IA para gerar as chamadas via cURL.

3. Preencha a seção Tratamento de dados:

   • Você tem operadores com acesso a dados? (geralmente: Não)

   • Quem é o responsável pelos dados? (nome, CPF, país)

   • Você compartilhou dados por exigência de segurança nacional? (geralmente: Não)

4. Preencha a seção Instruções para o analista (mesmas informações da Etapa 3 — login de teste, URL, sem pagamento).

5. Quando todas as seções estiverem verdes, clique em Enviar para análise.

O prazo médio de análise é de 10 dias úteis. A Meta pode aprovar, reprovar ou solicitar ajustes. Se solicitar ajustes, corrija o que foi apontado e reenvie.

Para o Z-PRO: as descrições e screencasts prontos estão na página de apoio. Use-os como base — a Meta pode pedir que você grave na sua própria plataforma.

---

Resumo das etapas

#	Etapa	Observação
1	Verificações de empresa e atividade	Obrigatório para cadastro incorporado e coexistência
2	Criar o app no Facebook Developers	Escolha os 4 casos de uso
3	Configurações básicas	Domínio, políticas, ícone, instruções de acesso
4	Login incorporado	Subdomínio + URIs de redirecionamento
5	WhatsApp (WABA)	Permissões + webhook + cadastro incorporado
6	Instagram	Permissões + webhook + redirect URI
7	Messenger	Permissões + webhook
8	Gerenciamento de página	Só permissões
9	Token permanente	Gerado no Gerenciador de Negócios
10	Publicar o app	Habilitar modo produção
11	Análise do app	Descrições + screencasts + envio para revisão