WhatsApp Cloud API
Материал из Planfix
Создание приложения
Перейдите на страницу Meta for Developers и создайте приложение:
Установка вебхука и подписка на все события
- Войдите в созданное приложение и добавьте WhatsApp, нажав кнопку «Настроить».
- На панели слева выберите «WhatsApp» — «Быстрый старт». Выберите бизнес-аккаунт Meta и нажмите кнопку «Далее»:
- В появившемся окне нажмите кнопку «Начать использовать API»:
- Cкопируете ID номера телефона (1), затем ниже в поле «На» (2) добавьте те номера телефонов, с которых будут отправляться сообщения в WhatsApp на тестовый номер, который указан выше. Эти сообщения будут поступать в раздел «Диалоги» вашего приложения:
- Перейдите в меню слева во вкладку «WhatsApp» — «Настройка». Добавьте Callback URL и Verify token, скопировав их из интеграции в ПланФиксе:
- Затем настройте «Поля Webhook», оформив подписку на право messages:
Создание системного пользователя
Системный пользователь необходим для генерации Access Token. Он используется при подключении интеграции в ПланФиксе.
Процесс создания системного пользователя:
- Войдите в Meta Business Suite.
- Найдите свой бизнес-аккаунт и в раскрывающемся меню в левом верхнем углу нажмите значок шестеренки «Настройки».
- Выберите «Настройки компании».
- Перейдите в раздел «Пользователи» — «Системные пользователи».
- Нажмите кнопку «Добавить» и создайте системного пользователя:
- Добавьте имя системного пользователя
- Укажите роль «Администратор» и сохраните.
- Предоставьте доступ к вашему приложению, которое создавали в самом начале. Для этого нажмите кнопку «Добавить объекты»:
- Теперь нажмите кнопку Создать новый маркер (Access Token):
- Укажите ваше приложение.
- Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
- Сгенерируйте маркер (Access Token), скопируйте и сохраните его.
Предоставление системному пользователю прав доступа к номеру телефона
- Войдите в настройки Meta Business Suite.
- Выберите ваш бизнес-аккаунт, в который добавляли приложение (1).
- Затем слева в разделе «Аккаунты» выберите «Аккаунты WhatsApp» (2) и выберите ваш WhatsApp бизнес-аккаунт (3).
- Нажмите кнопку «Добавить людей» (4):
- Выберите созданного ранее системного пользователя, предоставьте ему полные права доступа и сохраните настройки.
Указать сохраненный ранее токен в ПФ - должны подтянуться номера
Работа в тестовом режиме
- Перейти на Getting started
- Скопировать оттуда WhatsApp Business Account ID: 115468054796966 и временный токен
Работа в боевом режиме
- Перейти на Getting started скопировать оттуда WhatsApp Business Account ID: 115468054796966
- Если номера еще не добавлены - добавить их по кнопке Add phone number внутри страницы