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=planfix, WhatsApp, вотсап, інтеграції, пряма інтеграція з вотсап, пряма інтеграція
|keywords=Planfix, WhatsApp, вотсап, інтеграції, пряма інтеграція з вотсап, пряма інтеграція
|description=WhatsApp: пряма інтеграція
|description=WhatsApp: пряма інтеграція
}}
}}
У Planfix можна використовувати офіційну пряму [[Інтеграції|інтеграцію]] з 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 Дивитись відео на YouTube]
[https://youtu.be/eo7moR3Agbc Дивитися відео на YouTube]
 


== Встановлення вебхука і підписка на всі події ==
== Встановлення вебхука та підписка на всі події ==
*Увійдіть у створений додаток і додайте WhatsApp, натиснувши кнопку «Налаштувати».  
*Увійдіть у створений застосунок і додайте WhatsApp, натиснувши кнопку «Налаштувати».
*На панелі зліва виберіть «WhatsApp» — «Швидкий старт». Виберіть бізнес-акаунт Meta і натисніть кнопку «Далі»:
*На панелі зліва оберіть «WhatsApp» — «Швидкий старт». Виберіть бізнес-акаунт Meta і натисніть кнопку «Далі»:


https://p.pfx.so/pf/g9/oNBUZR.png
https://p.pfx.so/pf/g9/oNBUZR.png


 
*У вікні, що з’явиться, натисніть кнопку «Почати використовувати API»:
*У вікні, що з'явилося, натисніть кнопку «Почати використовувати API»:


https://p.pfx.so/pf/jj/SOmkjn.png
https://p.pfx.so/pf/jj/SOmkjn.png


 
*Перейдіть у меню зліва до вкладки «WhatsApp» — «Налаштування». Додайте Callback URL та Verify token, скопіювавши їх з інтеграції в Planfix:
*Перейдіть у меню зліва во вкладку «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.
*Виберіть дозволи: 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).
*Оберіть ваш бізнес-акаунт, в який додавали застосунок (1).
*Потім зліва в розділі «Акаунти» виберіть «Акаунти WhatsApp» (2) і виберіть ваш WhatsApp бізнес-акаунт (3).
*Потім зліва в розділі «Акаунти» оберіть «Акаунти 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].
*Відкрийте ваш застосунок в [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].
*Відкрийте ваш додаток в [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.
*Першим написати контакту через офіційну інтеграцію WhatsApp Cloud API не можна — такі правила самого WhatsApp.
*Через Planfix можна відправляти шаблонні повідомлення, які пройшли перевірку в WhatsApp, використовуючи [[Кнопки|кнопки]] або [[Автоматичні сценарії|сценарії]].
*Через Planfix можна надсилати шаблонні повідомлення, які пройшли перевірку в WhatsApp, використовуючи [[Кнопки|кнопки]] або [[Автоматичні сценарії|сценарії]].
 


== Перейти ==
== Перейти ==
*[[Інтеграції]]
*[[Інтеграції]]
*[[Опис можливостей]]
*[[Опис можливостей]]

Версія за 01:29, 1 грудня 2025

Інтеграція не підтримується. Використовуйте офіційну пряму інтеграцію з WhatsApp.


Зміст:

Створення застосунку

Перейдіть на сторінку Meta for Developers і створіть застосунок:

Дивитися відео на YouTube

Встановлення вебхука та підписка на всі події

  • Увійдіть у створений застосунок і додайте WhatsApp, натиснувши кнопку «Налаштувати».
  • На панелі зліва оберіть «WhatsApp» — «Швидкий старт». Виберіть бізнес-акаунт Meta і натисніть кнопку «Далі»:

oNBUZR.png

  • У вікні, що з’явиться, натисніть кнопку «Почати використовувати API»:

SOmkjn.png

  • Перейдіть у меню зліва до вкладки «WhatsApp» — «Налаштування». Додайте Callback URL та Verify token, скопіювавши їх з інтеграції в Planfix:

PmmFH0.png

  • Потім налаштуйте «Поля Webhook», оформивши підписку на всі поля:

EwcCyP.jpg

so5zWy.jpg

Створення системного користувача

Системний користувач необхідний для генерації Access Token. Він використовується при підключенні інтеграції в Planfix.

Процес створення системного користувача:

  • Увійдіть в Meta Business Suite.
  • Знайдіть свій бізнес-акаунт і у випадаючому меню в лівому верхньому куті натисніть значок шестерні «Налаштування».
  • Оберіть «Налаштування компанії».
  • Перейдіть у розділ «Користувачі» — «Системні користувачі».
  • Натисніть кнопку «Додати» і створіть системного користувача:
    • Додайте ім’я системного користувача
    • Вкажіть роль «Адміністратор» і збережіть.
  • Надайте доступ до вашого застосунку, яке створювали на початку. Для цього натисніть кнопку «Додати об’єкти»:

a4CblC.png

q1ac0S.png

  • Тепер натисніть кнопку Створити новий маркер (Access Token):

7ZGgrB.png

  • Вкажіть ваш застосунок.
  • Оберіть дозволи: whatsapp_business_messaging та whatsapp_business_management.
  • Згенеруйте маркер (Access Token), скопіюйте і збережіть його.

Надання системному користувачу прав доступу до номера телефону

  • Увійдіть у налаштування Meta Business Suite.
  • Оберіть ваш бізнес-акаунт, в який додавали застосунок (1).
  • Потім зліва в розділі «Акаунти» оберіть «Акаунти WhatsApp» (2) і виберіть ваш WhatsApp бізнес-акаунт (3).
  • Натисніть кнопку «Додати людей» (4):

M163Yw.png

  • Оберіть створеного раніше системного користувача, надайте йому повні права доступу і збережіть налаштування.

Робота в тестовому режимі

  • Відкрийте ваш застосунок в Meta for Developers.
  • Скопіюйте ID акаунта WhatsApp Business (2) і тимчасовий токен (3), потім в інтеграції з Planfix додайте їх у відповідні поля.
  • Натисніть посилання «Оновити», щоб автоматично додати тестовий номер.

RdRL5b.png

Робота в боєвому режимі

  • Відкрийте ваш застосунок в Meta for Developers.
  • Скопіюйте ID акаунта WhatsApp Business.
  • Якщо номеру ще немає, додайте його кнопкою «Додати номер телефону». Вона розташована нижче на тій же сторінці.
  • Завершіть налаштування інтеграції, додавши постійний маркер (Access Token), який ви створювали від імені системного користувача, і натисніть посилання «Оновити». При правильних ID акаунта WhatsApp Business і Access Token підключені номери мають додатися автоматично.

Важливо

  • Першим написати контакту через офіційну інтеграцію WhatsApp Cloud API не можна — такі правила самого WhatsApp.
  • Через Planfix можна надсилати шаблонні повідомлення, які пройшли перевірку в WhatsApp, використовуючи кнопки або сценарії.

Перейти