Настройка интеграции с Facebook

Введение

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

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

Шаг 1: Создайте приложение Facebook

Создайте приложение Facebook

  1. Перейдите в https://developers.facebook.com и в правом верхнем углу нажмите “Log In”.
  2. Перейдите в “My Apps”.
  3. Нажмите “Create App”
  4. Выберите “Other” и нажмите "Next".
  5. Выберите “Business”.
  6. Присвойте приложению легкозапоминаемое имя и в выпадающем списке укажите свой бизнес-аккаунт. Нажмите “Create app“.
  7. Выберите “Messenger” и “Set up”.
  8. На следующем экране можно добавить продукты в ваше приложение. Прокрутите вниз до “Messenger” и нажмите “Messenger API Settings”.
  9. Прокрутите до секции ‘Access Tokens’ и нажмите “Connect”.
  10. Нажмите “Continue as (username)” и отметьте страницы, для которых нужно включить интеграцию.
  11. Нажмите “Next” ответьте на последующие сообщения.
  12. Ваша страница Facebook появится в секции ‘Access Tokens’.
  13. Нажмите “Generate token”. В появившемся окне выберите ‘I Understand’, зафиксируйте (скопируйте в блокнот) токен и нажмите “Done”.
  14. Затем зафиксируйте Page ID (он виден вверху, над названием страницы).

Шаг 2: Настройте интеграцию в 3CX

Настройте интеграцию в 3CX

  1. Зайдите в веб-клиент 3CX, перейдите в “Admin > Voice & chat” и нажмите “+Add Facebook”.
  2. Измените название по умолчанию на желаемое.
  3. Если ваша роль “System Owner” или “System Admin”, можно настроить дополнительную опцию ‘Department’:
  1. System wide - интеграция будет создана для всей системы (группа Default).
  2. Part of Group - интеграция будет создана только для выбранной группы.
  1. Вставьте ‘Page ID’ и ‘Access token’ из шага 1.
  2. Скопируйте 3CX Webhook и нажмите “Save”.
  3. Перейдите в раздел “Users”и создайте временного тестового пользователя, который будет использоваться проверки приложения в Шаге 4.
  4. Настройте маршрутизацию сообщений на вашего тестового пользователя. Подробнее см. в Руководстве по работе с вызовами.

Шаг 3: Настройте вебхук

Настройте вебхук

  1. Зайдите в портал Meta for Developers
  2. Перейдите в Apps > Select and Edit your app > Messenger API Settings > Configure Webhooks > нажмите Configure.
  3. Вставьте вебхук, сгенерированный 3CX, в секцию ‘Callback URL’.
  4. Для верификации токена введите случайную строку из букв и цифр. Она не потребуется вам в дальнейшем, поэтому сохранять ее не нужно. Нажмите “Verify and save”.
  5. Нажмите “Add subscriptions” и выберите следующие опции:
  • messages
  • message_deliveries
  • messaging_pre_checkouts
  • messaging_customer_information
  • message_reads
  • message_echoes
  1. Нажмите “Save”.

Теперь приложение настроено для работы с 3CX, и вы можете отправить сообщение со своей страницы Facebook. На этом этапе приложение находится в режиме 'Development' - можно взаимодействовать только с пользователями, имеющими разрешение на управление страницей. Чтобы перейти в режим 'Live', запросите дополнительные разрешения и выполните проверку приложения.

Шаг 4: Верифицируйте приложение

  1. В портале Meta for Developers перейдите в раздел “App Settings” > “Basic”, прокрутите вниз страницы и нажмите “+ Add platform”.
  2. Выберите “Website” и нажмите “Next”.
  3. Введите URL веб-клиента 3CX (например, https://exampledomain.com/webclient/) и нажмите “Save changes”.
  4. Перейдите в “App Review > Permissions and Features”.
  5. Найдите параметр ‘pages_messaging’ и нажмите “Request advanced access”.

Внимание! На этом этапе может потребоваться до 24 часов после отправки / получения тестовых сообщений в режиме Development, чтобы кнопка стала доступной.

  1. Найдите ‘Business Asset User Profile Access’ и снова нажмите “Request advanced access”. Нажмите на кнопку, которая теперь называется “Edit App review request”.
  2. Ознакомьтесь с информацией, прокрутите вниз до секции ‘Complete App Settings’ и нажмите на синюю стрелку.
  3. Добавьте иконку приложения, укажите URL политики конфиденциальности и в выпадающем списке выберите категорию приложения ‘Messaging’. Нажмите “Save”.
  4. В секции ‘Complete App Verification’ нажмите синюю стрелку.
  5. В появившемся окне выберите “No”, а также опции “My app doesn't use the Facebook Login dialog” и “Other”.
  6. Скопируйте и вставьте этот текст в окно сводки и нажмите “Save”.

This Facebook App is used to integrate the 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and will create their own App to integrate their Facebook Page. We need “pages_messaging” to receive and reply to messages started by a Facebook Page’s visitor. “Business Asset User Profile Access” is needed because it exposes the user's name and picture for identification of chat by agents. 3CX is using the name and picture attributes.

  1. Затем нажмите синюю стрелку в следующей секции с названием ‘How will your app use the advanced access page_messaging permission?’.
  2. Скопируйте и вставьте этот текст в первое окно ‘detailed description’.

This Facebook App is used to integrate the 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.

  1. Под ‘Test and reproduce the functionality of your integration’ в выпадающем списке выберите свою страницу Facebook. Измените текст, представленный ниже, добавив учетные данные временного тестового пользователя, созданного в Шаге 2.

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

PBX Web client URL: https://exampledomain:5001/webclient/

Extension: ________

Password: ________

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

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

  1. Теперь запишите скринкаст, показывающий отправку сообщения со страницы Facebook в веб-клиент и ответ из веб-клиента 3CX. Для записи экрана можно использовать утилиты Loom и Screenrec.
  2. После записи нажмите “Upload file” и выберите файл скринкаста.
  3. Ознакомьтесь с подтверждением и нажмите “Save”.
  4. Нажмите синюю стрелку в секции ‘How will your app use the advanced access Business asset user profile access feature?’.
  5. Скопируйте и вставьте текст ниже в поле подробного описания.

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 will create their own App to integrate their Facebook Page. 3CX needs “Business Asset User Profile Access” because it exposes the user's name and picture for identification of chat users by agents. 3CX is using the name and picture attributes.

  1. Еще раз загрузите скринкаст, который вы записали, установите галочку подтверждения и нажмите “Save”.
  2. Нажмите “Submit for Review” и введите пароль аккаунта Facebook для верификации - появится сообщение, подтверждающее успешную отправку вашего приложения.

Верифицируйте приложение

  1. Наконец, переключателем вверху страницы измените статус ‘App Mode’ приложения с ‘Development’ на ‘Live’.

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

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

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

Последнее обновление документа 4 декабря 2023

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