WhatsApp Cloud API
Матеріал з Planfix
У 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, використовуючи кнопки або сценарії.