> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/api-oficial-waba/whatsapp-oficial-cadastro-incorporado-e-coexistencia-com-app-proprio/como-aprovar-seu-app-da-meta.md).

# Como aprovar seu App da Meta

{% hint style="info" %}
**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.
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=opZvh-NKmtQ>" %}

{% hint style="success" %}
**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](https://comunidade.zdg.com.br/geral/app-meta-aprovar/). Copie, cole e adapte para acelerar o processo.
{% endhint %}

***

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

{% hint style="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.
{% endhint %}

***

### Etapa 2 — Criar o aplicativo

1. Acesse [developers.facebook.com](https://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á)

{% hint style="info" %}
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.
{% endhint %}

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.

{% hint style="info" %}
Para o Z-PRO: a lista completa de permissões necessárias está na [página de apoio](https://comunidade.zdg.com.br/geral/app-meta-aprovar/).
{% endhint %}

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

{% hint style="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.
{% endhint %}

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

{% hint style="info" %}
O redirect do Messenger já está coberto pelo **Login Incorporado do Facebook** configurado na Etapa 4 — não é necessário configurar um redirect separado.
{% endhint %}

***

### 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**.

{% hint style="info" %}
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](https://comunidade.zdg.com.br/geral/app-meta-aprovar/). Use-os como base — a Meta pode pedir que você grave na sua própria plataforma.
{% endhint %}

***

### Resumo das etapas

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ajuda.zdg.com.br/api-oficial-waba/whatsapp-oficial-cadastro-incorporado-e-coexistencia-com-app-proprio/como-aprovar-seu-app-da-meta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.