Перейти к основному содержимому

Настройка

После установки и активации модуля WhatsApp Cloud API Chat & Marketing необходимо настроить соединение между Perfex CRM и Meta WhatsApp Cloud API. Это включает создание приложения Meta, генерацию API-учётных данных, настройку webhook и конфигурацию параметров модуля.

Настройка приложения Meta​

Доступ к WhatsApp Cloud API осуществляется через приложение Meta (Facebook). Если вы ещё не создали его, выполните следующие шаги.

Шаг 1 — Создание аккаунта Facebook Developers​

  1. Перейдите на developers.facebook.com.
  2. Войдите с помощью аккаунта Facebook.
  3. При необходимости зарегистрируйтесь как разработчик, приняв условия и верифицировав аккаунт.

Шаг 2 — Создание приложения Meta​

  1. В панели Facebook Developers нажмите Create App.
  2. Выберите Business как тип приложения (или Other, если Business недоступен для вашего типа аккаунта).
  3. Введите App Name (например, "Perfex CRM WhatsApp") и контактный email.
  4. Выберите ваш Business Account (или создайте, если нужно).
  5. Нажмите Create App.

Шаг 3 — Добавление WhatsApp в приложение​

  1. На панели нового приложения найдите WhatsApp в списке продуктов и нажмите Set Up.
  2. Следуйте пошаговой настройке для привязки WhatsApp Business Account.
  3. Тестовый номер телефона предоставляется автоматически для разработки. Вы можете добавить свой верифицированный бизнес-номер позже.
к сведению

Тестовый номер телефона позволяет отправлять сообщения до 5 предварительно зарегистрированных номеров. Для продакшн-использования добавьте и верифицируйте свой бизнес-номер в настройках WhatsApp Business Account.

Шаг 4 — Генерация постоянного токена доступа​

Временный токен по умолчанию истекает через 24 часа. Для продакшна сгенерируйте постоянный токен System User:

  1. Перейдите на business.facebook.com и откройте Business Settings > System Users.
  2. Создайте нового System User (или используйте существующего) с доступом уровня Admin.
  3. Нажмите Generate New Token, выберите ваше приложение WhatsApp и предоставьте следующие разрешения:
    • whatsapp_business_messaging
    • whatsapp_business_management
  4. Скопируйте сгенерированный токен — это ваш постоянный токен доступа.
warning

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

Настройка Webhook​

Webhook позволяет WhatsApp уведомлять ваш экземпляр Perfex CRM о входящих сообщениях, квитанциях о доставке и обновлениях статуса в реальном времени.

Настройка Webhook​

  1. В панели Facebook Developers перейдите на страницу WhatsApp > Configuration вашего приложения.
  2. В разделе Webhook нажмите Edit.
  3. Введите Callback URL, предоставленный модулем (находится в WhatsApp Module > Settings в Perfex CRM). Обычно он имеет следующий формат: 
    https://your-perfex-domain.com/whatsapp_cloud_api/webhook
  4. Введите Verify Token, отображаемый в настройках модуля.
  5. Нажмите Verify and Save.
  6. Подпишитесь на следующие поля webhook:
    • messages
    • message_template_status_update
подсказка

Ваша установка Perfex CRM должна работать через HTTPS с действующим SSL-сертификатом. Meta отклонит URL webhook, использующие HTTP или имеющие недействительные/самоподписанные сертификаты.

Настройки модуля​

После завершения настройки приложения Meta настройте модуль в Perfex CRM.

  1. Перейдите к модулю WhatsApp Cloud API в боковой панели Perfex CRM.
  2. Откройте Settings и введите следующее:
НастройкаОписание
Access TokenПостоянный токен System User, сгенерированный выше
Phone Number IDНаходится на странице WhatsApp > Getting Started вашего приложения Meta
WhatsApp Business Account IDНаходится в настройках WhatsApp вашего приложения Meta
Webhook Verify TokenПроизвольная строка, которую вы определяете — должна совпадать с введённой при настройке webhook в Meta
App IDID вашего приложения Meta (находится на панели приложения)
  1. Нажмите Save Settings.
  2. Используйте кнопку Test Connection для проверки связи модуля с WhatsApp Cloud API.

Настройка встраивания​

Для расширенных конфигураций модуль поддерживает встраивание виджета чата WhatsApp на внешние страницы или клиентские порталы. Перейдите в WhatsApp Module > Settings > Embed для генерации кода встраивания и настройки внешнего вида виджета (цвета, позиция, приветственное сообщение).

Верификация бизнеса​

Для разблокировки полной ёмкости обмена сообщениями и доступа ко всем категориям шаблонов пройдите верификацию бизнеса Meta:

  1. Перейдите на business.facebook.com > Business Settings > Security Center.
  2. Нажмите Start Verification и следуйте пошаговому процессу.
  3. Предоставьте документы бизнеса по запросу Meta.
  4. Верификация обычно занимает 2-5 рабочих дней.
к сведению

Без верификации бизнеса ваш лимит обмена сообщениями ограничен 250 уникальными получателями в 24-часовом скользящем окне. После верификации лимиты постепенно увеличиваются в зависимости от качества и объёма сообщений.

Что дальше?​

  • Руководство по использованию — узнайте, как использовать интерфейс чата, запускать кампании, настраивать ботов и управлять шаблонами
  • Логи WhatsApp — просматривайте полные записи всех автоматизированных взаимодействий