# Canal Instagram Nativo (BETA)

A integração nativa do Instagram permite conectar o **Instagram Direct** diretamente ao Z-PRO através da API Oficial da Meta.

Diferente de emuladores ou automações de tela, esta conexão é oficial, oferecendo maior estabilidade e segurança contra bloqueios.

{% hint style="warning" %}
**Funcionalidade em BETA** Este recurso está em fase de testes. Siga os passos abaixo atentamente para configurar as permissões no seu aplicativo do Facebook.
{% endhint %}

{% embed url="<https://www.loom.com/share/6ece54ce3410460c81a16fa89f33f40d>" %}

{% embed url="<https://www.loom.com/share/837bdedc497243cf9ea890cc39159aab>" %}

***

### Parte 1: Configuração no Facebook Developers

Para utilizar o Instagram Nativo, você deve editar o mesmo Aplicativo (App) que você já utiliza para o WhatsApp (WABA) ou criar um novo.

1. Acesse [developers.facebook.com](https://developers.facebook.com) e selecione o seu App.
2. No menu lateral, vá em **Casos de Uso** (ou *Use Cases*).
3. Clique em **Adicionar** (ou *Edit*) e procure pela opção relacionada a **Gerenciar mensagens de conteúdo no Instagram** (Instagram Message Management).
4. Adicione este caso de uso ao seu aplicativo.
5. **Configurações de Login:**
   * Verifique a seção **"Configurações de Login da Empresa"**.
   * Certifique-se de que a URL de callback (a mesma usada para o WABA) esteja salva corretamente.

#### Permissões Necessárias

Ao adicionar o caso de uso, o sistema solicitará permissões. Certifique-se de adicionar:

* `instagram_basic`
* `instagram_manage_messages`
* `pages_manage_metadata`
* `pages_show_list` (geralmente necessárias para listar as páginas vinculadas ao Instagram).

***

### Parte 2: Atualizar o Token (Gerenciador de Negócios)

Como adicionamos novas permissões (Instagram) a um aplicativo que antes só tinha WhatsApp, o **Token antigo não funcionará**. É obrigatório gerar um novo.

1. Acesse o **Gerenciador de Negócios** (Business Manager).
2. Vá em **Usuários do Sistema**.
3. Clique em **Gerar Novo Token**.
4. Selecione o Aplicativo que você configurou na Parte 1.
5. **Importante:** Na lista de permissões, agora aparecerão as novas opções do Instagram que você ativou. **Marque todas as permissões de Instagram** disponíveis, além das permissões de WhatsApp e Business Management que já usava.
6. Gere o Token e copie-o.

***

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

1. Acesse o painel **Superadmin** do Z-PRO.
2. Vá até as configurações do **App WABA** (onde você configurou o login do Facebook).
3. Você notará que agora existe uma seção específica para **Configuração do Instagram**.
4. Preencha os campos:
   * **App ID:** O ID do aplicativo (o mesmo do WABA).
   * **App Secret:** O segredo do aplicativo (se houver campo específico ou usar o geral).
   * **Token:** Cole aqui o **NOVO Token** que você gerou na Parte 2 (que contém as permissões de Instagram).
5. Salve as alterações.

***

### Parte 4: Conectando no Painel do Cliente

Após o Superadmin realizar a configuração técnica, o cliente final pode conectar a conta facilmente.

1. Acesse o painel da empresa (Tenant).
2. Vá em **Conexões** (ou Canais).
3. Clique em **Adicionar** e escolha a opção **Instagram**.
4. Você verá um botão para **Login com Instagram** (ou Facebook).
5. Ao clicar, uma janela da Meta se abrirá solicitando permissão para acessar a conta do Instagram Business vinculada à Página do Facebook.
6. Após autorizar, selecione a conta desejada e o canal será criado no Z-PRO.

{% hint style="info" %}
**Pré-requisito da Conta:** Para que funcione, a conta do Instagram do cliente deve ser uma **Conta Comercial (Business)** e estar obrigatoriamente vinculada a uma **Página do Facebook**.
{% 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/facebook-e-instagram-nativo/canal-instagram-nativo-beta.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.