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

# Instagram via Instagram Business Login

> Configure a integração do Instagram usando a autenticação do Instagram Business Login (método recomendado)

<Note>
  Por favor, certifique-se de ter instalado a versão v4.1 ou superior. Se não, por favor consulte este [guia](./instagram-channel-setup) para o método de Login do Facebook.
</Note>

## Pré-requisitos

1. Uma conta válida no Facebook.
2. Uma conta profissional válida no Instagram.

## Registrar um Aplicativo no Facebook

Para usar o Canal do Instagram, você deve criar um aplicativo do Facebook no portal de desenvolvedores. Você pode encontrar mais detalhes sobre como criar aplicativos do Facebook [aqui](./facebook-channel-setup).

1. Clique no botão "Create App" (Criar Aplicativo).

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook-create-app.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=91b0ba730c32c22745d0ae6bfc6d88a2" alt="facebook_create_app" width="2548" height="1474" data-path="self-hosted/images/facebook/facebook-create-app.png" />

2. Selecione a opção "Other" (Outro).

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_other_app.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=383511288f142ff1d0591efc5b7bf9b4" alt="facebook_other_app" width="1654" height="1254" data-path="self-hosted/images/facebook/facebook_other_app.png" />

3. Para o tipo de aplicativo, escolha "Business" (Empresa).

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_business.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=7ccd8c51f7bf38128d5f33013c320a0d" alt="facebook_business" width="2164" height="1744" data-path="self-hosted/images/facebook/facebook_business.png" />

4. Adicione o nome do aplicativo e conecte a conta comercial.

<img src="https://mintcdn.com/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/facebook/facebook_business_details.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=8b2ecd5377bdbd03a265bf28923bdfcf" alt="facebook_business_details" width="2150" height="922" data-path="self-hosted/images/facebook/facebook_business_details.png" />

5. Adicione o produto Instagram a partir da página inicial.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_product.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=f7cd4e313431e8768ec0777c5fa7a8da" alt="instagram_product" width="2984" height="1716" data-path="self-hosted/images/instagram/instagram_product.png" />

## Configurar as definições do Instagram para o AirysChat

1. Copie o Instagram app ID (ID do aplicativo Instagram) e o Instagram app secret (Chave secreta do aplicativo Instagram).

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_app_id.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=50f06db2c754aa6c2ce36684d04ed4b6" alt="instagram_app_id" width="2138" height="1874" data-path="self-hosted/images/instagram/instagram_app_id.png" />

2. Adicione o Instagram app ID e o Instagram app secret na configuração do seu aplicativo via `{AirysChat installation url}/super_admin/app_config?config=instagram`.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_app_config.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=265b16391d84ac16c0d96338e2407f31" alt="instagram_app_config" width="1844" height="1295" data-path="self-hosted/images/instagram/instagram_app_config.png" />

3. Configurar Webhooks

Defina a URL de callback (URL de retorno) para `{your_airyschat_url}/webhooks/instagram`. O token de verificação deve corresponder ao seu `INSTAGRAM_VERIFY_TOKEN`, que pode ser configurado por meio do `app_config`.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_webhook.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=16d23517691e6a0d3a808903215c8127" alt="instagram_webhooks" width="1432" height="594" data-path="self-hosted/images/instagram/instagram_webhook.png" />

Inscreva-se nos eventos `messages`, `messaging_seen` e `message_reactions`.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_webhooks_subscribe.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=88c942194da1a95b8766289825e4c470" alt="instagram_webhooks_subscribe" width="1420" height="1648" data-path="self-hosted/images/instagram/instagram_webhooks_subscribe.png" />

<Note>
  Para receber webhooks, o modo do aplicativo deve ser definido como "Live".
</Note>

4. Configurar o login comercial do Instagram (Instagram business login)

Defina a URL de redirecionamento (Redirect URL) como `{your_airyschat_url}/instagram/callback`.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram_business_login.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=9e68f9b7463c9803284c2852a565922e" alt="instagram_business_login" width="1466" height="692" data-path="self-hosted/images/instagram/instagram_business_login.png" />

5. Crie uma nova conta de testador do Instagram.

## Criar uma Caixa de Entrada do Instagram

Acesse o AirysChat e crie uma caixa de entrada do Instagram. Por favor, consulte este [guia](https://airyschat.help/hc/user-guide/articles/1744361165-how-to-setup-an-instagram-channel-via-instagram-login) para mais detalhes sobre como criar uma caixa de entrada do Instagram no AirysChat.

## Como testar o Instagram antes de ir ao ar

1. Adicione Testadores do Instagram clicando no botão "Add People" (Adicionar Pessoas).

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram-testers-list.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=acf89a3e0df69c99e707ed26f826204e" alt="facebook_instagram_test" width="3526" height="2526" data-path="self-hosted/images/instagram/instagram-testers-list.png" />

2. Certifique-se de ter selecionado a função Instagram Tester ao criar um novo testador.

<img src="https://mintcdn.com/airys/8PgT_S4ekmZVDkFb/self-hosted/images/instagram/instagram-add-tester.png?fit=max&auto=format&n=8PgT_S4ekmZVDkFb&q=85&s=8ffd3c15c4a7562cfa387ae02b8c1168" alt="instagram_tester_list" width="2946" height="1822" data-path="self-hosted/images/instagram/instagram-add-tester.png" />

## Entrando em produção

Antes que você possa começar a usar o seu aplicativo do Facebook em produção, você precisará que ele seja verificado pelo Facebook. Consulte a [documentação](https://developers.facebook.com/docs/messenger-platform/instagram/app-review) sobre como ter seu aplicativo verificado.

## Solução de problemas & Erros comuns

### Erro de Papel de Desenvolvedor Insuficiente (Insufficient Developer Role Error)

Certifique-se de que o usuário do Instagram seja adicionado como desenvolvedor: `Meta Dashboard → App Roles → Roles → Add People → Enter Instagram ID`

### Acesso à API Desativado (API Access Deactivated)

Certifique-se de que a **URL da Política de Privacidade (Privacy Policy URL)** seja válida e esteja definida corretamente.

### Requisição inválida: Parâmetros de requisição são inválidos: redirect\_uri inválido (Invalid request: Request parameters are invalid: Invalid redirect\_uri)

Por favor, configure a URL do Frontend. A URL do Frontend não corresponde à URL de autorização.

### Erro de criação do Canal do Instagram: Falha ao trocar token (Instagram Channel creation Error: Failed to exchange token)

Por favor, certifique-se de que a conta de teste foi adicionada às configurações do aplicativo do facebook.

### 400: Sessão Inválida ao conectar o canal do instagram (400: Session Invalid when connecting the instagram channel)

Isso pode ser um problema do lado do facebook. Por favor, tente novamente depois de algum tempo.