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

# Подключение Instagram

> Подключите профессиональный аккаунт Instagram клиента через официальный вход Meta.

InstaForge работает через официальный Instagram API от Meta: клиент сам входит в аккаунт и подтверждает доступ. Никому не нужно сообщать пароль.

В зависимости от того, как настроено приложение Meta вашей платформы, клиент входит одним из двух способов:

* **Через Instagram:** клиент входит в сам аккаунт Instagram.
* **Через Facebook:** клиент входит в Facebook и выбирает страницу Facebook, к которой привязан его аккаунт Instagram. В этом случае кнопка называется **Подключить через Facebook**.

## Перед началом

* Аккаунт должен быть **бизнес-аккаунтом или аккаунтом автора** в Instagram.
* В приложении Instagram откройте **Настройки → Сообщения и ответы на истории → Управление сообщениями → Подключённые инструменты** (в английском интерфейсе: Settings → Messages and story replies → Message controls → Connected tools) и разрешите доступ к сообщениям.
* При входе через Facebook аккаунт Instagram должен быть привязан к **странице Facebook**, которой управляет клиент (в приложении Instagram: **Настройки → Центр аккаунтов**, или в настройках страницы в разделе **Связанные аккаунты**).
* В приложении Meta вашего агентства должен быть настроен продукт Instagram (это один раз делает администратор).

## Подключите аккаунт

<Steps>
  <Step title="Откройте страницу Instagram у ассистента">
    В меню ассистента откройте **Instagram**.
  </Step>

  <Step title="Нажмите «Подключить через Instagram» (1)">
    Клиент входит в аккаунт и подтверждает доступ. При входе через Facebook, если клиент управляет несколькими аккаунтами Instagram, InstaForge спросит, за какой из них отвечает этот ассистент.
  </Step>

  <Step title="Или отправьте клиенту ссылку">
    Если клиента нет рядом, нажмите **Или отправьте клиенту ссылку, чтобы он подключил сам**, скопируйте ссылку и отправьте её клиенту. Она работает с телефона или компьютера 24 часа или пока через неё не подключат аккаунт Instagram. Ссылка открывает страницу с кнопкой **Подключить Instagram**, поэтому превью ссылок в WhatsApp или Telegram не могут её израсходовать, а отменённый вход можно повторить по той же ссылке. Клиент входит в тот аккаунт Instagram, в котором должен работать ассистент, и в конце видит страницу с подтверждением. Если ссылка уже использована или истекла, создайте новую.
  </Step>

  <Step title="Проверьте результат">
    На странице появится имя подключённого аккаунта. Ассистент начнёт отвечать, как только бот получит статус **Работает**.
  </Step>
</Steps>

<Frame caption="Страница подключения Instagram">
  <img src="https://mintcdn.com/instaforge/CmTW7pDRMhG5KJr6/images/ru/instagram.png?fit=max&auto=format&n=CmTW7pDRMhG5KJr6&q=85&s=26f137de65d4a2a9092f9d9e2bff4943" alt="Страница подключения Instagram" width="2600" height="1800" data-path="images/ru/instagram.png" />
</Frame>

## Разовая настройка приложения Meta (для администраторов)

В блоке **Настройки вебхука для приложения Meta** (2) указаны callback URL, verify token и адрес перенаправления, которые нужно один раз вставить в приложение Meta, а также поля для подписки. В том же блоке есть адреса, которые Meta запрашивает при проверке приложения (App Review): deauthorize callback, URL для удаления данных и политика конфиденциальности.

При входе через Instagram откройте в приложении Meta раздел **Instagram → API setup with Instagram login**. Указанные там **Instagram app ID** и **Instagram app secret** отличаются от ID и секрета самого приложения Meta, и платформе они тоже нужны. Вставьте адрес перенаправления в **Business login settings → OAuth redirect URIs**, добавьте туда же deauthorize callback и URL для удаления данных, а callback URL и verify token вставьте в разделе **Configure webhooks**.

При входе через Facebook адрес перенаправления, deauthorize callback и URL для удаления данных указываются в **Facebook Login for Business → Settings**, а callback URL и verify token в вебхуках Instagram в разделе **API setup with Facebook login**. Конфигурации Facebook Login for Business нужны такие разрешения: `instagram_basic`, `instagram_manage_messages`, `instagram_manage_comments`, `instagram_manage_insights`, `instagram_content_publish`, `pages_show_list`, `pages_read_engagement`, `pages_manage_metadata` и `business_management`.

<Info>
  Пока приложение Meta на проверке, пользуйтесь [тестированием](/ru/build-the-assistant/playground) и [чатом на сайте](/ru/grow-sales/website-chat). Ни тому, ни другому не нужно одобрение Meta.
</Info>

## Решение проблем

<AccordionGroup>
  <Accordion title="На странице входа написано, что приложение недоступно">
    Приложение Meta ещё в режиме разработки, а человек не добавлен в тестировщики. Добавьте его аккаунт Instagram как тестировщика Instagram в приложении Meta или завершите App Review.
  </Accordion>

  <Accordion title="Сообщения приходят, но ассистент не отвечает">
    Проверьте, что у бота статус **Работает**, что на странице **Мозг ИИ** подключён сервис ИИ и что человек не передан команде (в переписке есть значок **Сотрудник**).
  </Accordion>

  <Accordion title="Пишет, что к вашим страницам не привязан ни один аккаунт Instagram">
    При входе через Facebook аккаунт Instagram должен быть привязан к странице Facebook, а клиент должен дать доступ к этой странице при входе. Привяжите аккаунт к странице (в настройках страницы на Facebook, в разделе **Связанные аккаунты → Instagram**), затем подключитесь заново и оставьте страницу выбранной. Страницы из бизнес-портфолио тоже подходят, если отметить их при входе.
  </Accordion>

  <Accordion title="Пишет, что ни одна страница Facebook не была предоставлена">
    При входе Facebook спрашивает, к каким страницам дать доступ. Подключитесь заново и отметьте страницу, к которой привязан аккаунт Instagram.
  </Accordion>

  <Accordion title="Пишет, что доступ к Instagram не разрешён">
    При входе было выключено одно из разрешений. Подключитесь заново и оставьте все разрешения включёнными, в том числе для аккаунта Instagram. Если это повторяется, проверьте, что в конфигурации Facebook Login for Business есть `instagram_basic`.
  </Accordion>

  <Accordion title="Пишет, что аккаунт уже подключён к другому ассистенту">
    Один аккаунт Instagram может работать только с одним ассистентом. Сначала отключите его от другого ассистента.
  </Accordion>

  <Accordion title="Подключение со временем перестало работать">
    Токены Instagram обновляются автоматически, а доступ через страницу Facebook не истекает. Если клиент сменил пароль или удалил приложение, подключитесь заново на той же странице.
  </Accordion>
</AccordionGroup>


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