Настройка Facebook Messenger для 3CX

Введение

Интеграция с Facebook позволяет вашим операторам отвечать на сообщения со страницы Facebook непосредственно из 3CX, не входя в Facebook Messenger. Сообщения могут доставляться в очередь вызовов, группу вызовов или на отдельный добавочный номер. Операторы могут принимать сообщение на себя или передавать его другому оператору / группе.

Для настройки требуется верифицированный аккаунт Facebook Business.

Данное руководство соответствует обновлению процесса создания приложений Meta 2026 года с упрощенными параметрами разрешений.

Шаг 1. Начало настройки в АТС 3CX

  • Войдите в веб-клиент 3CX, перейдите в Admin → Voice & Chat и нажмите  + Add Messaging → Add Facebook.
  • Укажите желаемое имя.
  • Если вы являетесь владельцем системы (System Owner) или системным администратором (System Admin),вы можете сделать интеграцию доступной для всей системы или только для определенной группы.

  • Скопируйте 3CX Webhook URL в текстовый редактор и сохраните его для дальнейшего использования.

Шаг 2: Создание приложения Facebook

  • Перейдите в My Apps.
  • Нажмите Create App.
  • Дайте приложению отображаемое имя, введите контактный e-mail и нажмите Next.
  • Выберите опцию Business messaging.

  • Выберите опцию "Messenger from Meta" и нажмите Next.
  • Выберите бизнес-портфолио (business portfolio), к которому нужно подключить это приложение; вы можете добавить его позже.
  • Если у Meta есть другие требования для публикации (Publishing requirements), которые необходимо выполнить перед продолжением, они будут перечислены на этом этапе.
  • Нажмите Next.

  • Перед созданием приложения убедитесь, что его имя, контактный адрес электронной почты и другие данные указаны верно, после чего нажмите Create app.
  • Подтвердите свой пароль, если потребуется.

  • Следующий экран — панель управления приложением (App Dashboard):
  • Здесь отображается список задач, которые необходимо выполнить перед публикацией.
  • Убедитесь, что все обязательные задачи выполнены.
  • В случае выхода из портала разработчиков Facebook, вы можете вернуться к этому шагу через пункт меню ”Use Cases" (значок карандаша).
  • Выберите опцию Customise:
  • Выберите Messenger API Settings.

  • Разверните Configure webhooks:
  • Введите Webhook, сохраненный на Шаге 1, в поле Callback URL.
  • Введите длинную строку после последнего "/" (например, aabbccddeeff000000001122334455) в конце вебхука в поле "Verify token".

  • Прокрутите вниз и добавьте необходимые поля вебхука (Webhook fields), используя последнюю доступную версию API:
  • messages
  • message_deliveries
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Нажмите Verify and save.

  • Разверните Generate access tokens:
  • Нажмите "Add a Page":
  • Пройдите процесс аутентификации и выберите бизнес-страницу (Business page), которую хотите добавить.
  • После добавления страницы запишите Facebook Page ID.
  • Выберите пункт меню Add Webhook Subscriptions и добавьте:

  • messages
  • message_deliveries
  • messaging_pre_checkouts
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Нажмите Generate, чтобы получить токен API (API token), и сохраните его.
  • При возврате на эту страницу вы можете навести курсор на Subscriptions, чтобы появилась опция Edit.
  • На данный момент НЕ переходите к завершению проверки приложения (Complete App Review).

Шаг 3: Продолжение настройки в 3CX

  • Перейдите в раздел Users и создайте временного тестового пользователя, который будет использоваться для процесса проверки приложения на Шаге 4 ниже.
  • Вставьте Page ID и Access token, полученные на Шаге 2.
  • Убедитесь, что маршрутизация сообщений настроена на нового временного тестового пользователя.

Шаг 4. Режим разработки

Теперь ваше приложение настроено для работы с 3CX, и вы можете попробовать отправить сообщение на вашу страницу Facebook.

На данном этапе приложение находится в режиме разработки (Development mode). Это означает, что вы можете взаимодействовать только с:

  • пользователями, у которых есть разрешение на управление вашей страницей;
  • пользователями, добавленными в качестве тестировщиков.

Добавить дополнительных тестовых пользователей можно в разделе App Dashboard > Roles > App roles > Add People.

В режиме разработки в 3CX будет отображаться только числовой ID пользователя Facebook. Для отображения полного имени пользователя необходимо переключиться в рабочий режим ("Live").

Чтобы переключиться в режим "Live", необходимо запросить дополнительные разрешения и пройти процедуру проверки приложения — подробности приведены в шаге "Проверка приложения" (Application Review).

Шаг 5. Проверка приложения

  • На панели управления приложением Meta App Settings > Basic.

  • Заполните обязательные поля:
  • Privacy policy URL
  • User data deletion URL (может совпадать с Privacy policy URL)
  • Category (выберите Messaging или Business)
  • Загрузите значок приложения (App icon)
  • В зависимости от вашего региона и сферы деятельности может потребоваться заполнить раздел GDPR под основными настройками.
  • Нажмите + Add platform в нижней части страницы.
  • Введите URL-адрес вашего веб-сайта и нажмите Next.

  • Введите URL-адрес вашей АТС 3CX, например, https://mypbx.3cx-example.com.
  • Нажмите Save Changes.
  • В боковом меню выберите Use cases (значок карандаша).
  • Нажмите Customize и добавьте разрешение Business Asset User Profile access.
  • Выберите Messenger API Settings.
  • Нажмите Customize use case.
  • В разделе "Permissions and features" добавьте Business Asset User Profile Access.

  • Нажмите кнопку Request permission:

  • Выберите опции pages_show_list и pages_manage_metadata; нажмите кнопку Request permission. Вы будете перенаправлены на страницу Submit for App Review".
  • Откройте АТС 3CX и войдите под учетной записью тестового пользователя (или используйте функцию входа от имени пользователя); перейдите в раздел Chat веб-клиента.
  • Откройте подключенную страницу Facebook, используя учетную запись с правами тестировщика для данного приложения.
  • Расположите два окна рядом друг с другом и начните запись экрана; это необходимо для проверки и верификации со стороны Facebook.
  • Проведите короткий диалог в чате и сохраните видео.
  • Вернитесь на страницу Submit for App Review в Facebook и нажмите Next.

  • Выполните все шаги, заполняя необходимые данные, пока не дойдете до раздела Reviewer instructions. Для продолжения работы у вас должен быть верифицированный аккаунт.

  • На странице Reviewer instructions:
  • Подтвердите URL-адрес вашего сайта.
  • Заполните поля с вопросами следующим образом (вставляйте текст на английском языке, как указано ниже):
  • (instructions-web-2) Provide instructions for accessing the app so we may complete our review.

This Facebook App is used to integrate a 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and therefore will need to create their own App to integrate a Facebook Page. pages_messaging is required to receive and send messages started by a Facebook Page visitor.

Step 1. Log in to the 3CX WebClient with the following credentials:

  • PBX Web client URL: https://example-pbx.3cx.com/

Step 2. Write and send a test message on the Facebook Page.

Step 3. Receive and reply to the message in your 3CX Web Client.

  • (accesscode-web-1) If payment or membership is required to access the full functionality of this app:
  • Extension: ________
  • Password: ________
  • (documents-web-1) Include supporting documentation:
  • Загрузите ранее записанное видео.
  • Нажмите Next.
  • После заполнения всех разделов можно отправить приложение на проверку.

Приложение можно опубликовать с помощью кнопки Publish в боковом меню. Если вы опубликуете приложение до его одобрения, вы сможете получать сообщения, однако в них не будет отображаться имя отправителя и другие данные.

После одобрения вашего приложения вы начнете получать сообщения от пользователей Facebook с корректным отображением имени отправителя. Убедитесь, что вы удалили временного тестового пользователя, созданного для процесса верификации приложения, и обновите маршрутизацию сообщений на нужное рабочее направление.

Дополнительная информация

Версия документа

Последнее обновление документа 6 августа 2026

https://www.3cx.ru/docs/manual/facebook/