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

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

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

Содержание:

Создание приложения
Установка вебхука и подписка на все события
Создание системного пользователя
Предоставление системному пользователю прав доступа к номеру телефона
Работа в тестовом режиме
Работа в боевом режиме

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Важно

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

@@ Строка 5: / Строка 5: @@
 |description=WhatsApp: прямая интеграция
 }}
+В ПланФиксе можно использовать официальную прямую [[Интеграции |интеграцию]] с WhatsApp.
+Содержание:
+*[[#Создание приложения |Создание приложения]]
+*[[#Установка вебхука и подписка на все события |Установка вебхука и подписка на все события]]
+*[[#Создание системного пользователя |Создание системного пользователя]]
+*[[#Предоставление системному пользователю прав доступа к номеру телефона |Предоставление системному пользователю прав доступа к номеру телефона]]
+*[[#Работа в тестовом режиме |Работа в тестовом режиме]]
+*[[#Работа в боевом режиме |Работа в боевом режиме]]
 == Создание приложения ==
+Перейдите на страницу [https://developers.facebook.com/ Meta for Developers] и создайте приложение:
 <youtube width=460>https://youtu.be/eo7moR3Agbc</youtube>
@@ Строка 11: / Строка 25: @@
-== Установка вебхука и subscribe на все события ==
+== Установка вебхука и подписка на все события ==
 *Войдите в созданное приложение и добавьте WhatsApp, нажав кнопку «Настроить».
-*На панели слева выберите «WhatsApp» — «Первые шаги»:
+*На панели слева выберите «WhatsApp» — «Быстрый старт». Выберите бизнес-аккаунт Meta и нажмите кнопку «Далее»:
 https://p.pfx.so/pf/g9/oNBUZR.png
+*В появившемся окне нажмите кнопку «Начать использовать API»:
+https://p.pfx.so/pf/jj/SOmkjn.png
+*Перейдите в меню слева во вкладку «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
+*Теперь нажмите кнопку Создать новый маркер (Access Token):
+https://p.pfx.so/pf/Eu/7ZGgrB.png
+*Укажите ваше приложение.
+*Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
+*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.
-== Работа в тестовом режиме ==
-*Перейти на Getting started
-*Скопировать оттуда WhatsApp Business Account ID: 115468054796966 и временный токен
+== Предоставление системному пользователю прав доступа к номеру телефона ==
+*Войдите в настройки [https://business.facebook.com/settings Meta Business Suite].
+*Выберите ваш бизнес-аккаунт, в который добавляли приложение (1).
+*Затем слева в разделе «Аккаунты» выберите «Аккаунты WhatsApp» (2) и выберите ваш WhatsApp бизнес-аккаунт (3).
+*Нажмите кнопку «Добавить людей» (4):
-== Работа в боевом режиме ==
+https://p.pfx.so/pf/Pn/M163Yw.png
-*Перейти на Getting started скопировать оттуда WhatsApp Business Account ID: 115468054796966
-*Если номера еще не добавлены - добавить их по кнопке Add phone number внутри страницы
-=== Создать System user ===
-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.
+== Работа в тестовом режиме ==
+*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].
+*Скопируйте ID аккаунта WhatsApp Business (2) и временный токен (3), затем в интеграции с ПланФиксом добавьте их в соответствующие поля.
+*Нажмите ссылку «Обновить», чтобы автоматически добавить тестовый номер.
-Select the business account your app is associated with.
+https://p.pfx.so/pf/Jc/RdRL5b.png
-Below Users, click System Users.
-Click Add.
-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.
-=== Дать ему права к номеру ===
-Go to Business Settings.
+== Работа в боевом режиме ==
+*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].
+*Скопируйте ID аккаунта WhatsApp Business.
+*Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
+*Завершите настройку интеграции, добавив постоянный маркер (Access Token), который вы создавали от имени системного пользователя, и нажмите ссылку «Обновить». При правильных ID аккаунта WhatsApp Business и Access Token подключенные номера должны добавиться автоматически.
-Select the business account your app is associated with.
-Below Accounts, click WhatsApp Accounts.
-Select WABA Account
-Click Add people on People tab
-Select created System User, select Full control and click Assign
-=== Указать сохраненный ранее токен в ПФ - должны подтянуться номера ===
+== Важно ==
+*Первым написать контакту через официальную интеграцию WhatsApp Cloud API нельзя, таковы правила самого WhatsApp.
+*Через ПланФикс можно отправлять шаблонные сообщения, которые прошли проверку в WhatsApp, используя [[Кнопки |кнопки]] или [[Автоматические сценарии |сценарии]].
 == Перейти ==
 *[[Интеграции]]
+*[[Описание возможностей]]