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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показано 14 промежуточных версий этого же участника)
Строка 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
Строка 79: Строка 86:




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