WhatsApp Cloud API
Матеріал з Planfix
Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з WhatsApp.
Зміст:
- Створення застосунку
- Налаштування webhook і підписка на всі події
- Створення системного користувача
- Надання системному користувачу прав доступу до номера телефону
- Робота в тестовому режимі
- Робота в бойовому режимі
Створення застосунку
Перейдіть на сторінку Meta for Developers і створіть застосунок:
Налаштування webhook і підписка на всі події
- Увійдіть у створений застосунок і додайте 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, використовуючи кнопки або сценарії.