WhatsApp Cloud API

Материал из Planfix
Версия от 08:23, 15 мая 2023; Artem (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)
Перейти к: навигация, поиск

В ПланФиксе можно использовать официальную прямую интеграцию с 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, используя кнопки или сценарии.


Перейти