Як підключити 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.
Частина 1. Реєстрація та отримання даних у Maytapi
Перед підключенням каналу в ConnectiveOne потрібно мати обліковий запис Maytapi та три дані: Product ID, API Key і Phone ID.
1. Реєстрація в Maytapi
- Перейдіть на сайт Maytapi та зареєструйтеся або увійдіть у кабінет.
- Ознайомтеся з тарифами та умовами. Для роботи з ConnectiveOne потрібен доступ до WhatsApp API через Maytapi.
2. Створення продукту та номера (інстансу)
- У кабінеті Maytapi створіть продукт (product), якщо його ще немає. Це контейнер для одного або кількох номерів WhatsApp.
- Додайте номер (phone instance) до продукту. Maytapi надасть можливість прив’язати номер через QR-код або іншим способом згідно з інтерфейсом Maytapi.
- Скопіюйте Product ID — він відображається в інформації про продукт (наприклад, у розділі продукту або в URL).
3. Отримання API Key та Phone ID
- У кабінеті Maytapi відкрийте розділ API або налаштування ключів.
- Створіть або скопіюйте API Key (у документації Maytapi він також може називатися x-maytapi-key). Це секретний ключ — не публікуйте його та не передавайте третім особам.
- Відкрийте список номерів (phones) у вашому продукті та скопіюйте Phone ID для того номера, який хочете підключити до ConnectiveOne.
Після цього у вас мають бути три значення: Product ID, API Key, Phone ID. Їх потрібно буде ввести в ConnectiveOne на наступному етапі.
Частина 2. Підключення каналу в ConnectiveOne
Перед початком
Покрокова інструкція
1. Відкрити налаштування бота
- У меню виберіть Налаштування → Боти.
- Виберіть потрібного бота, до якого хочете підключити WhatsApp Maytapi.
2. Увімкнути канал WhatsApp Maytapi
- У блоці Канали знайдіть канал WhatsApp Maytapi (або WhatsApp MayTApi).
- Увімкніть цей канал для бота — він має з’явитися в списку доступних каналів з полями для введення даних.
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)
- Натисніть кнопку Підключити (або Connect).
- Система зареєструє з’єднання з Maytapi та збереже налаштування. При успіху з’явиться повідомлення про успішне підключення webhook (наприклад, «Webhook set WhatsApp Maytapi» або аналогічне).
- Якщо з’явиться помилка — перевірте правильність Product ID, Phone ID та API Key. Переконайтеся, що ключ не має зайвих пробілів і що в кабінеті Maytapi номер активний.
5. Стан каналу та QR-код (якщо потрібно)
- Після підключення на сторінці з’явиться блок статусу каналу. Стан може бути, наприклад: Підключено, Потрібно сканувати QR, Нестабільне з’єднання або Невідомо.
- Якщо стан Потрібно сканувати QR:
- На сторінці з’явиться QR-код. Відскануйте його за допомогою WhatsApp на телефоні, прив’язаному до цього номера в Maytapi (як додатковий пристрій — «Linked device»).
- QR-код оновлюється автоматично через певний інтервал, поки канал не перейде в стан «Підключено».
- Після успішного сканування стан має змінитися на Підключено (або еквівалент). Після цього можна приймати та відправляти повідомлення.
Якщо пізніше з’єднання зникне (наприклад, через вихід з WhatsApp на телефоні), у чаті може з’явитися повідомлення про необхідність знову відсканувати QR. Перейдіть у Налаштування бота → канал WhatsApp Maytapi і відскануйте новий QR-код.
6. Відключення каналу (за потреби)
- У налаштуваннях каналу WhatsApp Maytapi натисніть Відключити (або Disconnect).
- Система видалить з’єднання з Maytapi для цього бота. Вихідні повідомлення більше не будуть відправлятися через Maytapi для цього бота.
Після підключення
- Вхідні повідомлення на підключений номер WhatsApp надходитимуть у ConnectiveOne і оброблятимуться сценарієм бота та операторами.
- Вихідні повідомлення з Операторської панелі або сценарію будуть доставлятися клієнтам через Maytapi.
- У чаті відображаються статуси доставки (відправлено, доставлено, прочитано) та реакції клієнтів на повідомлення.
Пов’язані статті
- Підключити WhatsApp — підключення через 360dialog або SendPulse.
- Підключення номерних повідомлень через e-chat — альтернативний спосіб підключення номерних WhatsApp, Viber, Telegram.