Перейти к основному содержимому

Facebook

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

Вы можете посмотреть пошаговую видеоинструкцию по созданию бота для Facebook:

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

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

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

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

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

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

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

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

  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. После того как аккаунт будет создан, откройте страницу Мои приложения, нажмите Создать приложение, выберите тип приложения Компания и нажмите Продолжить.

  1. Дайте название приложению и укажите Вы или принадлежащая вам компания в качестве назначения приложения. Выберите ваш аккаунт в Business Manager и сохраните настройки.

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

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

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

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

  1. В секции Маркеры доступа нажмите кнопку Добавить или удалить Страницы.

  1. В открывшемся окне для авторизации через Facebook нажмите Продолжить как (имя вашего аккаунта).

  2. Выберите Страницу на Facebook.

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

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

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

На странице бота перейдите на вкладку Каналы. В блоке каналов Мессенджеры, соцсети и API выберите канал Facebook.

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

  • Токен — укажите маркер доступа, который вы скопировали на предыдущем шаге.
  • Название канала — укажите название для канала или оставьте по умолчанию.

Нажмите Подключить.

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

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

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

  1. В секции Webhooks нажмите Добавить URL обратного вызова.

  1. В модальном окне в поле URL обратного вызова вставьте скопированный вебхук, а в поле Маркер подтверждения вставьте justai_verify_token. Нажмите Подтвердить и сохранить.

  1. Напротив добавленной Страницы нажмите Добавить подписки.

  1. В модальном окне активируйте поля messages и messaging_postbacks, а затем нажмите Сохранить.

  1. Обновите страницу. В меню слева перейдите на вкладку Webhooks и в выпадающем списке, где по умолчанию выбрано Page, выберите Permissions.

  1. Нажмите Subscribe to this object и заполните поля, как было описано в пунктах 1 и 2, после чего нажмите Подтвердить и сохранить.

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

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

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

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

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

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

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

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

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

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

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

  1. В меню на странице приложения перейдите на вкладку Проверка приложения → Запросы и нажмите кнопку Запросить разрешения или функции.

  1. Напротив параметра pages_messaging нажмите кнопку Запросить расширенный доступ.

  1. Перейдите на вкладку Запросы и нажмите Редактировать напротив черновика запроса с данными параметрами.

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

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

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

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

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

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

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

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