Skip to content

Como aprovar seu App da Meta ​

TIP

Assinante RE9SYS: você já tem acesso ao App compartilhado da RE9WEB 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.

TIP

Material de apoio pronto: descrições de permissões, screencasts e modelos de formulário para o RE9SYS 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 RE9SYS 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.

WARNING

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.

CampoO que preencher
Domínios do aplicativoO domínio onde seu sistema está instalado. Para o RE9SYS: techprovider.com.br
Política de PrivacidadeURL da sua política de privacidade
Termos de ServiçoURL dos seus termos de uso
CategoriaMensagens
Ícone do appImagem 512×512 px — aparece no onboarding para o usuário final
PlataformaAdicione 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á)

TIP

Para o RE9SYS: 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 RE9SYS: 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.

TIP

Para o RE9SYS: 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 RE9SYS.
    • Para configurar por tenant: acesse RE9SYS → 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 RE9SYS 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 RE9SYS sem que o cliente precise sair do sistema.

WARNING

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 RE9SYS 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 RE9SYS (Superadmin → Provedores Globais → Instagram) ou por tenant.
  3. Cole a URL de callback e o token de verificação gerados no RE9SYS.
  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 RE9SYS 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 RE9SYS, cole URL de callback e token, verifique e marque os eventos desejados (messages, message_reads, messaging_referrals, etc.).

TIP

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 RE9SYS 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 RE9SYS 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.

TIP

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 RE9SYS: 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 ​

#EtapaObservação
1Verificações de empresa e atividadeObrigatório para cadastro incorporado e coexistência
2Criar o app no Facebook DevelopersEscolha os 4 casos de uso
3Configurações básicasDomínio, políticas, ícone, instruções de acesso
4Login incorporadoSubdomínio + URIs de redirecionamento
5WhatsApp (WABA)Permissões + webhook + cadastro incorporado
6InstagramPermissões + webhook + redirect URI
7MessengerPermissões + webhook
8Gerenciamento de páginaSó permissões
9Token permanenteGerado no Gerenciador de Negócios
10Publicar o appHabilitar modo produção
11Análise do appDescrições + screencasts + envio para revisão