# Facebook Login incorporado (waba/insta/messenger)

## Login do Facebook Incorporado (WABA)

A funcionalidade de **Login do Facebook** permite que seus clientes conectem contas de WhatsApp Business API (WABA) ao Z-PRO de forma simplificada.

Ao configurar seu aplicativo da Meta no Superadmin, o cliente final não precisará gerar tokens manuais. Ele apenas clicará em um botão "Logar com Facebook", aceitará as permissões e selecionará os números disponíveis para criar o canal.

**Vídeo Tutorial:**

{% embed url="<https://www.youtube.com/watch?v=0Whyjg5VHec>" %}

***

### Parte 1: Configuração na Meta (Facebook Developers)

Para que o login funcione, você precisa configurar um aplicativo no painel de desenvolvedores do Facebook.

#### 1. Criar e Configurar o App

1. Acesse [developers.facebook.com](https://developers.facebook.com) e crie um aplicativo do tipo **Empresa (Business)**.
2. No painel do app, vá em **Configurações Básicas** e copie o **ID do Aplicativo** e a **Chave Secreta (App Secret)**. Você precisará deles depois.
3. Adicione o domínio do seu Z-PRO (onde o front-end roda) no campo **Domínios do Aplicativo**.

#### 2. Adicionar o Produto "Login do Facebook"

1. No menu lateral ou em "Adicionar Produto", selecione **Login do Facebook**.
2. Vá em **Configurações** (dentro de Login do Facebook).
3. Ative a opção **Login com o SDK do JavaScript**.
4. Em **Domínios permitidos para o SDK do JavaScript**, insira o domínio do seu painel (ex: `https://app.seusistema.com.br`).
5. **IMPORTANTE:** No campo **URIs de redirecionamento do OAuth**, adicione o caminho do arquivo de embed: `https://app.seusistema.com.br/facebook_embed_signup.html` *(Substitua `app.seusistema.com.br` pelo seu domínio real).*

#### 3. Configurar Permissões e Casos de Uso

Dependendo da versão do painel da Meta, vá em **Revisão do App > Permissões e Recursos** ou **Casos de Uso**. Certifique-se de adicionar e conceder acesso avançado (ou standard para testes) às seguintes permissões:

* `email`
* `public_profile`
* `whatsapp_business_management`
* `business_management`

#### 4. Configuração do Cadastro Incorporado (Embedded Signup)

1. Adicione o produto **WhatsApp** ao seu app.
2. Vá em **Configuração > Cadastro Incorporado**.
3. Crie uma nova configuração (Config ID).
4. Selecione as permissões citadas acima e marque a opção **"Token nunca expira"**.
5. Ao salvar, ele gerará um código de **Config ID**. Copie este número.

#### 5. Gerar Token do Sistema (Business Manager)

1. Acesse o **Gerenciador de Negócios** (Business Manager) vinculado ao app.
2. Vá em **Usuários > Usuários do Sistema**.
3. Adicione um usuário (se não houver) e clique em **Gerar Novo Token**.
4. Selecione o Aplicativo que você criou.
5. Marque as permissões (`whatsapp_business_management`, `business_management`) e gere o token.
6. Copie este token (ele é o Token Permanente do Sistema).

***

### Parte 2: Configuração no Z-PRO (Superadmin)

Agora que você tem os dados da Meta, vamos configurar no seu sistema.

1. Acesse o painel **Superadmin** do Z-PRO.
2. No menu lateral, localize a opção **Apps WABA** (ou Configurações do Facebook).
3. Clique em **Adicionar** e preencha os campos com os dados obtidos na Parte 1:
   * **App ID:** (Copiado da Configuração Básica).
   * **App Secret:** (Copiado da Configuração Básica).
   * **Token:** (Gerado no Business Manager - Usuário do Sistema).
   * **Config ID:** (Gerado no Cadastro Incorporado do WhatsApp).
   * **Versão da API:** Utilize a versão atual (ex: `v21.0` ou a mais recente disponível no seu app Meta).
4. Salve a configuração.

***

### Parte 3: Como o Cliente Utiliza (Tenant)

Com tudo configurado, o processo para o seu cliente é extremamente simples:

1. O cliente acessa o painel da empresa dele (Admin).
2. Vai em **Configurações > Integrações**.
3. Na sessão do Facebook/Meta, ele verá o botão **"Login com Facebook"** (ou "Continuar com Facebook").
4. Ao clicar, abrirá um popup da Meta pedindo autorização.
5. Após autorizar, o sistema listará as contas de WhatsApp Business vinculadas ao usuário.
6. O cliente seleciona a conta e o número desejado.
7. O sistema cria o canal **WABA** automaticamente, pronto para uso.

{% hint style="warning" %}
**Nota sobre Permissões:** Se o cliente encontrar erros ao logar, verifique se o seu Aplicativo na Meta está no modo **"Ao Vivo" (Live)** e se o "Acesso à Empresa" foi concluído. Apps em modo de "Desenvolvimento" só funcionam para administradores do próprio app.
{% endhint %}


---

# Agent Instructions: 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:

```
GET https://ajuda.zdg.com.br/configuracao-superadmin/canais-e-integracoes-superadmin/facebook-login-incorporado-waba-insta-messenger.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.