# Як підключити Facebook Messenger та Instagram до ConnectiveOne

Підключіть сторінки Facebook та Instagram до ConnectiveOne для обробки повідомлень клієнтів через ці платформи.

## Передумови

1. Бізнес-сторінка Facebook та/або бізнес-сторінка Instagram
2. Права адміністратора сторінки (People with Facebook access)
3. Для одночасного підключення Facebook Messenger та Instagram — сторінки мають бути пов'язані між собою
4. Для самостійного підключення через вікно Meta — на інстансі має бути увімкнено перемикач **Meta OAuth v2 (server-side)** (див. нижче)

## Feature flag: Meta OAuth v2

Самостійне підключення сторінки кнопкою **Підключити сторінку Facebook** працює, коли на інстансі увімкнено **Meta OAuth v2 (server-side)**.

### Як увімкнути

1. Увійдіть як адміністратор інстансу.
2. Перейдіть у **Налаштування → Feature Flags** (перемикачі функцій платформи).
3. У блоці інтеграцій увімкніть **Meta OAuth v2 (server-side)**.
4. Збережіть зміни. Перезапуск сервера **не потрібен**.

| Стан перемикача | Що бачить адміністратор бота |
|-----------------|------------------------------|
| Увімкнено | Кнопка **Підключити сторінку Facebook** відкриває вікно Meta; сторінку можна прив’язати самостійно. Щоб відв’язати — **Відключити** |
| Вимкнено | Кнопка **Увійти через Facebook** (класичний вхід). Для нового інстансу може знадобитися білий список домену або допомога ConnectiveOne. Щоб вийти з акаунта Facebook у цьому режимі — **Вийти** |

Якщо пункту **Meta OAuth v2 (server-side)** немає або кнопка не відкриває вікно Meta — зверніться до представників ConnectiveOne (на інстансі може ще не бути розгорнуто потрібні сервіси).

## Способи підключення

1. **Самостійне підключення** (рекомендовано, якщо увімкнено Meta OAuth v2) — підключіть сторінку в налаштуваннях бота
2. **Додавання KwizyBot до сторінки** — якщо самостійне підключення недоступне
3. **Надання логіну та пароля** — передайте дані представнику ConnectiveOne

## Спосіб 1: Самостійне підключення

Потрібен увімкнений перемикач **Meta OAuth v2 (server-side)** (див. [Feature flag](#feature-flag-meta-oauth-v2)).

**Важливо:** Одночасне підключення Facebook Messenger та Instagram до одного бота доступне тільки для пов'язаних між собою акаунтів.

### Крок 1: Підготовка

1. Переконайтеся, що ви виконали всі передумови.
2. Увійдіть у ConnectiveOne під обліковим записом з правами адміністратора бота / інстансу.
3. Дозвольте спливаючі вікна для вашого інстансу ConnectiveOne (браузер може блокувати вікно Meta).

### Крок 2: Авторизація через Meta

1. Перейдіть у **Налаштування ботів** (або налаштування каналу Facebook / Instagram) → оберіть потрібного бота.
2. Натисніть **Підключити сторінку Facebook**.
3. У спливному вікні Meta увійдіть у потрібний обліковий запис і підтвердіть доступ.
4. Оберіть сторінки Facebook (і Instagram, якщо потрібно) та завершіть діалог Meta.

### Крок 3: Прив’язка сторінки до бота

1. Якщо у вас одна сторінка — вона може прив’язатись автоматично.
2. Якщо сторінок кілька — у списку натисніть **Підключити** біля потрібної сторінки.
3. Переконайтеся, що статус показує успішне підключення. Повне перезавантаження сторінки зазвичай **не потрібне**.
4. За потреби натисніть оновлення статусу в блоці підключення Facebook.

### Відключення

Натисніть **Відключити** у тих самих налаштуваннях — сторінка повністю відв’яжеться від бота. Підключити знову можна тим самим способом.

### Після підключення

Повідомлення на підключені сторінки Facebook / Instagram обробляються сценарієм бота, до якого виконано прив’язку, і можуть потрапляти в операторську панель.

## Спосіб 2: Додавання KwizyBot до сторінки

Використовуйте, якщо **Meta OAuth v2** вимкнено або самостійне підключення на вашому інстансі ще недоступне.

Якщо перемикач вимкнено, у інтерфейсі ви побачите кнопку **Увійти через Facebook** (класичний вхід). Самостійне підключення через вікно Meta в цьому режимі недоступне — скористайтеся KwizyBot або передайте дані представнику ConnectiveOne.

### Крок 1: Перевірка доступу

Переконайтеся, що ви маєте права адміністратора сторінки в розділі **People with Facebook access**.

### Крок 2: Додавання KwizyBot

1. Перейдіть на бізнес-сторінку Facebook
2. Натисніть на фото профілю у верхньому правому куті
3. Оберіть потрібний обліковий запис
4. Перейдіть до **Професійна панель**
5. У розділі **Ваші інструменти** оберіть **Доступ до сторінки**
6. Натисніть **Додати нову людину**
7. Введіть `Kwizy Bot` у пошук або перейдіть за посиланням: [facebook.com/KWEasyy](https://www.facebook.com/KWEasyy)
8. Надайте доступ до сторінки (можна частковий)
9. Підтвердіть пароль
10. Перевірте, що Kwizy Bot з'явився в **People with Facebook access**

### Крок 3: Повідомлення представників

Надішліть представникам ConnectiveOne посилання на сторінку, до якої ви додали Kwizy Bot, щоб вони змогли підключити її до платформи.

## Спосіб 3: Надання логіну та пароля

Надішліть представнику ConnectiveOne логін та пароль від Facebook-сторінки для налаштування підключення.

**Важливо:** Для безпечної передачі використовуйте сервіс [share.dt.evergreen.team](https://share.dt.evergreen.team/).

## Часті проблеми

### Спливаюче вікно Meta заблоковано

Дозвольте pop-up для адреси вашого інстансу ConnectiveOne і знову натисніть **Підключити сторінку Facebook**.

### Facebook не повернув жодної сторінки

Перевірте, що ваш обліковий запис має доступ адміністратора до потрібної Page. Якщо сторінка в Business Portfolio — зверніться до підтримки ConnectiveOne.

### Бот не знаходиться в пошуку (KwizyBot)

- Переконайтеся, що ви правильно вводите ім'я, email або посилання
- Переконайтеся, що ви не додаєте власну сторінку
- Переконайтеся, що людина має публічний профіль
- Переконайтеся, що сторінка не міститься в Meta Business Suite → Налаштування → Сторінки
- Переконайтеся, що користувач є у вашому списку друзів, вподобав бізнес-сторінку та залишив на ній повідомлення

Якщо жоден спосіб не працює, спробуйте надання логіну та пароля або зверніться до представників ConnectiveOne.

### Кнопка підтвердження паролю неактивна

Спробуйте виконати ті ж кроки з мобільного застосунку Facebook або через вебсайт на мобільному пристрої.

### Помилка про Two Factor Authentication

Увімкніть [двохфакторну авторизацію](https://www.facebook.com/watch/?v=7503126079741808) на своєму особистому обліковому записі та спробуйте відв'язати та підключити бота ще раз.

### Помилка про permissions

Під час самостійного підключення в вікні Meta надайте доступ до потрібних сторінок Instagram.

### Невідомий домен JSSDK

Ця помилка стосується режиму **без** Meta OAuth v2 (коли в інтерфейсі кнопка **Увійти через Facebook**). Увімкніть **Meta OAuth v2 (server-side)** і скористайтеся [Способом 1](#спосіб-1-самостійне-підключення). Якщо перемикач недоступний — зверніться до представників ConnectiveOne (вони додадуть інстанс у білий список або увімкнуть новий режим).

## Відповіді на історії та коментарі

Щоб мати можливість бачити відповіді на історії, коментарі до дописів та інші подібні взаємодії, зверніться до представників ConnectiveOne.

## Файли з Operator Line

PDF і інші документи з Operator Line в Facebook Messenger за замовчуванням надсилаються як **посилання в тексті**. Щоб клієнт отримував їх як вкладення Messenger, root-адміністратор увімкне опцію на інстансі: [Як увімкнути нативні файли в Facebook Messenger](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md).

## Пов'язані статті

- [Запуск сценарію через deeplink](/uk/integrations/explanation/deeplink-launch.md)
- [Як увімкнути нативні файли в Facebook Messenger](/uk/operatorline/how-to/enable-facebook-native-file-attachments.md)