Pythonist

Сегодня мы напишем примитивного бота для Facebook, используя Flask и Heroku. Задача бота — отвечать на сообщения, используя рандомную фразу из заданного вами набора.

Что нам будет необходимо для запуска бота?

• Sublime Text (или любой редактор кода) + терминал
• Склонировать этот репозиторий: https://github.com/udodihor/flask-fb-bot
• Бесплатный аккаунт на Heroku и Heroku CLI
• Аккаунт на Facebook (для доступа к Facebook Developer Center)

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

$ pip install -r requirements.txt

Итак, теперь мы можем запустить Flask-приложение, используя терминал (конечно, всё ещё необходимо находиться в директории проекта):

$ python app.py

Если всё пройдет успешно, мы сможем увидеть URL нашего Flask-приложения. Для того, чтобы проверить его, скопируйте и вставьте, либо просто наберите в адресной строке следующую ссылку: http://localhost:5000

И вы увидите ошибку: недействительный токен проверки.

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

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

Переходим на https://developers.facebook.com/apps Создаем новое приложение с таким именем, которое вам захочется. Далее, когда мы попали на следующую страничку с выбором типа приложения, кликаем «Set Up» на опции с названием «Messenger».

1.2 Генерируем токен для доступа

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

Теперь, нам нужно сгенерировать токен для нашего приложения и скопировать его в наше приложение, а именно в файл app.py. Находим ACCESS_TOKEN = ‘GENERATED_TOKEN_FROM_FACEBOOK’ и заменяем значение на то, которое только что сгенерировали.

1.3 Создаем токен проверки

Далее, установим любое значение по нашему желанию для VERIFY_TOKEN. Чтобы защитить нашего бота, Facebook требует завести токен проверки. Когда пользователь будет писать нашему боту, Facebook будет отправлять это сообщение нашему Flask-приложению вместе с токеном проверки, чтобы быть уверенными, что сообщение отправлено и подписано самим Facebook.

Выбираем себе строку, которую хотим использовать как токен проверки и присваиваем это значение соответствующей переменной (например, «TESTINGTOKEN» вполне может являться нашим токеном проверки, но лучше использовать что-нибудь посложнее). Затем устанавливаем этот же токен в такое же поле настроек приложения Facebook (конечно, обрубая кавычки).

2.Создаем аккаунт на Heroku

Регистрируемся на Heroku. Это бесплатно.

3.Устанавливаем Heroku CLI

Оправляемся в терминал, выполняем следующую команду:

$ brew tap heroku/brew && brew install heroku

Или скачиваем и устанавливаем автоматически отсюда.

После успешной установки Heroku CLI, мы можем создать наше первое приложение на Heroku!

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

Запускаем следующую команду в терминале:

$ heroku login

и нажимаем любую кнопку.

Мы будем перенаправлены в приложение браузера по умолчанию, где будет необходимо залогиниться в нашем аккаунте Heroku. После успешного входа, возвращаемся обратно к окну терминала. Для создания нового приложения пишем такую команду:

$ heroku create

Если всё пошло по плану, мы увидим примерно следующую картину:

Heroku автоматически создаст экземпляр нового приложения на нашем аккаунте. После создания вы увидите git URL к своему приложению (именно там мы и будем разворачивать нашего бота).

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

$ git push heroku master

ВАЖНО: Если вы клонировали репозиторий, всё пройдет хорошо. А если просто скачали файлы с гитхаба, нужно будет инициализировать новый репозиторий и провести первый коммит, а уж потом пушить код на Heroku.

$ git init

$ git add -A && git commit -m "First commit"

После этого, копируем URL нашего веб-приложения Heroku, которое мы предварительно создали. Мы можем проверить его с помощью нашего аккаунта на Heroku (переходим в созданное приложение, и находим кнопку «Open»).

5.Настраиваем вебхуки

В Facebook Developer Center заходим в настройки Messenger’a и добавляем Callback URL в секции вебхуков.

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

Если мы сделали всё правильно, Facebook протестирует этот callback и добавит его к приложению. После этого, установим галочки на полях подписки messages, messaging_postbacks, message_deliveries, messaging_pre_checkouts.

Вот и всё, это был финальный шаг. Отправляемся в наши сообщения на Facebook, создаем новое сообщение и отправляем его созданному нами сообществу/группе.

Наслаждайтесь:)