Подключение бота к Facebook

  • Статья

Бот можно настроить для взаимодействия с людьми через Facebook Messenger или Facebook Workplace. В этой статье описывается, как создать приложение Facebook с помощью сайта Meta for Developers, подключить бота к приложению Facebook в Azure и протестировать бота на Facebook.

В этой статье показано, как добавить канал Facebook в бот с помощью портал Azure. Дополнительные сведения об использовании пользовательского адаптера канала см. в разделе "Дополнительные сведения".

Необходимые компоненты

  • Подписка Azure. Если у вас еще нет подписки Azure, создайте бесплатную учетную запись, прежде чем начать работу.
  • Бот, опубликованный в Azure, который вы хотите подключиться к Facebook.
  • Учетная запись Facebook для разработчиков. Если у вас нет учетной записи, ее можно создать на developers.facebook.com.
  • Страница Facebook, из которой пользователи получат доступ к боту. Если у вас еще нет страницы, создайте новую страницу.
  • Чтобы использовать Facebook Workplace с ботом, необходимо создать учетную запись Workplace и пользовательскую интеграцию для подключения бота.

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

Пользователи получат доступ к боту на странице Facebook. Чтобы подключить бота, вы включите Facebook Messenger на странице Facebook, а затем подключите бота к странице.

Создание своего приложения

  1. Войдите в учетную запись Meta for Developers .
  2. Перейдите к созданию нового приложения Facebook.
  3. На странице "Выбор типа приложения" нажмите кнопку "Бизнес" и "Далее".
  4. На странице "Предоставление основных сведений" введите имя приложения и нажмите кнопку "Создать приложение".
    • При появлении запроса введите пароль и нажмите кнопку "Отправить ", чтобы создать приложение.
    • После создания приложения сайт переходит на страницу приложения.
  5. Разверните Параметры и выберите "Базовый".
    1. Скопируйте и сохраните идентификатор приложения и секрет приложения.
  6. Теперь в разделе Параметры нажмите кнопку "Дополнительно".
    1. В результирующей области прокрутите вниз до параметров безопасности и включите разрешение доступа API к параметрам приложения.
    2. Выберите Сохранить изменения.

Включение Messenger

  1. Выберите Панель мониторинга.
  2. В результирующей области прокрутите вниз до плитки Messenger и выберите "Настроить".
  3. Сайт добавляет параметры Messenger в приложение и отображает страницу параметров.

Добавление страниц и создание маркеров

  1. В разделе Messenger выберите Параметры.

  2. Прокрутите вниз до маркеров доступа и выберите " Добавить или удалить страницы".

    1. При появлении запроса на связывание удостоверения с Messenger перейдите к текущей учетной записи или войдите в другую учетную запись.
    2. При появлении запроса на страницы, которые вы хотите использовать с приложением, выберите страницы и нажмите кнопку "Далее".
    3. Если появится запрос на проверку входа, просмотрите сведения и нажмите кнопку "Готово".
    4. При успешном выполнении сайт отображает страницу успешного выполнения. Для продолжения выберите ОК.

  3. Добавленная страница теперь отображается в списке страниц .

    Скопируйте и сохраните идентификатор страницы для дальнейшего использования.

  4. Выберите " Создать маркер " для страницы.

    1. На сайте отображаются сведения о безопасности и вы можете скопировать маркер.
    2. Прочтите и подтвердите предупреждение.
    3. Скопируйте маркер и нажмите кнопку "Готово".

Теперь у вас есть сведения о приложении и маркер для следующего шага. Оставьте действия по настройке Facebook ожидающих. Вы обновите их позже.

Настройка бота в Azure

Чтобы позволить боту отправлять сообщения и другие события в Facebook Messenger, включите интеграцию веб-перехватчиков.

  1. В новом окне браузера перейдите к портал Azure.
  2. Откройте колонку ресурсов Azure Bot для бота.
  3. Откройте каналы и выберите Facebook.
  4. В разделе "Настройка канала Facebook" введите данные Facebook, скопированные на предыдущих шагах.
    1. Введите идентификатор приложения Facebook и секрет приложения Facebook.
    2. Введите идентификатор страницы и маркер доступа.
    3. Скопируйте созданный URL-адрес обратного вызова и проверьте значения маркера .
    4. Выберите Добавить.

Совет

  • Если у вас нет копии сведений из предыдущих шагов, его можно получить на сайте Meta for Developers.
  • Если вам нужно, создайте новый веб-токен для страницы. Инструкции см. в разделе "Добавление страниц" и создание маркеров.

Включение веб-перехватчиков

Вернитесь к параметрам Facebook, чтобы завершить процесс настройки.

  1. На сайте Meta for Developers вернитесь на страницу параметров Messenger для приложения.
  2. В результирующей области прокрутите вниз до раздела "Веб-перехватчики" и выберите "Добавить URL-адрес обратного вызова".
  3. На странице "Изменить URL-адрес обратного вызова":
    1. Введите URL-адрес обратного вызова и проверьте значения маркеров, скопированные из портал Azure.
    2. Выберите " Проверить и сохранить".
  4. Добавленная страница теперь отображается в списке "Страницы" в веб-перехватчиках.
  5. Выберите " Добавить подписки" для страницы .
    1. На странице "Изменение подписок" выберите следующие поля подписки:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Выберите Сохранить.
  6. На сайте отображаются добавленные поля подписки рядом со страницей бота.

Сделать приложение общедоступным

Пока приложение не будет опубликовано, оно находится в режиме разработки. Функции подключаемого модуля и API будут работать только для администраторов, разработчиков и тест-инженеров.

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

Пользователи, добавляемые к ролям тестировщика, должны сначала зарегистрировать на сайте Meta for Developers. Роль тестировщика недоступна пользователям Facebook, у которых нет учетной записи Мета для разработчиков. Дополнительные сведения о ролях приложений и тестовых пользователях см. в документации разработчика meta for Developer.

Отправка на проверку

На странице базовых параметров приложения Facebook требуется указать URL-адрес политики конфиденциальности и условий использования. На странице Code of Conduct (Правила поведения) содержатся ссылки на сторонние ресурсы для создания политики конфиденциальности. На странице Terms of Use (Условия использования) содержится пример условий, помогающий создать соответствующий документ с условиями использования.

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

Сделать приложение общедоступным и опубликовать страницу

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

Настройка версии API

Если вы получаете уведомление от Facebook об отмене определенной версии API Graph:

  1. Перейдите на мета для разработчиков.
  2. Перейдите к приложению, созданному для бота.
  3. В разделе Параметры выберите "Дополнительно".
  4. Выберите версию API обновления, а затем переключите все вызовы до версии 4.0.

Проверьте подключение, выполнив действия, описанные в разделе "Тестирование бота " в Facebook .

Тестирование бота в Facebook

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

  1. Перейдите в Facebook и перейдите в профиль для страницы.
  2. Выберите дополнительные действия (...), а затем нажмите кнопку "Добавить действие".
    1. В диалоговом окне "Настройка действия" нажмите кнопку "Попробовать" и следуйте инструкциям.
    2. На странице "Кнопка действия" в разделе "Получить людей", чтобы связаться с вами, нажмите кнопку "Отправить сообщение".
    3. Нажмите кнопку "Далее", заполните диалоговое окно и сохраните изменения.
  3. Вернитесь к личному профилю.
  4. Перейдите на страницу и выберите "Сообщение ", чтобы проверить подключение к боту.

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

Дополнительные сведения

Ознакомьтесь с примером событий Bot Framework C# Facebook для примера бота, поддерживающего взаимодействие Facebook Messenger.

Документация по Facebook Messenger см. в статье:.

Документация по Facebook Workplace см. в этой статье: