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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
Строка 8: Строка 8:


Содержание:
Содержание:
*[[Создание приложения]]
*[[#Создание приложения |Создание приложения]]
*[[Установка вебхука и подписка на все события]]
*[[Установка вебхука и подписка на все события]]
*[[Создание системного пользователя]]
*[[Создание системного пользователя]]

Версия от 09:25, 6 апреля 2023

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

Содержание:


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

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

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


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

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

oNBUZR.png


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

SOmkjn.png


  • Cкопируете ID номера телефона (1), затем ниже в поле «На» (2) добавьте те номера телефонов, с которых будут отправляться сообщения в WhatsApp на тестовый номер, который указан выше. Эти сообщения будут поступать в раздел «Диалоги» вашего приложения:

UcWrYM.png


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

PmmFH0.png


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

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.
  • Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.


Перейти