> ## 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. Це один раз робить той, хто керує платформою, а не кожна агенція (див. [Хто що робить](https://docs.instaforge.app/uk/getting-started/who-does-what.md)).

## Підключіть акаунт

**1. Відкрийте сторінку Instagram в асистента**

У меню асистента відкрийте **Instagram**.

**2. Натисніть «Підключити через Instagram» (1)**

Клієнт входить в акаунт і підтверджує доступ. Під час входу через Facebook, якщо клієнт керує кількома акаунтами Instagram, InstaForge запитає, за який із них відповідає цей асистент.

**3. Або надішліть клієнтові посилання**

Якщо клієнта немає поруч, натисніть **Або надішліть клієнту посилання, щоб він підключив сам**, скопіюйте посилання і надішліть його клієнтові. Воно працює з телефона або комп'ютера 24 години або доки через нього не підключать акаунт Instagram. Посилання відкриває сторінку з кнопкою **Підключити Instagram**, тому прев'ю посилань у WhatsApp чи Telegram не можуть його використати, а скасований вхід можна повторити за тим самим посиланням. Клієнт входить у той акаунт Instagram, у якому має працювати асистент, і наприкінці бачить сторінку з підтвердженням. Якщо посилання вже використано або воно застаріло, створіть нове. Якщо в асистента вже є акаунт Instagram, за посиланням можна лише знову увійти в той самий акаунт (наприклад, коли сплив доступ). Щоб перевести асистента на інший акаунт, підключіть його самі на сторінці Instagram або спочатку відключіть старий.

**4. Перевірте результат**

На сторінці з'явиться ім'я підключеного акаунта. Асистент почне відповідати в Instagram, щойно ввімкнено перемикач **Відповідати в Instagram** (на сторінці **Огляд** асистента).

![Сторінка підключення Instagram](https://mintcdn.com/instaforge/DZPPAhB5awuvrT5G/images/uk/instagram.png?fit=max\&auto=format\&n=DZPPAhB5awuvrT5G\&q=85\&s=6791e761b8d713092df6d19f9647a736)

Сторінка підключення Instagram

## Одноразове налаштування застосунку 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`.

### Коли хтось видаляє застосунок

Meta повідомляє платформу, коли хтось видаляє застосунок у налаштуваннях Instagram або Facebook чи просить Meta видалити свої дані. Тоді асистент втрачає підключення до Instagram і повертається в чернетку. Чат на сайті, сторінка запису, магазин і канали, підключені в розділі **Канали**, далі працюють. Усі, хто має право керувати асистентом, отримують лист із проханням знову підключити Instagram.

Запит на видалення даних від самого акаунта Instagram також видаляє клієнтів, які писали асистентові в Instagram, разом із їхнім листуванням і записами. Запит від людини, яка підключила акаунт через вхід у Facebook (наприклад, співробітника чи фрилансера), видаляє лише це підключення. Клієнти з Instagram, чату на сайті, сторінки запису, WhatsApp, Messenger і Telegram залишаються.

> [!NOTE]
>
> Поки застосунок Meta на перевірці, користуйтеся [тестуванням](https://docs.instaforge.app/uk/build-the-assistant/playground.md) і [чатом на сайті](https://docs.instaforge.app/uk/grow-sales/website-chat.md). Ні тому, ні іншому не потрібне схвалення Meta.

## Розв'язання проблем

> [accordion] На сторінці входу написано, що застосунок недоступний
>
> Застосунок Meta ще в режимі розробки, а людину не додано до тестувальників. Додайте її акаунт Instagram як тестувальника Instagram у застосунку Meta або завершіть App Review.

> [accordion] Повідомлення надходять, але асистент не відповідає
>
> Перевірте, що ввімкнено **Відповідати в Instagram** (Огляд), що на сторінці **Мозок ШІ** підключено сервіс ШІ і що людину не передано команді (у листуванні є значок **Співробітник**).

> [accordion] Пише, що до ваших сторінок не прив'язано жодного акаунта Instagram
>
> Під час входу через Facebook акаунт Instagram має бути прив'язаний до сторінки Facebook, а клієнт має дати доступ до цієї сторінки під час входу. Прив'яжіть акаунт до сторінки (у налаштуваннях сторінки у Facebook, у розділі **Пов'язані облікові записи → Instagram**), потім підключіться знову і залиште сторінку вибраною. Сторінки з бізнес-портфоліо теж підходять, якщо позначити їх під час входу.

> [accordion] Пише, що жодної сторінки Facebook не надано
>
> Під час входу Facebook запитує, до яких сторінок дати доступ. Підключіться знову і позначте сторінку, до якої прив'язано акаунт Instagram.

> [accordion] Пише, що доступ до Instagram не дозволено
>
> Під час входу було вимкнено один із дозволів. Підключіться знову і залиште всі дозволи ввімкненими, зокрема для акаунта Instagram. Якщо це повторюється, перевірте, що в конфігурації Facebook Login for Business є `instagram_basic`.

> [accordion] Пише, що акаунт уже підключено до іншого асистента
>
> Один акаунт Instagram може працювати лише з одним асистентом. Спочатку відключіть його від іншого асистента.

> [accordion] Підключення з часом перестало працювати
>
> Токени Instagram оновлюються автоматично, а доступ через сторінку Facebook не спливає. Якщо клієнт змінив пароль або видалив застосунок, підключіться знову на тій самій сторінці.


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