WhatsApp Cloud API: відмінності між версіями
Матеріал з Planfix
(Створена сторінка: {{#seo: |title=WhatsApp: пряма інтеграція |titlemode=append |keywords=planfix, WhatsApp, вотсап, інтеграції, пряма інтеграція з вотсап, пряма інтеграція |description=WhatsApp: пряма інтеграція }} У Planfix можна використовувати офіційну пряму інтеграцію з WhatsApp. Зміст: *#Создание при...) |
Немає опису редагування |
||
| Рядок 2: | Рядок 2: | ||
|title=WhatsApp: пряма інтеграція | |title=WhatsApp: пряма інтеграція | ||
|titlemode=append | |titlemode=append | ||
|keywords= | |keywords=Planfix, WhatsApp, вотсап, інтеграції, пряма інтеграція з вотсап, пряма інтеграція | ||
|description=WhatsApp: пряма інтеграція | |description=WhatsApp: пряма інтеграція | ||
}} | }} | ||
<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з [[WhatsApp]].</div> | |||
Зміст: | Зміст: | ||
*[[#Создание приложения|Створення | *[[#Создание приложения|Створення застосунку]] | ||
*[[#Установка вебхука и подписка на все события|Встановлення вебхука | *[[#Установка вебхука и подписка на все события|Встановлення вебхука та підписка на всі події]] | ||
*[[#Создание системного пользователя|Створення системного користувача]] | *[[#Создание системного пользователя|Створення системного користувача]] | ||
*[[#Предоставление системному пользователю прав доступа к номеру телефона|Надання системному користувачу прав доступу до номера телефону]] | *[[#Предоставление системному пользователю прав доступа к номеру телефона|Надання системному користувачу прав доступу до номера телефону]] | ||
*[[#Работа в тестовом режиме|Робота в тестовому режимі]] | *[[#Работа в тестовом режиме|Робота в тестовому режимі]] | ||
*[[#Работа в боевом режиме|Робота в | *[[#Работа в боевом режиме|Робота в боєвому режимі]] | ||
== Створення застосунку == | |||
== Створення | Перейдіть на сторінку [https://developers.facebook.com/ Meta for Developers] і створіть застосунок: | ||
Перейдіть на сторінку [https://developers.facebook.com/ Meta for Developers] і створіть | |||
<youtube width=460>https://youtu.be/eo7moR3Agbc</youtube> | <youtube width=460>https://youtu.be/eo7moR3Agbc</youtube> | ||
[https://youtu.be/eo7moR3Agbc | [https://youtu.be/eo7moR3Agbc Дивитися відео на YouTube] | ||
== Встановлення вебхука | == Встановлення вебхука та підписка на всі події == | ||
*Увійдіть у створений | *Увійдіть у створений застосунок і додайте 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», оформивши підписку на '''всі поля''': | ||
| Рядок 47: | Рядок 42: | ||
https://p.pfx.so/pf/Wd/so5zWy.jpg | https://p.pfx.so/pf/Wd/so5zWy.jpg | ||
== Створення системного користувача == | == Створення системного користувача == | ||
Системний користувач необхідний для генерації Access Token. Він використовується при підключенні інтеграції в Planfix. | Системний користувач необхідний для генерації Access Token. Він використовується при підключенні інтеграції в Planfix. | ||
Процес створення системного користувача: | Процес створення системного користувача: | ||
*Увійдіть в [https://business.facebook.com/ Meta Business Suite]. | *Увійдіть в [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): | ||
| Рядок 71: | Рядок 64: | ||
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]. | ||
* | *Оберіть ваш бізнес-акаунт, в який додавали застосунок (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 додайте їх у відповідні поля. | ||
*Натисніть посилання «Оновити», щоб автоматично додати тестовий номер. | *Натисніть посилання «Оновити», щоб автоматично додати тестовий номер. | ||
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 підключені номери мають додатися автоматично. | ||
== Важливо == | == Важливо == | ||
*Першим написати контакту через офіційну інтеграцію WhatsApp Cloud API | *Першим написати контакту через офіційну інтеграцію WhatsApp Cloud API не можна — такі правила самого WhatsApp. | ||
*Через Planfix можна | *Через Planfix можна надсилати шаблонні повідомлення, які пройшли перевірку в WhatsApp, використовуючи [[Кнопки|кнопки]] або [[Автоматичні сценарії|сценарії]]. | ||
== Перейти == | == Перейти == | ||
*[[Інтеграції]] | *[[Інтеграції]] | ||
*[[Опис можливостей]] | *[[Опис можливостей]] | ||
Версія за 01:29, 1 грудня 2025
Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з 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, використовуючи кнопки або сценарії.