Боты для Facebook. Настройка.
Всем привет, на связи Вадим Львов, поговорим сегодня о создании бота для Facebook.
Процесс создания бота для Facebook чем-то напоминает создание бота для VK. Для начала нужно создать страницу Facebook, т.к. бот будет работать от имени страницы и пользователи должны добавлять эту страницу в переписку, чтобы взаимодействовать с ботом. В переписке с вашим ботом пользователи будут видеть название и фото профиля вашей Страницы. Создать новую Страницу можно здесь: https://www.facebook.com/pages/create
Следующее, что необходимо - это аккаунт разработчика Facebook. Он необходим для создания новых приложений. Вы можете создать новый аккаунт разработчика, перейдя на сайт Facebook для разработчиков и нажав кнопку "Начать".
После создания аккаунта разработчика Вам будет доступна кнопка создания нового приложения.
После нажатия на кнопку "Добавьте новое приложение", появиться окно, в котором нужно ввести название приложения и адрес электронной почты.
После нажатия на кнопку "Создайте ID приложения", будет создано новое приложение и ему будет присвоен уникальный идентификатор (ID). И также откроется панель управления Вашим приложением. Стартовый адрес панели управления, где отображаются все Ваши приложения: https://developers.facebook.com/apps
Панель управления - это место, где Вы можете настроить Ваше приложение, посмотреть статистику по аудитории, отправить приложение на проверку, добавить необходимые сервисы (о них поговорим ниже).
В разделе "Настройки" необходимо получить токен доступа к странице. Он будет использоваться при выполнении запросов к Facebook API.
Выберите свою страницу в выпадающем списке слева и токен сразу же автоматически будет сгенерирован. Кстати, токен не сохраняется на странице настроек. Если Вы в дальнейшем опять выберите страницу в разделе “Токены доступа”, то будет сгенерирован новый токен, но старые останутся активными. Скопируйте куда-нибудь полученный токен.
Далее необходимо добавить платформу Messenger в приложение Facebook. На боковой панели настроек нажмите на кнопку "Добавить продукт". Нажмите на кнопку "Настроить" в разделе "Messenger".
Платформа Messenger будет добавлена в ваше приложение, и отобразится консоль настроек Messenger.
Кстати, посмотрите на дополнительные опции, которые можно добавить в Ваше приложение. О некоторых из них я расскажу ниже. Среди них есть Instagram API - это функции для работы с Инстаграм для Вашего бота. О них я расскажу в следующем посте.
Далее, Вы можете настроить Webhook для Вашего бота. Как только пользователь напишет Вашей странице сообщение, Facebook сразу пришлёт оповещение на сетевой адрес, который Вы укажите в настройках.
Для этого
- В разделе "Webhooks" консоли настроек Messenger нажмите кнопку "Настройка Webhooks".
- В поле "URL обратного вызова" введите сетевой адрес, на который Facebook буде слать обновления (события).
- В поле "Подтвердить маркер" введите маркер подтверждения для Webhook.
- В поле "Поля подписки" выберите события Webhook, которые хотите передавать в свой Webhook. Как минимум Вам нужно выбрать
messages,
но рекомендовано также выбратьmessaging_postbacks
(эти события возникают, когда пользователь нажимает на инлайн кнопки, т.е. кнопки под сообщениями) - Нажмите кнопку "Подтвердить и сохранить".
Платформа Messenger отправит на Ваш сетевой адрес Webhook запрос GET
с указанным вами маркером подтверждения. На данный момент у Вас уже должен работать бот, отвечающий хотя бы на это сообщение, тогда настройки будут сохранены. Если программы бота пока нет, то настроить Webhook можно потом.
Далее в этом же разделе нажмите раскрывающееся меню "Выбрать Страницу" и выберите страницу Facebook, для которой ранее Вы создали маркер доступа. Благодаря этому Ваше приложение будет получать события Webhook от страницы. Нажмите кнопку "Подписаться" рядом с этим меню.
Отправка бота на проверку.
Да, бота перед публикацией придётся отправить на проверку. И он должен соответствовать определённым правилам. Контрольный список для проверки перед запуском Вы можете посмотреть здесь.
Условия, которые необходимо выполнить до отправки на проверку:
- Убедитесь, что Ваш бот соблюдает все политики Messenger Platform and Facebook policies.
- Убедитесь, что Ваш бот соответствует стандартам the Facebook Community Standards.
- Просмотрите контрольный список перед запуском (pre-launch checklist).
- Опубликуйте страницу Facebook, связанную с вашим ботом.
- Убедитесь, что ваш бот работает должным образом и возвращает ответ 200 OK на события webhook в течение 20 секунд.
- Если ваш бот имеет закрытый функционал или контент, предоставьте возможность команде Facebook получить доступ и протестировать его. Например, если функция требует от пользователя входа в службу, обязательно укажите имя пользователя и пароль в примечаниях к отправке. Другой распространенной практикой является предоставление триггерной фразы, которую наши рецензенты могут отправить вашему боту, что позволит им начать нормально закрытые потоки.
Процесс отправки на проверку:
- Настройка параметров приложения
Как минимум, необходимо предоставить следующие основные сведения в консоли приложения в разделе Параметры > Основные:
- Иконка приложения
- URL политики конфиденциальности
- Категория
- Бизнес использование
2. Предоставить пользователям возможность писать сообщения Вашей странице.
Чтобы получать сообщения от пользователей, необходимо включить обмен сообщениями для своей страницы. Для этого выполните следующие действия:
- Перейдите в настройки страницы > общие.
- В разделе "сообщения" нажмите кнопку "Изменить".
- Установите флажок "Разрешить людям обращаться к моей странице в частном порядке, показывая кнопку сообщения".
- Нажмите Кнопку "Сохранить изменения"
3. Переведите Вашего бота в режим разработки.
4. Отправить бота, нажав на кнопку "Отправить на проверку" (Submit for Review)
5. Предоставление проверочной информации и документов.
Как только ваш бот будет проверен на отзывчивость, функциональность и соответствие политике, вы получите сообщение с просьбой завершить бизнес-проверку или индивидуальную проверку на вкладке "Оповещения" консоли приложения.
6. Принять дополнительные условия и подписать соглашение с поставщиком технологий.
7. Ждать оповещения о подтверждении.
Телеграм: papabotov, botreactor, cryptsys