> ## Documentation Index
> Fetch the complete documentation index at: https://docs.base44.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectando o Instagram Business ao seu app

> Configure o conector do Instagram Business, escolha os escopos e use-o em funções de backend para publicar posts, responder comentários e responder mensagens diretas.

Conecte seu app ao Instagram Business para publicar posts no feed, gerenciar comentários e responder mensagens diretas. Você pode usar uma conta compartilhada ou a conta do Instagram de cada pessoa.

> [!NOTE]
>
> Você precisa de um [**plano Builder**](https://base44.com/pricing) ou superior para usar conectores no seu app.

***

## O que você pode fazer

Traga os posts, comentários e mensagens da sua conta do Instagram para os fluxos de trabalho do seu app.

> [card] Publicar posts
>
> Publique fotos, vídeos e carrosséis no seu feed quando algo acontecer no seu app, como a inclusão de um novo produto.

> [card] Gerenciar comentários
>
> Leia, responda e modere comentários nos seus posts, por exemplo quando um comentário inclui uma palavra-chave.

> [card] Responder mensagens diretas
>
> Leia mensagens diretas e responda pelo seu app em até 24 horas após a última mensagem da pessoa.

**Prompts de exemplo**

Descreva no chat de IA o conteúdo, o que dispara a ação e os campos dinâmicos. Por exemplo:

```text wrap theme={null}
Publique automaticamente as fotos de novos produtos no meu feed do Instagram.
```

```text wrap theme={null}
Crie posts em carrossel no Instagram a partir da galeria do meu portfólio.
```

```text wrap theme={null}
Responda aos comentários nos meus posts do Instagram quando palavras-chave forem detectadas.
```

```text wrap theme={null}
Modere automaticamente os comentários nos meus posts do Instagram.
```

```text wrap theme={null}
Mostre no meu app as informações do meu perfil do Instagram Business e os posts recentes do feed.
```

***

## Conectando o Instagram Business

Conecte o Instagram Business para que seu app possa publicar posts, gerenciar comentários e responder mensagens diretas.

> [!TIP]
>
> **Antes de começar:** Conecte com uma conta do Instagram Business ou Creator. Você pode mudar o tipo da sua conta nas configurações do app do Instagram.

> [tab] Conector compartilhado
>
> Você conecta uma conta uma única vez, e todos que usam seu app compartilham essa conexão e os dados dela.
>
> **Para adicionar um conector compartilhado do Instagram Business:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
> 2. Clique em **Adicionar conector**.
> 3. Pesquise **Instagram Business** e clique no resultado.
> 4. Selecione **Conector compartilhado** e clique em **Avançar**.
> 5. Insira um **Nome da conexão**.
> 6. Em **Quem pode acessar**, escolha onde a conexão pode ser usada: **Apps e Super agent** (o padrão), **Apenas apps** ou **Super agent only**.
> 7. (Opcional) Selecione os escopos da conexão em **Permissões**.
> 8. Clique em **Adicionar conector** e entre com a conta do Instagram que você quer compartilhar.

> [tab] Conector de usuário do app
>
> Cada pessoa conecta a própria conta do Instagram, para que seu app possa trabalhar com os posts, comentários e mensagens dela.
>
> > [!TIP]
> >
> > **Antes de começar:** Somente donos e admins do workspace podem configurar um conector de usuário do app, e você precisa do seu próprio cliente OAuth. Veja [Usando seu próprio cliente OAuth](https://docs.base44.com/pt-BR/Integrations/Connectors.md#using-your-own-oauth-client).
>
> **Para adicionar um conector de usuário do app do Instagram Business:**
>
> 1. Clique em **Conectores** na barra lateral do seu workspace.
> 2. Clique em **Adicionar conector**.
> 3. Pesquise **Instagram Business** e clique no resultado.
> 4. Selecione **Conector de usuário do app** e clique em **Avançar**.
> 5. Copie a **Callback URL** e adicione-a às redirect URIs permitidas do seu app do Instagram.
> 6. Insira um **Nome do conector**.
> 7. Insira o **ID do cliente** e o **Segredo do cliente** do seu app do Instagram.
> 8. Revise os escopos em **Escopos** e remova os que seu app não precisa. Veja [Escopos e permissões](#scopes-and-permissions).
> 9. Clique em **Adicionar conector**.
> 10. Abra seu app no editor do app.
> 11. Peça ao chat de IA para adicionar uma forma de as pessoas conectarem a própria conta do Instagram.

***

## Escopos e permissões

Os escopos controlam o que seu app pode fazer no Instagram. Você os escolhe ao configurar um conector.

> [card]
>
> **1. A Base44 adiciona**
>
> Estes escopos são sempre incluídos, então aparecem como escopos bloqueados em **Permissões** em um conector compartilhado ou em **Escopos** em um conector de usuário do app.
>
> * `instagram_business_basic`: Ver informações básicas da conta, como o nome de usuário e as mídias
> * `instagram_business_manage_messages`: Ler e responder mensagens diretas
>
> **2. Você configura**
>
> Selecione os escopos de que seu app precisa em **Permissões** em um conector compartilhado ou em **Escopos** em um conector de usuário do app.
>
> * `instagram_business_content_publish`: Publicar fotos, vídeos e carrosséis no feed
> * `instagram_business_manage_comments`: Ler, responder e moderar comentários nos posts da conta
>
> **Acesso:** Seu app trabalha com a conta do Instagram que autoriza a conexão.

***

## Usando funções de backend

Depois que o Instagram Business está conectado, suas funções de backend podem obter um token de acesso e chamar a Instagram API diretamente. A Base44 cuida do fluxo OAuth e do armazenamento do token.

* Em uma conexão compartilhada, use `getConnection()` para obter o token.
* Em uma conexão de usuário do app, use `getCurrentAppUserConnection()` para que cada requisição use o token da pessoa conectada.

Chame a Instagram API em `graph.instagram.com` e passe o token no parâmetro de consulta `access_token`:

```javascript theme={null}
// Shared connection: one account the whole app uses
const { accessToken } = await base44.asServiceRole.connectors.getConnection("instagram");

const response = await fetch(
  `https://graph.instagram.com/me?fields=id,username&access_token=${accessToken}`,
);
const account = await response.json();
```

> [card] [Conectores compartilhados](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/shared-connectors.md)
>
> Configure, implante e chame uma conexão compartilhada a partir de uma função de backend.

> [card] [Conectores de usuário do app](https://docs.base44.com/pt-BR/developers/backend/resources/connectors/app-user-connectors.md)
>
> Obtenha um token por usuário e chame a API como a pessoa conectada.

***

## Solução de problemas

Verifique a conexão e o momento das suas respostas se o Instagram Business parar de funcionar no seu app.

> [accordion] A conexão precisa ser reconectada
>
> A Base44 renova o acesso ao Instagram em segundo plano. Se o acesso for perdido ou expirar, a conexão mostra **Esta conexão precisa ser reconectada**. [Reconecte-a](https://docs.base44.com/pt-BR/Integrations/Connectors.md#managing-your-connectors) e entre com a mesma conta do Instagram para restaurá-la em todos os apps que a usam.

> [accordion] Uma resposta a uma mensagem direta falha
>
> O Instagram aceita respostas a uma mensagem direta em até 24 horas após a última mensagem da pessoa. Responda dentro desse prazo ou espere a pessoa enviar uma nova mensagem.

> [!NOTE]
>
> Esta página foi traduzida usando IA. Para as informações mais precisas e atualizadas, consulte a [versão em inglês](https://docs.base44.com/index.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.