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

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


https://p.pfx.so/pf/jj/SOmkjn.png
https://p.pfx.so/pf/jj/SOmkjn.png
*Cкопируете ID номера телефона (1), затем ниже в поле «На» (2) добавьте те номера телефонов, с которых будут отправляться сообщения в WhatsApp на тестовый номер, который указан выше. Эти сообщения будут поступать в раздел «Диалоги» вашего приложения:
https://p.pfx.so/pf/5V/UcWrYM.png




Строка 35: Строка 42:




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


https://p.pfx.so/pf/Mm/EwcCyP.jpg
https://p.pfx.so/pf/Mm/EwcCyP.jpg
Строка 65: Строка 72:




*Укажите ваше приложение
*Укажите ваше приложение.
*Выберите доступные разрешения: whatsapp_business_messaging и whatsapp_business_management.
*Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.
*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.




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


Go to Business Settings.
https://p.pfx.so/pf/Pn/M163Yw.png


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


=== Указать сохраненный ранее токен в ПФ - должны подтянуться номера ===
*Выберите созданного ранее системного пользователя, предоставьте ему полные права доступа и сохраните настройки.
 


== Работа в тестовом режиме ==
== Работа в тестовом режиме ==
*Перейти на Getting started
*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].
*Скопировать оттуда WhatsApp Business Account ID: 115468054796966 и временный токен
*Скопируйте ID аккаунта WhatsApp Business (2) и временный токен (3), затем в интеграции с ПланФиксом добавьте их в соответствующие поля.
*Нажмите ссылку «Обновить», чтобы автоматически добавить тестовый номер.
 
https://p.pfx.so/pf/Jc/RdRL5b.png




== Работа в боевом режиме ==
== Работа в боевом режиме ==
*Перейти на Getting started скопировать оттуда WhatsApp Business Account ID: 115468054796966
*Откройте ваше приложение в [https://developers.facebook.com/ Meta for Developers].
*Если номера еще не добавлены - добавить их по кнопке Add phone number внутри страницы
*Скопируйте ID аккаунта WhatsApp Business.
*Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
*Завершите настройку интеграции, добавив постоянный маркер (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