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

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

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

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

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

• Maytapi — зовнішній сервіс з API для WhatsApp. ConnectiveOne отримує та відправляє повідомлення через Maytapi.
• Product ID і Token (API Key) — у кабінеті Maytapi: Developers → Product ID & Token (/developers/token).
• Phone ID — ідентифікатор номера (інстансу) у розділі Phones (поле id у списку). Один продукт може мати кілька номерів.
• API Key (x-maytapi-key) у ConnectiveOne = поле TOKEN на сторінці Product ID & Token. Зберігайте в безпеці.
• Стан каналу — після підключення ConnectiveOne показує стан: підключено, потрібно сканувати QR, перепідключення або невідомий стан.

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

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

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

Якщо потрібен номерний Viber / Telegram / WhatsApp через інший шлюз, дивіться Підключення через e-chat.

Частина 1. Реєстрація та дані в Maytapi

Перед підключенням у ConnectiveOne потрібні Product ID, API Key (Token) і Phone ID. Кабінет: console.maytapi.com.

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

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

2. Де взяти Product ID і Token (найважливіше)

Типова плутанина: ключі не в розділі Phones і не в Webhooks.

1. У лівому меню консолі відкрийте Developers → Product ID & Token.
   Пряме посилання: console.maytapi.com/developers/token.
2. На сторінці Developers / Token побачите два поля з кнопкою Copy:
   • PRODUCT ID — у ConnectiveOne це MayTApi Product ID;
   • TOKEN — у ConnectiveOne це MayTApi API Key (x-maytapi-key).
3. Скопіюйте обидва значення. Не публікуйте Token і не надсилайте його в чати без потреби.

3. Phone ID і QR (номер)

1. У лівому меню відкрийте Phones.
2. У списку зліва оберіть інстанс — у рядку видно id (це Phone ID, наприклад 153599). Phone ID також можна обрати пізніше в ConnectiveOne після Перевірити зв’язок.
3. Якщо статус qr-screen / потрібне сканування — на вкладці QR Code відскануйте код у WhatsApp на телефоні цього номера (Пов’язані пристрої / Linked devices) і дочекайтеся підключення в консолі Maytapi.

Після цього у вас є три значення для ConnectiveOne: Product ID, Token (API Key), Phone ID.

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

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

• Ви увійшли в ConnectiveOne і маєте доступ до налаштувань ботів.
• Є Product ID, API Key і (за потреби) Phone ID з Maytapi.
• На інстансі увімкнено роботу з Maytapi (за потреби це робить адміністратор).

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

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

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

Те саме можна зробити в Конструкторі сценаріїв на стартовій ноді → тригер Канали.

2. Відкрити канал WhatsApp MayTApi

1. У блоці Канали знайдіть WhatsApp MayTApi.
2. Відкрийте панель каналу — з’являться кроки налаштування.

3. Крок 1. Облікові дані та перевірка зв’язку

1. Заповніть:

2. Натисніть Перевірити зв’язок.
3. Після успіху з’явиться підтвердження; можна переходити до вибору номера.

Якщо перевірка не пройшла — перевірте Product ID і API Key (зайві пробіли, активність ключа в Maytapi).

4. Крок 2. Номер і прив’язка

1. У полі MayTApi Phone ID оберіть номер зі списку (після перевірки зв’язку) або введіть Phone ID вручну.
2. Натисніть Підключити (прив’язати номер).
3. При успіху з’явиться повідомлення про встановлення webhook (наприклад, «Webhook set WhatsApp Maytapi»).

5. QR-код (якщо потрібно)

1. Якщо стан каналу Потрібно сканувати QR, на сторінці з’явиться QR-код.
2. Відскануйте його в WhatsApp на телефоні цього номера (Пов’язані пристрої / Linked devices).
3. За потреби натисніть Оновити, щоб завантажити новий QR.
4. Після успішного сканування стан має стати Підключено, можна надсилати.

6. Крок 3. Статус і керування

Після прив’язки видно:

Додаткові дії:

• Перевірити статус — оновити стан з Maytapi.
• Переприв’язати номер (QR) — отримати новий QR для повторної прив’язки.
• Відв’язати процес — відключити канал від цього бота.

Якщо номер від’єднався під час роботи, у інтерфейсі може з’явитися попередження, а в відкритому WhatsApp-чаті — банер із переходом до QR. Поки канал не в стані «можна надсилати», нові повідомлення клієнтам можуть не відправлятися.

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

• Вхідні повідомлення на номер надходять у ConnectiveOne (сценарій і оператори).
• Вихідні з Операторської лінії або сценарію йдуть через Maytapi.
• У чаті видно статуси доставки (відправлено / доставлено / прочитано) і реакції клієнтів.
• Повідомлення, які менеджер написав прямо в додатку WhatsApp або WhatsApp Web на номері каналу, теж з'являються в чаті: біля імені автора стоїть іконка телефону з підказкою «Написано вручну оператором через месенджер». Медіа й реакції, надіслані з телефону, у чат не потрапляють.

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

• Підключити WhatsApp — через 360dialog або SendPulse.
• Підключення номерних каналів через e-chat.
• Хаб каналів.