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

Материал из Planfix
Перейти к: навигация, поиск
Нет описания правки
Нет описания правки
 
(не показаны 3 промежуточные версии этого же участника)
Строка 5: Строка 5:
|description=WhatsApp: прямая интеграция
|description=WhatsApp: прямая интеграция
}}
}}
В ПланФиксе можно использовать официальную прямую [[Интеграции |интеграцию]] с WhatsApp.
<div style="background:#ffbaba;padding:10px;border:1px solid #ff9b9b;">Интеграция не поддерживается. Используйте официальную прямую интеграцию с [[WhatsApp]].</div>




Строка 15: Строка 15:
*[[#Работа в тестовом режиме |Работа в тестовом режиме]]
*[[#Работа в тестовом режиме |Работа в тестовом режиме]]
*[[#Работа в боевом режиме |Работа в боевом режиме]]
*[[#Работа в боевом режиме |Работа в боевом режиме]]


== Создание приложения ==
== Создание приложения ==
Строка 23: Строка 22:


[https://youtu.be/eo7moR3Agbc Смотреть видео на YouTube]
[https://youtu.be/eo7moR3Agbc Смотреть видео на YouTube]


== Установка вебхука и подписка на все события ==
== Установка вебхука и подписка на все события ==
Строка 47: Строка 45:


https://p.pfx.so/pf/Wd/so5zWy.jpg
https://p.pfx.so/pf/Wd/so5zWy.jpg


== Создание системного пользователя ==
== Создание системного пользователя ==
Строка 75: Строка 72:
*Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
*Выберите разрешения: whatsapp_business_messaging и whatsapp_business_management.
*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.
*Сгенерируйте маркер (Access Token), скопируйте и сохраните его.


== Предоставление системному пользователю прав доступа к номеру телефона ==
== Предоставление системному пользователю прав доступа к номеру телефона ==
Строка 87: Строка 83:


*Выберите созданного ранее системного пользователя, предоставьте ему полные права доступа и сохраните настройки.
*Выберите созданного ранее системного пользователя, предоставьте ему полные права доступа и сохраните настройки.


== Работа в тестовом режиме ==
== Работа в тестовом режиме ==
Строка 95: Строка 90:


https://p.pfx.so/pf/Jc/RdRL5b.png
https://p.pfx.so/pf/Jc/RdRL5b.png


== Работа в боевом режиме ==
== Работа в боевом режиме ==
Строка 102: Строка 96:
*Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
*Если номера еще нет, добавите его по кнопке «Добавить номер телефона». Она расположена ниже на этой же странице.
*Завершите настройку интеграции, добавив постоянный маркер (Access Token), который вы создавали от имени системного пользователя, и нажмите ссылку «Обновить». При правильных ID аккаунта WhatsApp Business и Access Token подключенные номера должны добавиться автоматически.
*Завершите настройку интеграции, добавив постоянный маркер (Access Token), который вы создавали от имени системного пользователя, и нажмите ссылку «Обновить». При правильных ID аккаунта WhatsApp Business и Access Token подключенные номера должны добавиться автоматически.


== Важно ==
== Важно ==
*Первым написать контакту через официальную интеграцию WhatsApp Cloud API нельзя, таковы правила самого WhatsApp.
*Первым написать контакту через официальную интеграцию WhatsApp Cloud API нельзя, таковы правила самого WhatsApp.
*Через ПланФикс можно отправлять шаблонные сообщения, которые прошли проверку в WhatsApp, используя [[Кнопки |кнопки]] или [[Автоматические сценарии |сценарии]].
*Через ПланФикс можно отправлять шаблонные сообщения, которые прошли проверку в WhatsApp, используя [[Кнопки |кнопки]] или [[Автоматические сценарии |сценарии]].


== Перейти ==
== Перейти ==
*[[Интеграции]]
*[[Интеграции]]
*[[Описание возможностей]]
*[[Описание возможностей]]

Текущая версия от 12:23, 30 сентября 2025

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

Перейти