Расширение Facebook Business: подключение для обмена сообщениями

С помощью расширения Facebook Business (FBE) компании могут легко настраивать беседы со своими клиентами и управлять ими в любом масштабе на Facebook и в Instagram. В рамках процесса подключения расширения Facebook Business для обмена сообщениями компании могут настраивать и интегрировать следующие компоненты и функции:

Business Manager
Страница Facebook
аккаунт Instagram (если он уже связан со Страницей Facebook);
рекламный аккаунт;
чат Messenger (необязательно).

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

Пример: процесс подключения с платформы Facebook (через бизнес-приложения)

Прежде чем начать

Ваше приложение должно принадлежать аккаунту Business Manager, который связан с подтвержденной компанией. Узнайте, как подтвердить свою компанию.
Требуется приложение Facebook со следующими уровнями доступа, функциями и разрешениями:
- расширенный доступ;
- функция стандартного доступа к управлению рекламой;
- публичные разрешения: ads_management, ads_read, business_management, pages_manage_ads, pages_manage_metadata, pages_messaging, pages_show_list, page_events;
- частное разрешение manage_business_extension (для получения этого разрешения ваш представитель в Facebook должен добавить ваше приложение в список разрешенных).
Настройте аутентификацию с необходимыми параметрами и запустите процесс подключения расширения Facebook Business через вход от имени компании (на платформе партнера) или Бизнес-приложения (на Facebook).

Необходимые настройки

extras

Поле Тип Описание

Поле	Тип	Описание
`setup`	setup	Обязательный параметр. Настройки Facebook для продавца, например его уникальный идентификатор (`external_business_id`) или валюта каталога (`currency`). См. подробные сведения об объекте setup.
`business_config`	business_config	Обязательный параметр. Объект конфигурации, который используется расширением Facebook Business для настройки соответствующего рабочего процесса. См. подробные сведения об объекте `business_config`.
`repeat`	Логическое значение	Обязательный параметр. Установите значение `false`.

setup

setup

Обязательный параметр.

Настройки Facebook для продавца, например его уникальный идентификатор (external_business_id) или валюта каталога (currency). См. подробные сведения об объекте setup.

business_config

business_config

Обязательный параметр.

Объект конфигурации, который используется расширением Facebook Business для настройки соответствующего рабочего процесса. См. подробные сведения об объекте business_config.

repeat

Логическое значение

Обязательный параметр.

Установите значение false.

setup

Используйте этот объект для настройки параметров присутствия конечного пользователя на Facebook.

Поле	Описание
`external_business_id` Тип: строка	Обязательный параметр. Уникальный ID, представляющий компанию вашего клиента. Мы используем это значение в качестве уникального идентификатора. Например, если компания называется Fubar, значение `external_business_id` для нее может равняться fubar-123.
`timezone` Тип: строка	Обязательный параметр. Часовой пояс, в котором расположена компания. См. возможные значения часовых поясов.
`currency` Тип: строка	Обязательный параметр. Трехбуквенный ISO-код валюты по умолчанию для каталога продуктов компании. См. поддерживаемые коды валют.
`business_vertical` Тип: перечисление	Обязательный параметр. Отрасль, с которой связана компания. Значения: `MESSAGING`.
`channel` Тип: перечисление	Обязательный параметр. Позволяет партнеру настроить процесс расширения Facebook Business. Для процесса обмена сообщениями используйте значение `MESSAGING`. `MESSAGING` — процесс, позволяющий конечным пользователям создать или выбрать аккаунт Business Manager, рекламный аккаунт, Страницу Facebook и аккаунт Instagram. Настроив эти объекты, конечный пользователь сможет управлять переписками с клиентами в любом масштабе.
`business_manager_id` Тип: строка	Необязательный параметр. ID существующего аккаунта Business Manager пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`ad_account_id` Тип: строка	Необязательный параметр. ID существующего рекламного аккаунта пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`page_id` Тип: строка	Необязательный параметр. ID существующей Страницы Facebook пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.
`ig_profile_id` Тип: строка	Необязательный параметр. ID существующего профиля компании Instagram пользователя, который партнер может ввести, чтобы предварительно выбрать этого пользователя в процессе настройки.

business_config

Используйте этот объект для настройки параметров компании конечного пользователя. К ним относятся призывы к действию, карточка предлагаемых услуг и т. п. Каждое поле содержит свойство типа, связанное с соответствующими таблицами ниже.

Поле	Описание
`business` Тип: FBEBusinessPropertiesConfigData	Обязательный параметр. Информация для компании конечного пользователя.
`messenger_chat` Тип: FBEMessengerChatConfigData	Необязательный параметр. Функции чата Messenger на Странице Facebook конечного пользователя, такие как `enabled` и `domains`.
`messenger_menu` Тип: FBEMessengerMenuConfigData	Необязательный параметр. Параметры функции постоянного меню в Messenger, такие как `cta_button-text` и `cta_button_url`.

Дальнейшие действия

Настройте уведомления Webhooks о компаниях, которые устанавливают и удаляют расширение Facebook Business.
Инициируйте события пикселя для каждой компании, которая использует расширение Facebook Business на вашей платформе.
Добавьте точку входа в представление для управления функциями со своей платформы.
Разрешите компаниям удалять расширение Facebook Business.
Отправьте приложение на проверку интеграции расширения Facebook Business. После утверждения интеграции оно станет доступно обычным пользователям.