Текстовая инструкция по установке чат бота Вконтакте на heroku

Ниже предлагаем текстовую инструкцию по установке чат бота Вконтакте на heroku.

А основные видео инструкции в этой статье.

ПОЯСНЕНИЕ: Пояснение по полям при регистрации на heroku.com:

• Role — Other
• Primary development language — python

Но по идее без разницы что указывать.

ШАГ 1

Чтобы начать установку чат бота Вконтакте, нужно зарегистрироваться на https://github.com/signup* и загрузить в свой аккаунт все файлы чат бота Вконтакте.

*Github это очень известная платформа для хранения, распространения и управления исходным кодом открытых проектов.

ПОЯСНЕНИЕ: При регистрации будет предложена проверка, нужно нажать на кнопку: Проверить, появится капча в виде картинок с инструкцией, что нужно сделать, выполнить задания (капчу).

1. После регистрации, вам нужно нажать на кнопку: Create repozitory (скриншот ниже, стрелка 1) или в правой части страницы нажать на знак плюс  (скриншот ниже, стрелка 2), появится выпадающее окно в котором нажать на: New repozitory (скриншот ниже, стрелка 3).

2. Дальше, перед вами откроется новая страница  (скриншот ниже), на которой нужно сделать следующее:

• В поле: Repozitory name ввести любое название. Лучше введите название вашего бота, как например сделал я на скриншоте ниже или свое, (стрелка 1)
• Поставьте галочку в поле: Private (стрелка 2).
• Поставьте галочку в поле: Add README file (стрелка 3).
• Нажмите на кнопку: Create Repozitory (стрелка 4).

3. На новой странице, нужно загрузить все папки и файлы чат бота из архива, который вы получили.

Для этого нужно сделать следующее:

• Откройте на Рабочем столе архив с файлами чат бота (стрелки 1 и 1а, на скриншоте ниже).
• Перетащите из архива на Рабочий стол компьютера 7 файлов (2 папки и 5 файлов) чат бота.
• Выделите мышкой все 7 файлов чат бота на Рабочем столе (стрелка 3 на скриншоте ниже) и перетащите их в окно (стрелка 4) или перетащите их в это окно по очереди.

• Подождите, пока они загрузятся.
• В итоге, ниже под окном загрузки, у вас появятся все загруженные файлы (4 файла на скриншоте выше и остальные на скриншоте ниже).
• Нажмите на кнопку: Commit changes.

4. Вас перебросит на новую страницу, подождите когда закончится загрузка и нажмите на папку scr (стрелка 1 на скриншоте ниже).

5. В этой папке находятся 3 файла (скриншот ниже):

Вот они:

• questions.py
• settings.py
• vk_functions.py

В файле questions.py (скриншот ниже), находятся все шаги с текстами и кнопками чат бота Вконтакте.

1. Здесь в каждом шаге вы можете написать свои тексты и названия кнопок, а так же, прикрепить к тексту каждого шага видео, url ссылки, изображения и прикрепить файл.
2. Для это нужно в верхнем правом углу нажать на значок карандаша (на скриншоте ниже, этот значок находится вверху справа на серой полосе, перед значком удалить).
3. После этого, файл откроется в режиме редактирования и вы сможете изменить все тексты в диалогах и названия кнопок на свои.
4. Чтобы сохранить внесенные изменения, в самом низу нажмите на зеленую кнопку Commit changes.

 

В файле: settings.py (скриншот ниже) производятся следующие настройки (и инструкции для каждой настройки):

• Указываются цены платного доступа к шагам чат бота №8 и №8а, каждый из которых откроется пользователям только после оплаты (стрелка 1, на скриншоте ниже, указаны тестовые цены для каждого шага, а именно 2 и 2.2 руб.).
• Подключение к https://p2p.qiwi.com (стрелка 2), чтобы принимать платежи на свой кошелек в QIWI для физических лиц. Здесь есть 4 строчки инструкции как после регистрации на https://p2p.qiwi.com получить api ключ, который нужно вставить МЕЖДУ кавычками (стрелка 2а).
• Подключение к платежному сервису YooMoney (стрелка 3), чтобы принимать платежи с помощью YooMoney. Здесь есть 4 строчки инструкции, как после регистрации в YooMoney получить YOOMONEY_TOKEN, который нужно вставить МЕЖДУ кавычек (стрелка 3а). Но перед токеном, вставьте еще номер кошелька, поставьте точку после последней цифры кошелька, затем после точки идет код токена . В итоге конструкция должна быть такой: «410011866349506.735211AB7CFFADE0B7763542B04763BA6502F7F4A4C3FDF4C35B1DAD50134D70C1BDD54619GH677VH7V5FJ74HK539S7072FA831440AA7702C011B94222C3607FD6599», соответственно будут цифры вашего кошелька Юмани и символы вашего токена.
• Создание токена VK (стрелка 4).  Чтобы подключить бота к Вконтакте здесь есть 10 строк инструкции, как получить VK TOKEN,который нужно вставить МЕЖДУ кавычками  (стрелка 4а).

Указать все настройки можно следующим образом:

1. В верхнем правом углу файла, нужно нажать на значок карандаша (на скриншоте ниже, этот значок находится вверху справа на серой полосе, перед значком удалить).
2. После этого, файл откроется в режиме редактирования и вы сможете указать цены для Шага 8 и Шага 8а, указать QIWI_SECRET_KEY, YOOMONEY_TOKEN и VK_TOKEN.
3. Обязательно введите ключ QIWI, Токен Yoomoney, и введите VK токен, если не укажите что то одно, чат бот работать не будет.
4. Чтобы сохранить внесенные изменения, в самом низу нажмите на зеленую кнопку Commit changes.

 

ШАГ 2

После загрузки файлов чат бота на https://github.com, нужно зарегистрироваться на сервере https://heroku.com.

Войти в личный кабинет, нажать на New и в выпадающем списке нажать на Create new app.

После этого, перед вами откроется новая страница (скриншот ниже), на которой в первом поле (стрелка 1) введите какое нибудь имя (оно должно отличаться от всех, которые вы ранее создавали здесь). Зеленая галочка справа в этом поле, будет означать что все сделали правильно. Если в правом верхнем углу появится красное поле с текстом, значит измените название на другое или к уже введенному добавьте дополнительные символы. Затем нажмите на кнопку Create app.

После этого перед вами откроется новая страница (скриншот ниже), на которой нужно нажать на Deploy (стрелка 1), если вы уже на ней, то нажимать на нее не нужно, затем нажмите на GitHub (стрелка 2).

После этого на этой же странице ниже, нужно нажать на кнопку Connect to GitHub (скриншот ниже).

 

После этого здесь же, появится всплывающее окно (скриншот ниже), в котором нужно нажать на кнопку Autorise heroku.

После нажатия на кнопку, появится новое окно, в котором нужно в поле (скриншот ниже, стрелка 1) ввести ваш пароль от https://github.com и нажать на кнопку Confirm password.

Этим действиям вы свяжете свой аккаунт на https://github.com в котором загрузили файлы чат бота с аккаунтом на сервере https://heroku.com.

После нажатия на кнопку Confirm password на этой же странице в поле (скриншот ниже, стрелка 1) нужно ввести названия репозитория, то есть название папки на https://github.com в которую вы загрузили все файлы чат бота и нажать на Search.

После этого, здесь же (скриншот ниже), появится новая кнопка Connect (стрелка 1), нажмите на нее.

После этого, на этой же странице (скриншот ниже), нажмите на кнопку Enable Automatic Deploys, затем на кнопку Deploy Brance.

После этого, появятся 4 строчки с установкой приложения (скриншот ниже). Вам нужно вверху нажать на кнопку Resources.

Если соблюдали все правила данной инструкции, то после нажатия на кнопку Resources, откроется новая страничка (скриншот ниже) и будет надпись: worker python3 main.py (под кнопкой Change Dyno Type). Если надпись не появилась, нажмите на обновить страницу в браузере (стрелка 2). Теперь нажмите на кнопку карандаша (редактировать, стрелка 3).

Теперь перетащите курсором ползунок (стрелка 1) вправо, он загорится синим цветом и нажмите на кнопку Confirm. После этого действия бот запустился.

Теперь в верху нажмите на кнопку More (скриншот ниже, стрелка 1) и в выпадающем списке на Viev Logs (стрелка 2).

После этого откроется новая страница, на которой по центру будет выводиться информация о работе чат бота.[/toggle]

ПОЯСНЕНИЕ GitHub с Heroku связаны через heroku, Heroku сам берет файлы с GitHub. В heroku любое редактирование можно делать через github, бот сам автоматически будет обновляться на heroku.

ДОПОЛНЕНИЕ ПО ВТОРОМУ ЧАТ БОТУ

Как прервать сценарий в каждом товаре

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

Если вы хотите изменить сценарий уменьшив количество шагов, то сделать это можно в ШАГе 5. То есть у вас будет для товара или услуги только 5 шагов. Таким образом, вы прервете сценарий на ШАГе 5.

Сделать это можно так как показано на видео ниже, но сначала прочитайте про 5 пунктов ниже:

1. В папке: categories, находятся 11 файлов: category1.py, category2.py ……., category11.py.
2. В каждом файле категорий, каждый товар начинается с ‘use_this_item’
3. У каждого товара 11 ШАГов
4. Первый  ШАГ начинается с step1 (цифра это номер ШАГа у каждого товара)
5. Таким образом srep5 это ШАГ 5 у каждого товара. Именно ШАГ 5 в каждом товаре, можно сделать последним.

Как ШАГе 5 у любого товара, оставить кнопку: ЧТО БУДЕТ ЕСЛИ НЕ КУПЛЮ

А если вы хотите сделать так, чтобы в ШАГе 5, появилась кнопка: ЧТО БУДЕТ ЕСЛИ НЕ КУПЛЮ при нажатии на которую посетитель будет попадать в ШАГ 7, то нужно сделать в ШАГе 5 у любого товара так как на скриншоте ниже.

ПОЯСНЕНИЕ ПО СКРИНШОТУ ВЫШЕ Обе названия кнопок (цифра 2, зеленым цветом на скриншоте выше), должны быть написаны одинаково и без ошибок, если ставите впереди эмодзи, то они должны быть поставлены перед названием каждой кнопки.