> For the complete documentation index, see [llms.txt](https://multiagents.gitbook.io/multiagents-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multiagents.gitbook.io/multiagents-docs/documentacao-de-tools/readme/instagram.md).

# Instagram

Responder mensagens pelo instagram

## Instagram

Responder mensagens e comentários pelo Instagram

#### Índice

1. Pré-requisitos
2. Parte 1 — Converter para conta Instagram Profissional
3. Parte 2 — Vincular Instagram a uma Página do Facebook
4. Parte 3 — Configurar o Meta Business
5. Parte 4 — Ativar mensagens no Instagram
6. Parte 5 — Adicionar a ferramenta no MultiAgents
7. Parte 6 — Conectar via OAuth
8. Como usar a integração
9. Comentários em posts → DM
10. Regra da janela de 24 horas
11. Solução de problemas

***

#### 0. Pré-requisitos

Antes de começar, verifique se você possui tudo listado abaixo:

* [ ] Uma conta no Instagram (que será convertida para conta Profissional, se ainda não for)
* [ ] Uma conta pessoal no Facebook
* [ ] Uma Página do Facebook vinculada ao Instagram (será criada durante o processo, se não existir)
* [ ] Acesso à plataforma MultiAgents com permissão de administrador
* [ ] Acesso ao aplicativo Instagram no celular (para algumas configurações iniciais)

> **⚠️ Requisito crítico:** a integração funciona **exclusivamente** com contas Profissionais (Business ou Creator). Contas pessoais não são compatíveis com a API de mensagens da Meta.

***

#### 1. Converter para Conta Instagram Profissional

**1.1 Acessar as configurações do Instagram**

1. Abra o aplicativo do Instagram no celular
2. Toque na sua foto de perfil (canto inferior direito)
3. Toque no menu (três linhas, canto superior direito)
4. Toque em **"Configurações e privacidade"**

**1.2 Mudar para conta Profissional**

1. Toque em **"Tipo de conta e ferramentas"**
2. Toque em **"Mudar para conta profissional"**
3. Selecione a categoria que melhor descreve seu negócio
4. Escolha entre **Business** ou **Creator**
5. Confirme suas informações de contato

***

#### 2. Vincular Instagram a uma Página do Facebook

**2.1 Vincular pelo Instagram (celular)**

1. Em **"Configurações e privacidade"**, toque em **"Central de Contas"**
2. Toque em **"Perfis"** → **"Adicionar conta"** → Facebook
3. Selecione a Página do Facebook desejada

**2.2 Vincular pelo Facebook**

1. Acesse a Página do Facebook
2. Vá em **"Configurações"** → **"Instagram"**
3. Clique em **"Conectar conta"** e autorize pelo Instagram

**2.3 Criar uma Página (se necessário)**

Se você ainda não tem uma Página, acesse `facebook.com/pages/create` e escolha **"Empresa ou marca"**.

***

#### 3. Configurar o Meta Business

**3.1 Acessar o Meta Business Suite**

1. Acesse `business.facebook.com`
2. Faça login com a conta do Facebook que gerencia a Página

**3.2 Verificar a conexão Instagram**

1. Vá em **"Configurações"** → **"Contas vinculadas"**
2. Confirme que a conta do Instagram aparece conectada

**3.3 Verificar permissões**

1. Vá em **"Configurações do negócio"** → **"Contas"** → **"Contas do Instagram"**
2. Confirme que a conta está listada

> **⚠️ Atenção:** quem for fazer a conexão OAuth precisa ter permissão de **administrador** tanto no Portfólio de Negócios quanto na Página. Sem isso, a conta do Instagram não aparece na hora de selecionar.

***

#### 4. Ativar Mensagens no Instagram

**4.1 Habilitar mensagens (no celular)**

1. Em **"Configurações e privacidade"**, toque em **"Mensagens e respostas de histórias"**
2. Toque em **"Controles de mensagem"**
3. Ative **"Permitir acesso a mensagens"**

**4.2 Habilitar acesso à API de mensagens**

1. Em **"Configurações e privacidade"**, toque em **"Privacidade"** → **"Mensagens"**
2. Toque em **"Ferramentas conectadas"**
3. Ative o acesso

***

#### 5. Adicionar a Ferramenta no MultiAgents

```
https://app.multiagents.pro
```

**5.1 Abrir o Trabalho**

1. Acesse [**https://app.multiagents.pro**](https://app.multiagents.pro) e faça login
2. No menu lateral, vá em **"Trabalhos"**
3. Abra o Trabalho no qual o agente deve atender pelo Instagram

> **📍 Onde a ferramenta mora:** a configuração das ferramentas fica **dentro do Trabalho**, não no cadastro do agente. Cada Trabalho tem suas próprias ferramentas e seus próprios canais.

**5.2 Adicionar a ferramenta Instagram Direct**

```
Trabalhos → [Seu Trabalho] → aba Ferramentas → Adicionar Ferramenta
```

1. Dentro do Trabalho, abra a aba **"Ferramentas"**
2. Clique em **"Adicionar Ferramenta"**
3. Na lista, procure por **"Instagram"**
4. Clique para adicionar

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FP4ZzTubygZbfM2NJvvlo%2Fimage.png?alt=media&amp;token=dd510d73-ef8f-4d57-80eb-83d865195a06" alt=""><figcaption></figcaption></figure>

***

#### 6. Conectar a Ferramenta via OAuth

**6.1 Iniciar a conexão**

1. Clique na ferramenta Instagram Direct para abrir as configurações
2. Clique em **"Conectar com Meta"** — uma janela popup da Meta será aberta

> **⚠️ Bloqueador de popup:** se a janela do OAuth não abrir, permita popups para o domínio `app.multiagents.pro` no seu navegador.

> **💡 Salve antes de conectar.** Se a ferramenta ainda não foi salva, a plataforma avisa: *"Salve a conexão primeiro, depois conecte com Meta."*

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FNUyeQY5w76HDi49ivo5r%2Fimage.png?alt=media&amp;token=8dc2190d-6e5f-4f5f-805a-aaf3e0813991" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FLJuyiSnci0BxjVUOC80E%2Fimage.png?alt=media&amp;token=91d61c50-5491-4b6e-96b9-d9b978f54ef2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FPWAHGFGeyH5Gb5Z3t4DG%2FCaptura%20de%20tela%20de%202026-03-02%2014-20-46.png?alt=media&#x26;token=16796b5e-98eb-4d38-9359-a2428779c97e" alt="" width="433"><figcaption></figcaption></figure>

<div><figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2F58fVoifWu2tAPZvdsSuG%2FCaptura%20de%20tela%20de%202026-03-02%2014-21-40.png?alt=media&#x26;token=f812d69b-aef7-46e8-853b-56cb3e2356ae" alt="" width="433"><figcaption></figcaption></figure> <figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FpyleHwTkeSzQVGgCt8Ms%2FCaptura%20de%20tela%20de%202026-03-02%2014-22-13.png?alt=media&#x26;token=6088429e-fe2b-443a-88b4-f4d91b37bd0d" alt="" width="433"><figcaption></figcaption></figure> <figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FbqhgVkqtMrdwvDqD60kY%2Fimage.png?alt=media&#x26;token=33f7a4ca-2a00-4d37-8cfd-e26779775c37" alt="" width="433"><figcaption></figcaption></figure></div>

<figure><img src="https://3744957929-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsOmzWUgDGQvQAevhZo3I%2Fuploads%2FTud3R3dOU5XA0P3LUvfo%2Fimage.png?alt=media&amp;token=06fc9725-7fe4-4d08-ad2d-4998d1fee5c6" alt=""><figcaption></figcaption></figure>

**6.2 Autorizar no Meta**

Na janela popup:

1. Faça login com a **mesma conta do Facebook** que gerencia a Página vinculada ao Instagram
2. Revise as permissões solicitadas
3. Clique em **"Continuar"** ou **"Permitir"**

**6.3 Selecionar a conta do Instagram**

1. De volta ao MultiAgents, clique em **"Selecionar Conta do Instagram"**
2. Escolha a conta Profissional vinculada à Página
3. Clique em **"Selecionar"**

Depois de conectada, a ferramenta mostra **"Conta Conectada"** e um botão **"Trocar Conta"**, caso precise mudar depois.

> **❌ Nenhuma conta na lista?** A mensagem exibida é: *"Nenhuma conta comercial do Instagram encontrada. Verifique se sua Página do Facebook está vinculada a uma conta comercial do Instagram."* Volte à Parte 2.

**Fluxo completo da conexão**

```
Conectar com Meta → Autorizar no Meta → Selecionar Conta do Instagram → Conectado
```

***

#### 7. Como Usar a Integração

Com a integração configurada, o agente do Trabalho passa a ter:

| Funcionalidade             | Descrição                                                                       |
| -------------------------- | ------------------------------------------------------------------------------- |
| **Receber mensagens**      | Mensagens enviadas ao Direct da conta são recebidas automaticamente pelo agente |
| **Responder mensagens**    | O agente responde com texto dentro da janela de 24 horas                        |
| **Receber mídia**          | Imagens, áudios e stories compartilhados no Direct                              |
| **Enviar imagem**          | O agente envia imagens como resposta                                            |
| **Respostas rápidas**      | O agente oferece botões de resposta rápida                                      |
| **Indicador de digitando** | O agente sinaliza que está escrevendo                                           |
| **Consultar o perfil**     | O agente lê nome e dados públicos de quem escreveu                              |

**7.1 Fluxo de mensagens**

```
Usuário envia DM → Instagram API → MultiAgents processa → Agente responde via Direct
```

**7.2 Tipos de mensagem suportados**

| Tipo   | Enviar | Receber |
| ------ | ------ | ------- |
| Texto  | ✅      | ✅       |
| Imagem | ✅      | ✅       |
| Áudio  | ❌      | ✅       |
| Vídeo  | ❌      | ✅       |

***

#### 8. Comentários em Posts → DM

Além das mensagens diretas, a ferramenta pode **monitorar comentários nos seus posts e iniciar uma conversa privada por DM**, já com o contexto do que a pessoa comentou.

É o que transforma engajamento público em conversa qualificada: quem comenta demonstra interesse, mas antes disso nada acontecia até a pessoa mandar DM por conta própria.

**8.1 Como ativar**

1. Abra a configuração da ferramenta Instagram Direct
2. Localize a seção **"Comentários em Posts"**
3. Ative **"Responder comentários via DM"**

A descrição na própria tela explica o efeito: *"Quando ativado, comentários nos seus posts disparam uma conversa automática por DM privada."*

**8.2 Opções**

| Opção                               | O que faz                                                                             |
| ----------------------------------- | ------------------------------------------------------------------------------------- |
| **Responder comentários via DM**    | Liga ou desliga o monitoramento de comentários                                        |
| **Ignorar respostas a comentários** | Considera apenas comentários de primeiro nível, ignorando respostas dentro de threads |

> **💡 Por que ignorar respostas:** numa thread longa, cada resposta geraria um DM. Com a opção ativada, só o comentário original dispara a conversa.

***

#### 9. Regra da Janela de 24 Horas

> **🚨 Regra fundamental**
>
> O Instagram Direct via API tem uma **janela de 24 horas** imposta pela Meta. Ela determina quando o agente pode responder.

**9.1 Como funciona**

Quando alguém envia uma mensagem ao Direct da sua conta, abre-se uma **janela de 24 horas**:

* O agente pode enviar **texto e imagem** livremente
* Cada nova mensagem da pessoa **reinicia o contador**
* Passadas as 24 horas, a janela **fecha**

**9.2 Linha do tempo**

```
[00:00]          📩 Pessoa envia DM         → Janela ABERTA
[00:00 - 24:00]  ✅ Agente responde          → texto e imagem
[Após 24:00]     🔒 Janela FECHADA           → a pessoa precisa escrever de novo
```

> **⚠️ Não existe mensagem proativa.** Diferente do WhatsApp, não há template para iniciar conversa. Se a janela fechar, o envio falha com o erro *"24h messaging window expired"* e só uma nova mensagem da pessoa reabre a conversa.

**9.3 Boas práticas**

* **Não envie spam:** o Instagram pode restringir contas que mandam mensagem não solicitada
* **Respeite a pessoa:** se ela não responde, não insista
* **Monitore a qualidade:** respostas úteis mantêm o score da conta alto

> **📥 Mensagens de quem não segue** caem em **"Solicitações"** por padrão, e só chegam ao agente depois de aceitas.

***

#### 10. Solução de Problemas

**A conta do Instagram não aparece para selecionar**

* Verifique se a conta é **Profissional** (Business ou Creator)
* Verifique se está **vinculada a uma Página do Facebook**
* Confirme que você está logado com a conta do Facebook que **administra** essa Página
* A vinculação pode levar alguns minutos para propagar

***

**As mensagens não estão chegando**

* Verifique se **"Permitir acesso a mensagens"** está ativado no Instagram
* Confirme que as **"Ferramentas conectadas"** estão habilitadas
* Verifique se a ferramenta mostra **"Conta Conectada"** no MultiAgents
* Teste enviando uma mensagem de outra conta
* Se a pessoa não te segue, veja se a mensagem não está em **"Solicitações"**

***

**O popup do OAuth não abre**

Desabilite o bloqueador de popups para o domínio `app.multiagents.pro`. No Chrome: clique no ícone de popup bloqueado na barra de endereço → Permitir popups.

***

**O agente não responde depois de um tempo**

Provavelmente a **janela de 24 horas** fechou. Confirme a data da última mensagem da pessoa. Só uma nova mensagem dela reabre a conversa — não há como iniciar do nosso lado.

***

**Os comentários não viram DM**

* Confirme que **"Responder comentários via DM"** está ativado na ferramenta
* Verifique se o comentário é de primeiro nível, caso **"Ignorar respostas a comentários"** esteja ativado
* Lembre que o DM disparado também respeita as regras da Meta
