> 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/facebook-e-instagram-nativo/canal-instagram-nativo-beta.md).

# Canal Instagram Nativo (BETA)

A partir da v3.1.4.7

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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://ajuda.zdg.com.br/facebook-e-instagram-nativo/canal-instagram-nativo-beta.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.