Интеграция Facebook Messenger Custom для персонального использования
Для того чтобы настроить отправку уведомлений через Messenger, пользователь должен иметь подтвержденную учетную запись Facebook с e-mail и телефоном, созданное приложение Facebook и страницу Facebook в статусе “опубликована”.
Но чтобы все заработало, вам необходимо предварительно настроить интеграцию и разрешить подписку в свойствах нужного канала.
Если хотя бы один из этих пунктов не был настроен, на этапе подписки на канал вы увидите такое сообщение:
Шаг 1. Настройка интеграции
- Перейдите на экран Интеграции. Это можно сделать через выпадающее меню в верхнем правом углу экрана. Перед этим убедитесь, что вы залогинены в системе.
- Нажмите на кнопку Создать.
- Кликните по карточке Facebook Messenger Custom.
- Задайте собственное название интеграции при необходимости и введите Page Access Token. Чтобы его получить, на портале Meta для Разработчиков (бывш. Facebook для Разработчиков) выберите нужное приложение и пройдите следующий путь: Messenger>Настройки>Маркеры доступа.
- Поставьте галочку напротив поля Обрабатывать входящие сообщения (и позволять подписываться через интерфейс Notify.Events).
- Персональный Incoming Message URL будет сформирован автоматически. Его необходимо вставить в в поле URL обратного вызовы в настройках страницы Facebook в интерфейсе Meta for Developers: Приложение>Messenger>Настройки>Webhooks.
- Далее заполните поле Page User Name. Если у страницы уже задан юзернэйм, вы найдете его в настройках страницы: Страница>Настройки>Информация о Странице>Имя пользователя. Либо просто скопируйте ID страницы из ее URL.
- Введите произвольный набор цифр и/или букв в поле Verify Token. Поле Verify Token в интерфейсе Notify.Events и поле Маркер подтверждения в интерфейсе Facebook (Приложение>Messenger>Настройки>Webhooks) должны совпадать.
- После нажатия на кнопку Сохранить созданная интеграция появится на экране Интеграции.
Шаг 2. Разрешение подписки
- Перейдите в свойства канала через кнопку Редактировать на главном экране Панели управления или на экране канала.
- Поставьте галочку напротив Facebook Messenger Custom в поле Разрешить подписку через интеграцию и нажмите кнопку Сохранить. Facebook Messenger Custom будет отображаться в этом поле только после успешного выполнения Шага 1.
На следующем этапе вы сможете добавить кастомную интеграцию на канал.
Шаг 3. Добавление кастомной интеграции на канал
После того, как вы настроили интеграцию Facebook Messenger Custom и разрешили подписку, вы сможете добавить ее на выбранный канал в качестве получателя.
Для этого:
- На экране канала нажмите кнопку Подписаться в разделе Получатели.
- На экране Подписка на канал выберите Facebook Messenger Custom.
- Нажмите на кнопку, чтобы добавить бота в свой список контактов.
- После этого в новом окне автоматически откроется диалог с вашим ботом. Авторизуйтесь в Messenger через аккаунт Facebook, под которым были созданы бот и страница.
- Скопируйте команду подписки и отправьте ее в диалог. Вы можете изменить язык на русский, отправив команду locale ru.
Готово! Теперь подписка появится в разделе Получатели на экране канала, и вы будете получать уведомления из заданных сервисов в Messenger.
Настройка приложения и страницы Facebook
Как создать приложение (бота) Facebook?
- Зайдите или зарегистрируйтесь на портале Meta для Разработчиков (бывш. Facebook для Разработчиков) с помощью своего аккаунта Facebook.
- На экране Приложения нажмите кнопку Создать Приложение.
- Выберите тип приложения Другое и нажмите Далее.
- Введите название вашего приложения в поле Отображаемое название и проверьте ваш контактный email в соответствующем поле. Указывать Бизнес-аккаунт необязательно. После этого нажмите на кнопку Создание приложения.
- На открывшемся экране нажмите кнопку Настроить в карточке Messenger.
Поздравляем! Вы создали свой собственный бот FB Messenger. Теперь вам нужно создать страницу и привязать ее к боту, чтобы начать им пользоваться.
Как создать страницу Facebook и привязать ее к боту?
- На панели управления приложением выберите в правом боковом меню Messenger>Настройки. Прокрутите экран вниз до раздела Маркеры доступа и нажмите кнопку Создать новую Страницу.
- В новом окне введите название страницы в поле Название страницы и выберите подходящую категорию в поле Категория. Заполнять поле Описание необязательно. Затем нажмите кнопку Создать Страницу, а после получения сообщения об успешном создании – кнопку Сохранить.
- На открывшемся главном экране страницы выберите в левом боковом меню Настройки.
- В разделе Информация о Странице введите юзернейм для страницы в поле Имя пользователя. Этот шаг необязателен.
- Вернитесь на окно приложения и нажмите кнопку Добавить или удалить Страницы в разделе Маркеры доступа, чтобы привязать только что созданную страницу.
- Выберите созданную страницу из списка и нажмите Далее.
- Убедитесь, что бегунок в строчке Доступ к перепискам от имени Страницы в Messenger и управление ими выставлен на ДА, и нажмите кнопку Готово, а затем OK в новом открывшемся окне.
- Снова вернитесь на экран приложения и в разделе Webhooks нажмите кнопку Добавить URL обратного вызова. На этом этапе для получения URL обратного вызова и Маркера подтверждения вам потребуется перейти в интерфейс Notify.Events.
- На странице Интеграции создайте интеграцию Facebook Messenger Custom через кнопку Создать.
- В поле Page Access Token временно введите произвольный набор букв и/или цифр. Поставьте галочку напротив поля Обрабатывать входящие сообщения (и позволять подписываться через интерфейс Notify.Events). В поле Page User Name введите название созданной страницы. Если вы не создавали юзернейм, используйте ID страницы из ее URL. В поле Verify Token введите произвольный набор цифр и/или букв. Нажмите кнопку Сохранить.
- Скопируйте автоматически сформированную ссылку из поля Incoming Message Url и вставьте в поле URL обратного вызова. В поле Маркер подтверждения в Facebook введите токен, который вы ввели в поле Verify Token в Notify.Events. Затем нажмите кнопку Подтвердить и сохранить.
- На экране приложения в разделе Webhooks нажмите кнопку Добавить подписки.
- В открывшемся окне поставьте галочки рядом со строчками messages и messaging_postbacks и нажмите кнопку Сохранить.
- На экране приложения в разделе Маркеры доступа нажмите кнопку Сгенерировать маркер.
- В открывшемся окне поставьте галочку напротив Я понимаю.
- Скопируйте полученный токен и вставьте в поле Page Access Token в настройках интеграции Facebook Messenger Custom в интерфейсе Notify.Events. Нажмите кнопку Сохранить, чтобы завершить настройку интеграции. В интерфейсе Facebook нажмите кнопку Готово.
Ура, вы создали страницу для вашего бота Messenger! Теперь вы можете вернуться наверх к инструкции и настроить интеграцию Facebook Messenger Custom, чтобы начать получать уведомления через ваш бот Messenger.
- Начало работы
-
Использование сервиса
- Каналы
- Источники
- Получатели
- Интеграции
- Аккаунт
-
Продвинутый функционал
- API
- Кастомные интеграции