# Як підключити WhatsApp через Maytapi

Інструкція допоможе підключити номер WhatsApp до ConnectiveOne через провайдера **Maytapi**: від реєстрації в кабінеті Maytapi до підключення каналу в Налаштуваннях бота. Після налаштування ви зможете приймати та відправляти повідомлення, бачити статуси доставки та реакції клієнтів.

## Коли знадобиться

- Потрібно підключити номер WhatsApp (не бота) для обміну повідомленнями з клієнтами.
- Ви обрали Maytapi як провайдера для WhatsApp API.
- Потрібна інструкція від реєстрації в Maytapi до робочого каналу в ConnectiveOne.

## Що важливо знати

- **Maytapi** — зовнішній сервіс, який надає API для роботи з WhatsApp. ConnectiveOne отримує та відправляє повідомлення через Maytapi.
- **Product ID** — ідентифікатор вашого продукту в кабінеті Maytapi.
- **Phone ID** — ідентифікатор конкретного номера (інстансу) WhatsApp у Maytapi. Один продукт може мати кілька номерів.
- **API Key (x-maytapi-key)** — секретний ключ для доступу до API Maytapi. Зберігайте його в безпеці та не передавайте третім особам.
- **Стан каналу** — після підключення в ConnectiveOne відображається стан: підключено, потрібно сканувати QR-код або тимчасові проблеми з’єднання.

## Можливості поточного підключення

Після успішного підключення каналу WhatsApp Maytapi ви можете:

- **Приймати повідомлення** — текст, зображення, відео, аудіо, документи.
- **Відправляти повідомлення** — те саме з Операторської панелі або через сценарій бота.
- **Отримувати реакції** — якщо клієнт ставить емодзі-реакцію на повідомлення, вона зберігається та відображається в чаті.
- **Контролювати стан каналу** — система показує, чи канал підключений, чи потрібно відсканувати QR-код знову. При проблемах з’єднання можна перейти до налаштувань і оновити QR.

Якщо потрібні додаткові можливості (наприклад, інший провайдер або номерні повідомлення через e-chat), дивіться [Підключення номерних повідомлень через e-chat](/uk/channels/how-to/connect-viber-telegram-whatsapp-via-echat.md).

---

## Частина 1. Реєстрація та отримання даних у Maytapi

Перед підключенням каналу в ConnectiveOne потрібно мати обліковий запис Maytapi та три дані: **Product ID**, **API Key** і **Phone ID**.

### 1. Реєстрація в Maytapi

1. Перейдіть на сайт [Maytapi](https://maytapi.com/) та зареєструйтеся або увійдіть у кабінет.
2. Ознайомтеся з тарифами та умовами. Для роботи з ConnectiveOne потрібен доступ до WhatsApp API через Maytapi.

### 2. Створення продукту та номера (інстансу)

1. У кабінеті Maytapi створіть **продукт** (product), якщо його ще немає. Це контейнер для одного або кількох номерів WhatsApp.
2. Додайте **номер (phone instance)** до продукту. Maytapi надасть можливість прив’язати номер через QR-код або іншим способом згідно з інтерфейсом Maytapi.
3. Скопіюйте **Product ID** — він відображається в інформації про продукт (наприклад, у розділі продукту або в URL).

### 3. Отримання API Key та Phone ID

1. У кабінеті Maytapi відкрийте розділ API або налаштування ключів.
2. Створіть або скопіюйте **API Key** (у документації Maytapi він також може називатися **x-maytapi-key**). Це секретний ключ — не публікуйте його та не передавайте третім особам.
3. Відкрийте список номерів (phones) у вашому продукті та скопіюйте **Phone ID** для того номера, який хочете підключити до ConnectiveOne.

Після цього у вас мають бути три значення: **Product ID**, **API Key**, **Phone ID**. Їх потрібно буде ввести в ConnectiveOne на наступному етапі.

---

## Частина 2. Підключення каналу в ConnectiveOne

### Перед початком

- [x] Ви увійшли в ConnectiveOne і маєте доступ до Налаштувань ботів.
- [x] У вас є Product ID, API Key та Phone ID з кабінету Maytapi.
- [x] Платформа ConnectiveOne налаштована для роботи з Maytapi (при потребі це робить адміністратор).

### Покрокова інструкція

#### 1. Відкрити налаштування бота

1. У меню виберіть **Налаштування** → **Боти**.
2. Виберіть потрібного бота, до якого хочете підключити WhatsApp Maytapi.

#### 2. Увімкнути канал WhatsApp Maytapi

1. У блоці **Канали** знайдіть канал **WhatsApp Maytapi** (або **WhatsApp MayTApi**).
2. Увімкніть цей канал для бота — він має з’явитися в списку доступних каналів з полями для введення даних.

#### 3. Заповнити дані Maytapi

Заповніть три поля даними з кабінету Maytapi:

| Поле в ConnectiveOne | Що вказати |
|----------------------|------------|
| **Maytapi Product ID** | Ідентифікатор продукту з кабінету Maytapi. |
| **Maytapi API Key (x-maytapi-key)** | Секретний ключ API з Maytapi. |
| **Maytapi Phone ID** | Ідентифікатор номера (інстансу). Якщо в інтерфейсі є випадаючий список номерів після введення Product ID та API Key — можна обрати номер зі списку. |

Якщо після введення Product ID та API Key з’являється список номерів — виберіть потрібний **Phone ID** з цього списку.

#### 4. Підключити канал (Connect)

1. Натисніть кнопку **Підключити** (або **Connect**).
2. Система зареєструє з’єднання з Maytapi та збереже налаштування. При успіху з’явиться повідомлення про успішне підключення webhook (наприклад, «Webhook set WhatsApp Maytapi» або аналогічне).
3. Якщо з’явиться помилка — перевірте правильність Product ID, Phone ID та API Key. Переконайтеся, що ключ не має зайвих пробілів і що в кабінеті Maytapi номер активний.

#### 5. Стан каналу та QR-код (якщо потрібно)

1. Після підключення на сторінці з’явиться блок **статусу каналу**. Стан може бути, наприклад: **Підключено**, **Потрібно сканувати QR**, **Нестабільне з’єднання** або **Невідомо**.
2. Якщо стан **Потрібно сканувати QR**:
   - На сторінці з’явиться **QR-код**. Відскануйте його за допомогою WhatsApp на телефоні, прив’язаному до цього номера в Maytapi (як додатковий пристрій — «Linked device»).
   - QR-код оновлюється автоматично через певний інтервал, поки канал не перейде в стан «Підключено».
3. Після успішного сканування стан має змінитися на **Підключено** (або еквівалент). Після цього можна приймати та відправляти повідомлення.

Якщо пізніше з’єднання зникне (наприклад, через вихід з WhatsApp на телефоні), у чаті може з’явитися повідомлення про необхідність знову відсканувати QR. Перейдіть у Налаштування бота → канал WhatsApp Maytapi і відскануйте новий QR-код.

#### 6. Відключення каналу (за потреби)

1. У налаштуваннях каналу WhatsApp Maytapi натисніть **Відключити** (або **Disconnect**).
2. Система видалить з’єднання з Maytapi для цього бота. Вихідні повідомлення більше не будуть відправлятися через Maytapi для цього бота.

---

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

- Вхідні повідомлення на підключений номер WhatsApp надходитимуть у ConnectiveOne і оброблятимуться сценарієм бота та операторами.
- Вихідні повідомлення з Операторської панелі або сценарію будуть доставлятися клієнтам через Maytapi.
- У чаті відображаються статуси доставки (відправлено, доставлено, прочитано) та реакції клієнтів на повідомлення.

---

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

- [Підключити WhatsApp](/uk/channels/how-to/connect-whatsapp.md) — підключення через 360dialog або SendPulse.
- [Підключення номерних повідомлень через e-chat](/uk/channels/how-to/connect-viber-telegram-whatsapp-via-echat.md) — альтернативний спосіб підключення номерних WhatsApp, Viber, Telegram.