WhatsApp Cloud API: различия между версиями

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показаны 33 промежуточные версии этого же участника)
Строка 5: Строка 5:
|description=WhatsApp: прямая интеграция
|description=WhatsApp: прямая интеграция
}}
}}
В ПланФиксе можно использовать официальную прямую [[Интеграции |интеграцию]] с WhatsApp.
Содержание:
*[[#Создание приложения |Создание приложения]]
*[[#Установка вебхука и подписка на все события |Установка вебхука и подписка на все события]]
*[[#Создание системного пользователя |Создание системного пользователя]]
*[[#Предоставление системному пользователю прав доступа к номеру телефона |Предоставление системному пользователю прав доступа к номеру телефона]]
*[[#Работа в тестовом режиме |Работа в тестовом режиме]]
*[[#Работа в боевом режиме |Работа в боевом режиме]]
== Создание приложения ==
== Создание приложения ==
Перейдите на страницу [https://developers.facebook.com/ Meta for Developers] и создайте приложение:
<youtube width=460>https://youtu.be/eo7moR3Agbc</youtube>
<youtube width=460>https://youtu.be/eo7moR3Agbc</youtube>


Строка 23: Строка 37:




*Cкопируете ID номера телефона (1), затем ниже в поле «На» (2) добавьте те номера телефонов, с которых будут отправляться сообщения в WhatsApp на тестовый номер, который указан выше. Эти сообщения будут поступать в раздел «Диалоги» вашего приложения:
*Перейдите в меню слева во вкладку «WhatsApp» — «Настройка». Добавьте Callback URL и Verify token, скопировав их из интеграции в ПланФиксе:
 
https://p.pfx.so/pf/KP/PmmFH0.png
 
 
*Затем настройте «Поля Webhook», оформив подписку на '''все поля''':
 
https://p.pfx.so/pf/Mm/EwcCyP.jpg
 
https://p.pfx.so/pf/Wd/so5zWy.jpg
 
 
== Создание системного пользователя ==
Системный пользователь необходим для генерации Access Token. Он используется при подключении интеграции в ПланФиксе.
 
Процесс создания системного пользователя:
*Войдите в [https://business.facebook.com/ Meta Business Suite].
*Найдите свой бизнес-аккаунт и в раскрывающемся меню в левом верхнем углу нажмите значок шестеренки «Настройки».
*Выберите «Настройки компании».
*Перейдите в раздел «Пользователи» — «Системные пользователи».
*Нажмите кнопку «Добавить» и создайте системного пользователя:
**Добавьте имя системного пользователя
**Укажите роль «Администратор» и сохраните.
*Предоставьте доступ к вашему приложению, которое создавали в самом начале. Для этого нажмите кнопку «Добавить объекты»:
 
https://p.pfx.so/pf/QS/a4CblC.png
 
https://p.pfx.so/pf/dV/q1ac0S.png


https://p.pfx.so/pf/5V/UcWrYM.png


*Теперь нажмите кнопку Создать новый маркер (Access Token):


== Работа в тестовом режиме ==
https://p.pfx.so/pf/Eu/7ZGgrB.png
*Перейти на Getting started
 
*Скопировать оттуда WhatsApp Business Account ID: 115468054796966 и временный токен
 
*Укажите ваше приложение.
*Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.




== Работа в боевом режиме ==
== Предоставление системному пользователю прав доступа к номеру телефона ==
*Перейти на Getting started скопировать оттуда WhatsApp Business Account ID: 115468054796966
*Войдите в настройки [https://business.facebook.com/settings Meta Business Suite].
*Если номера еще не добавлены - добавить их по кнопке Add phone number внутри страницы
*Выберите ваш бизнес-аккаунт, в который добавляли приложение (1).
*Затем слева в разделе «Аккаунты» выберите «Аккаунты WhatsApp» (2) и выберите ваш WhatsApp бизнес-аккаунт (3).
*Нажмите кнопку «Добавить людей» (4):


=== Создать System user ===
https://p.pfx.so/pf/Pn/M163Yw.png


https://developers.facebook.com/blog/post/2022/12/05/auth-tokens/


Fortunately, the Meta for Developers platform makes this easy. All you need to do is add a System User to your business account to obtain an access token you can use to continue accessing the API. To create a system user, do the following:
*Выберите созданного ранее системного пользователя, предоставьте ему полные права доступа и сохраните настройки.


Go to Business Settings.


Select the business account your app is associated with.
== Работа в тестовом режиме ==
Below Users, click System Users.
*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].
Click Add.
*Скопируйте ID аккаунта WhatsApp Business (2) и временный токен (3), затем в интеграции с ПланФиксом добавьте их в соответствующие поля.
Name the system user, choose Admin as the user role, and click Create System User.
*Нажмите ссылку «Обновить», чтобы автоматически добавить тестовый номер.
Click Add Assets
Add Full Control to App https://i.imgur.com/ECgpWba.png
Click Generate New Token.
Select your App
Select the whatsapp_business_messaging AND whatsapp_business_management permissions.
Copy and save your token.


=== Дать ему права к номеру ===
https://p.pfx.so/pf/Jc/RdRL5b.png


Go to Business Settings.


Select the business account your app is associated with.
== Работа в боевом режиме ==
Below Accounts, click WhatsApp Accounts.
*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].  
Select WABA Account
*Скопируйте ID аккаунта WhatsApp Business.
Click Add people on People tab
*Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
Select created System User, select Full control and click Assign
*Завершите настройку интеграции, добавив постоянный маркер (Access Token), который вы создавали от имени системного пользователя, и нажмите ссылку «Обновить». При правильных ID аккаунта WhatsApp Business и Access Token подключенные номера должны добавиться автоматически.
 


=== Указать сохраненный ранее токен в ПФ - должны подтянуться номера ===
== Важно ==
*Первым написать контакту через официальную интеграцию WhatsApp Cloud API нельзя, таковы правила самого WhatsApp.
*Через ПланФикс можно отправлять шаблонные сообщения, которые прошли проверку в WhatsApp, используя [[Кнопки |кнопки]] или [[Автоматические сценарии |сценарии]].




== Перейти ==
== Перейти ==
*[[Интеграции]]
*[[Интеграции]]
*[[Описание возможностей]]

Текущая версия от 08:23, 15 мая 2023

В ПланФиксе можно использовать официальную прямую интеграцию с WhatsApp.


Содержание:


Создание приложения

Перейдите на страницу Meta for Developers и создайте приложение:

Смотреть видео на YouTube


Установка вебхука и подписка на все события

  • Войдите в созданное приложение и добавьте WhatsApp, нажав кнопку «Настроить».
  • На панели слева выберите «WhatsApp» — «Быстрый старт». Выберите бизнес-аккаунт Meta и нажмите кнопку «Далее»:

oNBUZR.png


  • В появившемся окне нажмите кнопку «Начать использовать API»:

SOmkjn.png


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

PmmFH0.png


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

EwcCyP.jpg

so5zWy.jpg


Создание системного пользователя

Системный пользователь необходим для генерации Access Token. Он используется при подключении интеграции в ПланФиксе.

Процесс создания системного пользователя:

  • Войдите в 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), затем в интеграции с ПланФиксом добавьте их в соответствующие поля.
  • Нажмите ссылку «Обновить», чтобы автоматически добавить тестовый номер.

RdRL5b.png


Работа в боевом режиме

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


Важно

  • Первым написать контакту через официальную интеграцию WhatsApp Cloud API нельзя, таковы правила самого WhatsApp.
  • Через ПланФикс можно отправлять шаблонные сообщения, которые прошли проверку в WhatsApp, используя кнопки или сценарии.


Перейти

Источник — http://planfix.com/ru/help/index.php?title=WhatsApp_Cloud_API&oldid=43056