WhatsApp Cloud API
Материал из Planfix
В ПланФиксе можно использовать официальную прямую интеграцию с WhatsApp.
Содержание:
- Создание приложения
- Установка вебхука и подписка на все события
- Создание системного пользователя
- Предоставление системному пользователю прав доступа к номеру телефона
- Работа в тестовом режиме
- Работа в боевом режиме
Создание приложения
Перейдите на страницу Meta for Developers и создайте приложение:
Установка вебхука и подписка на все события
- Войдите в созданное приложение и добавьте 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.
- Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
Важно
Завершив настройку интеграции, нажмите ссылку «Обновить». При правильных ID аккаунта WhatsApp Business и Access Token подключенные номера должны добавиться автоматически.