WhatsApp Cloud API: відмінності між версіями
Матеріал з Planfix
Немає опису редагування |
Немає опису редагування |
||
| Рядок 10: | Рядок 10: | ||
Зміст: | Зміст: | ||
*[[#Создание приложения|Створення застосунку]] | *[[#Создание приложения|Створення застосунку]] | ||
*[[#Установка вебхука и подписка на все события| | *[[#Установка вебхука и подписка на все события|Налаштування webhook і підписка на всі події]] | ||
*[[#Создание системного пользователя|Створення системного користувача]] | *[[#Создание системного пользователя|Створення системного користувача]] | ||
*[[#Предоставление системному пользователю прав доступа к номеру телефона|Надання системному користувачу прав доступу до номера телефону]] | *[[#Предоставление системному пользователю прав доступа к номеру телефона|Надання системному користувачу прав доступу до номера телефону]] | ||
*[[#Работа в тестовом режиме|Робота в тестовому режимі]] | *[[#Работа в тестовом режиме|Робота в тестовому режимі]] | ||
*[[#Работа в боевом режиме|Робота в | *[[#Работа в боевом режиме|Робота в бойовому режимі]] | ||
== Створення застосунку == | == Створення застосунку == | ||
| Рядок 23: | Рядок 23: | ||
[https://youtu.be/eo7moR3Agbc Дивитися відео на YouTube] | [https://youtu.be/eo7moR3Agbc Дивитися відео на YouTube] | ||
== | == Налаштування webhook і підписка на всі події == | ||
*Увійдіть у створений застосунок і додайте WhatsApp, натиснувши кнопку «Налаштувати». | *Увійдіть у створений застосунок і додайте WhatsApp, натиснувши кнопку «Налаштувати». | ||
*На панелі | *На панелі ліворуч виберіть «WhatsApp» — «Швидкий старт». Виберіть бізнес-акаунт Meta і натисніть кнопку «Далі»: | ||
https://p.pfx.so/pf/g9/oNBUZR.png | https://p.pfx.so/pf/g9/oNBUZR.png | ||
*У вікні, що | |||
*У вікні, що зʼявилося, натисніть кнопку «Почати використовувати API»: | |||
https://p.pfx.so/pf/jj/SOmkjn.png | https://p.pfx.so/pf/jj/SOmkjn.png | ||
*Перейдіть у меню | |||
*Перейдіть у меню ліворуч у вкладку «WhatsApp» — «Налаштування». Додайте Callback URL і Verify token, скопіювавши їх з інтеграції в Planfix: | |||
https://p.pfx.so/pf/KP/PmmFH0.png | https://p.pfx.so/pf/KP/PmmFH0.png | ||
*Потім налаштуйте «Поля Webhook», оформивши підписку на '''всі поля''': | *Потім налаштуйте «Поля Webhook», оформивши підписку на '''всі поля''': | ||
| Рядок 44: | Рядок 47: | ||
== Створення системного користувача == | == Створення системного користувача == | ||
Системний користувач | Системний користувач потрібен для генерації Access Token. Він використовується при підключенні інтеграції в Planfix. | ||
Процес створення системного користувача: | Процес створення системного користувача: | ||
*Увійдіть | *Увійдіть у [https://business.facebook.com/ Meta Business Suite]. | ||
*Знайдіть свій бізнес-акаунт і у | *Знайдіть свій бізнес-акаунт і в розкривному меню у лівому верхньому куті натисніть значок шестерні «Налаштування». | ||
* | *Виберіть «Налаштування компанії». | ||
*Перейдіть у розділ «Користувачі» — «Системні користувачі». | *Перейдіть у розділ «Користувачі» — «Системні користувачі». | ||
*Натисніть кнопку «Додати» і створіть системного користувача: | *Натисніть кнопку «Додати» і створіть системного користувача: | ||
**Додайте | **Додайте ім'я системного користувача | ||
**Вкажіть роль «Адміністратор» і збережіть. | **Вкажіть роль «Адміністратор» і збережіть. | ||
*Надайте доступ до вашого застосунку, яке створювали на початку. Для цього натисніть кнопку «Додати | *Надайте доступ до вашого застосунку, яке створювали на самому початку. Для цього натисніть кнопку «Додати об'єкти»: | ||
https://p.pfx.so/pf/QS/a4CblC.png | https://p.pfx.so/pf/QS/a4CblC.png | ||
https://p.pfx.so/pf/dV/q1ac0S.png | https://p.pfx.so/pf/dV/q1ac0S.png | ||
*Тепер натисніть кнопку Створити новий маркер (Access Token): | *Тепер натисніть кнопку Створити новий маркер (Access Token): | ||
https://p.pfx.so/pf/Eu/7ZGgrB.png | https://p.pfx.so/pf/Eu/7ZGgrB.png | ||
*Вкажіть ваш застосунок. | *Вкажіть ваш застосунок. | ||
* | *Виберіть дозволи: whatsapp_business_messaging і whatsapp_business_management. | ||
*Згенеруйте маркер (Access Token), скопіюйте і збережіть його. | *Згенеруйте маркер (Access Token), скопіюйте і збережіть його. | ||
== Надання системному користувачу прав доступу до номера телефону == | == Надання системному користувачу прав доступу до номера телефону == | ||
*Увійдіть у налаштування [https://business.facebook.com/settings Meta Business Suite]. | *Увійдіть у налаштування [https://business.facebook.com/settings Meta Business Suite]. | ||
* | *Виберіть ваш бізнес-акаунт, у який додавали застосунок (1). | ||
*Потім | *Потім ліворуч у розділі «Акаунти» виберіть «Акаунти WhatsApp» (2) і виберіть ваш WhatsApp бізнес-акаунт (3). | ||
*Натисніть кнопку «Додати людей» (4): | *Натисніть кнопку «Додати людей» (4): | ||
https://p.pfx.so/pf/Pn/M163Yw.png | https://p.pfx.so/pf/Pn/M163Yw.png | ||
* | |||
*Виберіть створеного раніше системного користувача, надайте йому повні права доступу і збережіть налаштування. | |||
== Робота в тестовому режимі == | == Робота в тестовому режимі == | ||
*Відкрийте ваш застосунок | *Відкрийте ваш застосунок у [https://developers.facebook.com/ Meta for Developers]. | ||
*Скопіюйте ID акаунта WhatsApp Business (2) і тимчасовий токен (3), потім в інтеграції з Planfix додайте їх у відповідні поля. | *Скопіюйте ID акаунта WhatsApp Business (2) і тимчасовий токен (3), потім в інтеграції з Planfix додайте їх у відповідні поля. | ||
*Натисніть посилання «Оновити», щоб автоматично додати тестовий номер. | *Натисніть посилання «Оновити», щоб автоматично додати тестовий номер. | ||
| Рядок 85: | Рядок 91: | ||
https://p.pfx.so/pf/Jc/RdRL5b.png | https://p.pfx.so/pf/Jc/RdRL5b.png | ||
== Робота в | == Робота в бойовому режимі == | ||
*Відкрийте ваш застосунок | *Відкрийте ваш застосунок у [https://developers.facebook.com/ Meta for Developers]. | ||
*Скопіюйте ID акаунта WhatsApp Business. | *Скопіюйте ID акаунта WhatsApp Business. | ||
*Якщо номеру ще немає, додайте його кнопкою «Додати номер телефону». Вона розташована нижче на тій же сторінці. | *Якщо номеру ще немає, додайте його кнопкою «Додати номер телефону». Вона розташована трохи нижче на тій же сторінці. | ||
*Завершіть налаштування інтеграції, додавши постійний маркер (Access Token), який ви створювали від імені системного користувача, і натисніть посилання «Оновити». При правильних ID акаунта WhatsApp Business і Access Token підключені номери | *Завершіть налаштування інтеграції, додавши постійний маркер (Access Token), який ви створювали від імені системного користувача, і натисніть посилання «Оновити». При правильних ID акаунта WhatsApp Business і Access Token підключені номери повинні додатися автоматично. | ||
== Важливо == | == Важливо == | ||
Поточна версія на 13:26, 5 грудня 2025
Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з 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, використовуючи кнопки або сценарії.