WhatsApp Cloud API
Матеріал з Planfix
Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з WhatsApp.
Зміст:
- Створення застосунку
- Встановлення вебхука та підписка на всі події
- Створення системного користувача
- Надання системному користувачу прав доступу до номера телефону
- Робота в тестовому режимі
- Робота в боєвому режимі
Створення застосунку
Перейдіть на сторінку Meta for Developers і створіть застосунок:
Встановлення вебхука та підписка на всі події
- Увійдіть у створений застосунок і додайте WhatsApp, натиснувши кнопку «Налаштувати».
- На панелі зліва оберіть «WhatsApp» — «Швидкий старт». Виберіть бізнес-акаунт Meta і натисніть кнопку «Далі»:
- У вікні, що з’явиться, натисніть кнопку «Почати використовувати API»:
- Перейдіть у меню зліва до вкладки «WhatsApp» — «Налаштування». Додайте Callback URL та Verify token, скопіювавши їх з інтеграції в Planfix:
- Потім налаштуйте «Поля Webhook», оформивши підписку на всі поля:
Створення системного користувача
Системний користувач необхідний для генерації Access Token. Він використовується при підключенні інтеграції в Planfix.
Процес створення системного користувача:
- Увійдіть в Meta Business Suite.
- Знайдіть свій бізнес-акаунт і у випадаючому меню в лівому верхньому куті натисніть значок шестерні «Налаштування».
- Оберіть «Налаштування компанії».
- Перейдіть у розділ «Користувачі» — «Системні користувачі».
- Натисніть кнопку «Додати» і створіть системного користувача:
- Додайте ім’я системного користувача
- Вкажіть роль «Адміністратор» і збережіть.
- Надайте доступ до вашого застосунку, яке створювали на початку. Для цього натисніть кнопку «Додати об’єкти»:
- Тепер натисніть кнопку Створити новий маркер (Access Token):
- Вкажіть ваш застосунок.
- Оберіть дозволи: whatsapp_business_messaging та whatsapp_business_management.
- Згенеруйте маркер (Access Token), скопіюйте і збережіть його.
Надання системному користувачу прав доступу до номера телефону
- Увійдіть у налаштування Meta Business Suite.
- Оберіть ваш бізнес-акаунт, в який додавали застосунок (1).
- Потім зліва в розділі «Акаунти» оберіть «Акаунти WhatsApp» (2) і виберіть ваш WhatsApp бізнес-акаунт (3).
- Натисніть кнопку «Додати людей» (4):
- Оберіть створеного раніше системного користувача, надайте йому повні права доступу і збережіть налаштування.
Робота в тестовому режимі
- Відкрийте ваш застосунок в Meta for Developers.
- Скопіюйте ID акаунта WhatsApp Business (2) і тимчасовий токен (3), потім в інтеграції з Planfix додайте їх у відповідні поля.
- Натисніть посилання «Оновити», щоб автоматично додати тестовий номер.
Робота в боєвому режимі
- Відкрийте ваш застосунок в Meta for Developers.
- Скопіюйте ID акаунта WhatsApp Business.
- Якщо номеру ще немає, додайте його кнопкою «Додати номер телефону». Вона розташована нижче на тій же сторінці.
- Завершіть налаштування інтеграції, додавши постійний маркер (Access Token), який ви створювали від імені системного користувача, і натисніть посилання «Оновити». При правильних ID акаунта WhatsApp Business і Access Token підключені номери мають додатися автоматично.
Важливо
- Першим написати контакту через офіційну інтеграцію WhatsApp Cloud API не можна — такі правила самого WhatsApp.
- Через Planfix можна надсилати шаблонні повідомлення, які пройшли перевірку в WhatsApp, використовуючи кнопки або сценарії.