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