Як підключити 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

  1. Перейдіть на сайт Maytapi та зареєструйтеся або увійдіть у кабінет.
  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

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

  • Ви увійшли в ConnectiveOne і маєте доступ до Налаштувань ботів.
  • У вас є Product ID, API Key та Phone ID з кабінету Maytapi.
  • Платформа 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.
  • У чаті відображаються статуси доставки (відправлено, доставлено, прочитано) та реакції клієнтів на повідомлення.

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