JAICP

Facebook как входящий канал


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

Перед выполнением инструкции, зарегистрируйтесь и авторизуйтесь.

Подробнее о создании аккаунта и авторизации

Для использования Facebook как входящего канала:

  1. Создайте и настройте публичную Страницу.
  2. Создайте и настройте приложение.
  3. Создайте канал.
  4. Подключите вебхук.
  5. Протестируйте бота.
  6. Отправьте приложение на проверку.
  7. Опубликуйте приложение и Страницу.

Создание и настройка Страницы на Facebook

Создание Страницы

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

  1. Авторизуйтесь в аккаунте Facebook и на главной странице в меню слева выберите раздел Страницы.
  2. На открывшейся странице в меню слева нажмите + Создать новую Страницу.
  3. Заполните информацию о Странице: обязательно укажите название страницы и ее категорию. После этого нажмите Создать Страницу.
  4. После создания Страницы вы можете установить фото профиля и обложки, а также заполнить опциональные поля.

Настройка Страницы

Нужно сделать Страницу неопубликованной:

  1. В меню Управление Страницей нажмите Настройки.
  2. В поле Статус Страницы установите Страница снята с публикации. В качестве причины укажите Страница еще не закончена > Снять с публикации. Теперь вашу страницу могут видеть только администраторы страницы.

Предоставьте права администратора всем пользователям, которым нужно просматривать диалоги с ботом.

  1. В меню Настройки Страницы перейдите на вкладку Роли на Странице.
  2. Перейдите в раздел Назначить новую роль на Странице.
  3. Выберите пользователя и роль Администратор > Добавить.

Тестирование Страницы

Для тестирования отправки сообщений создайте кнопку: перейдите на вашу страницу > Добавить кнопку > Отправить сообщение.

Кнопка будет добавлена на Страницу.

Вместо Добавить кнопку появится кнопка Редактирование кнопки Сообщение. Нажмите на нее и выберите Протестировать кнопку из выпадающего списка.

Отправьте в диалоговом окне любой текст. Убедитесь, что сообщения приходят и корректно отображаются в сообщениях Страницы.

Настройка приложения на Facebook

Чтобы бот мог вместо вас отвечать на сообщения посетителей Страницы, нужно создать приложение.

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

  1. Перейдите на сайт Facebook for Developers.
  2. Нажмите Войти и авторизуйтесь в аккаунте Facebook. Вы будете перенаправлены на главную страницу Facebook for Developers. Если у вас уже есть аккаунт в Facebook for Developers, переходите к шагу 5.
  3. Нажмите Начать работу в шапке страницы.
  4. Пройдите все шаги создания аккаунта Facebook for Developers.
  5. После того как аккаунт будет создан, откройте страницу Мои приложения, нажмите Создать приложение, выберите тип приложения Компания и нажмите Продолжить.
  6. Дайте название приложению и укажите Вы или принадлежащая вам компания в качестве назначения приложения. Выберите ваш аккаунт в Business Manager и сохраните настройки.

После создания приложения вы будете перенаправлены на его страницу.

Подключение Страницы к приложению

На странице приложения из меню слева перейдите на вкладку Панель. Найдите секцию Добавление продуктов в приложение и нажмите Настроить для продукта Messenger.

Чтобы привязать Страницу к приложению, выполните следующие шаги:

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

Далее вам необходимо получить маркер доступа. Для этого нажмите Сгенерировать маркер напротив только что добавленной вами Страницы. В модальном окне установите галочку Я понимаю и скопируйте маркер. Он понадобится вам при настройке канала на стороне JAICP.

Создание канала

Нажмите на панели управления Каналы > Входящие > Создать канал. Выберите канал для подключения Facebook.

Заполните поля:

  • Название — укажите название для канала или оставьте по умолчанию.
  • Токен — укажите маркер доступа страницы.
  • Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
  • Оператор — выберите операторский канал или оставьте пустым.
  • Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

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

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

Подключение вебхука

Под названием созданного канала нажмите Получить webhook. Адрес вебхука будет скопирован в буфер обмена.

Для подключения вебхука к приложению на Facebook перейдите обратно на страницу Настройки и выполните следующие шаги:

  1. В секции Webhooks нажмите Добавить URL обратного вызова.
  2. В модальном окне в поле URL обратного вызова вставьте скопированный вебхук, а в поле Маркер подтверждения вставьте justai_verify_token. Нажмите Подтвердить и сохранить.
  3. Напротив добавленной Страницы нажмите Добавить подписки.
  4. В модальном окне активируйте поля messages и messaging_postbacks, а затем нажмите Сохранить.
  5. Обновите страницу. В меню слева перейдите на вкладку Webhooks и в выпадающем списке, где по умолчанию выбрано Page, выберите Permissions.
  6. Нажмите Subscribe to this object и заполните поля, как было описано в пунктах 1 и 2, после чего нажмите Подтвердить и сохранить.

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

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

Нажмите Редактирование кнопки Сообщение и выберите Протестировать кнопку, как делали это при тестировании Страницы.

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

Отправка приложения на проверку в Facebook

Для того чтобы бот мог отвечать на сообщения реальных клиентов, а не только в режиме тестирования, необходимо пройти процедуру проверки вашего приложения.

Документация Facebook по проверке приложений

Прежде всего убедитесь, что ваше приложение не противоречит:

Перед составлением и отправкой заявки на проверку приложения убедитесь, что приложение полностью настроено и работает корректно.

Если Facebook не сможет протестировать ваше приложение, оно не пройдет проверку.

Чтобы оставить заявку на проверку приложения:

  1. В меню на странице приложения перейдите на вкладку Проверка приложения > Запросы и нажмите кнопку Запросить разрешения или функции.
  2. Напротив параметра pages_messaging нажмите кнопку Запросить расширенный доступ.
  3. Перейдите на вкладку Запросы и нажмите Редактировать напротив черновика запроса с данными параметрами.
  4. Заполните заявку в соответствии с требованиями. К заявке необходимо будет прикрепить видеоролики с записью экрана, которые будут подтверждать необходимость подключения каждого запрашиваемого разрешения, демонстрировать процесс настройки и использования приложения.
  5. После того как вы заполнили все поля, нажмите Отправить на проверку.

Дождитесь решения со стороны Facebook. Если ваша заявка будет одобрена, вы можете начинать использование интеграции.

Публикация приложения и Страницы

Если ваш бот прошел модерацию, нужно опубликовать приложение и вашу Страницу.

Для публикации Страницы откройте ее и перейдите на вкладку Настройки из меню Управление Страницей. В поле Статус Страницы установите Страница опубликована.

Для публикации приложения перейдите на его страницу и выберите Настройки > Основное. Укажите ссылку на вашу политику конфиденциальности и заполните необходимые поля. Загрузите здесь логотип вашего приложения и укажите его категорию.

Нажмите Сохранить изменения.

После публикации приложения и Страницы вашему боту смогут писать все пользователи Facebook, которые заходят на вашу Страницу или находят вашего бота в приложении Messenger.

Решение проблем

  • Сообщения приходят странице, но не доходят до приложения. Проверьте, выбрано ли поле подписки messages.
  • Сообщения доходят, но не отправляются обратно. Проверьте настройки прав: пользователи не добавлены в администраторы/тестировщики приложения.
  • Вебхук перестал отвечать. Facebook отключит вебхук, если он перестал отвечать. Администрации придет извещение о том, что страница не отвечает. В этом случае вебхук надо снова включить и верифицировать через настройки приложения.