1.1 Получение токена от Bot Father в телеграмме

Первым делом, нам нужно «зарегистрировать» нашего бота в Telegram.

Для этого, в поисковике телеги ищем BotFather

далее, делаем всё также, как показано на скриншотах:

После нажимаем на команду /newbot или же прописываем вручную.

Надо придумать уникальное имя для бота, придумываем и получаем соответствующий токен.

1.2 Переходим в любой редактор кода и создаем файл config.py

Перед созданием данного файла, нам нужно выбрать директорию, в котором будет реализован весь функционал бота. Если вы используете PyCharm Community/Professional Edition, то предлагаю просто создать новый проект, и писать там весь функционал бота.

Если Вы используете любой другой редактор, такой как Sublime Text 3, например, то Вам самостоятельно придётся создать директорию, создать виртуальное окружение, и работать из консоли со всеми предварительными тестами. Во избежание трудностей, предлагаю скачать продукт PyCharm Community Edition от компании JetBrains, с помощью данного продукта можно обойти действия, описанные в предыдущем абзаце, так как данный продукт сделает их самостоятельно, от Вас потребуется только указать путь до интерпритатора Python в конфигурациях PyCharm, с помощью которого и будет работать Ваш бот.

В данном файле (config.py) будет храниться только токен, который нам дал BotFather, поэтому пишем:

token = "Здесь хранится Ваш токен".

1.3 Cоздаём главный файл — bot.py

Делаем cледующие импорты и для соответствующих библиотек, в консоли прописываем закоментированные строчки:

import config
import telebot # pip install telebot
from telebot import types # pip install pyTelegramBotAPI

Далее, нам необходимо использовать наш токен:

bot = telebot. TeleBot(config.token)

Этим действиям мы устанавливаем то, что мы будем накручивать функционал именно для того бота, для которого нам и дал токен BotFather.

2. Разворачиваем функционал

Начнём с того, что для того, чтобы пользователю запустить бота, нам необходимо прописать команды для старта они могут быть разными, например, /start или /go и вообще любыми, какими Вы сочтёте нужными.

Для обработки команд нам потребуется message_handler, с помощью которого и будет реализован весь функционал обработки команд для старта и завершения, если Вы сочтёте нужным добавить завершение. Как только придёт команда /go или /start, message_handler с соответствующими командами сравнит, совпадают ли строки и если совпадают, то обработает соответствующей функцией.

Каждая функция, как и в примере сейчас, должна принимать один параметр — сообщение от пользователя, которое будет обработано соответствующей функции «в обёртке» декоратора. А также, каждая функция (или связка функций) должна возвращать соответсвующее сообщение от бота.

Итак:

@bot.message_handler(commands=['go', 'start'])  # Обработка команды для старта
def welcome(message):
    sti = open(path+'stiker.tgs', 'rb')
    bot.send_sticker(message.chat.id, sti)
    markup = types.ReplyKeyboardMarkup(resize_keyboard=True)
    item3 = types.KeyboardButton("Приложения")
    item2 = types.KeyboardButton("Мероприятия")
    item1 = types.KeyboardButton('О нас')
    markup.add(item1, item2, item3)
    bot.send_message(message.chat.id,
                     "Добро пожаловать, {0.first_name}!\\n\\nЯ - <b>{1.first_name}</b>, бот команды Projector в НГТУ, "
                     "создан для того, "
                     "чтобы помочь Вам влиться в нашу команду,"
                     "просто узнать что-то о нас или же просто пообщаться и весело провести время.\\n\\n"
                     "<i>Have a nice time</i>".format(
                         message. from_user, bot.get_me()),
                     parse_mode='html', reply_markup=markup)

В этой функции реализовано сразу два действия: отправка приветственного сообщения и создание встроенной клавиатуры — ReplyKeyboardMarkup, которая будет открыта, пока мы не завершим выполнения бота соответсвующей командой. Об этом будет сказано ниже.

Итак, пройдёмся по строчкам:

В строках 20-21: открывается стикер по тому пути к директории, в которой я его сохранил, после чего отправляется.

Строки 22-28: создаем встроенную клавиатуру, добавляя туда три элемента.

Строки 30-37: описано создание и отправка приветственного сообщения

Как вы можете заметить, метод send_message в строке 30, позволяет использовать HTML, для форматирования текста.

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

# RUN
if __name__ == "__main__":
    try:
        bot. polling(none_stop=True)
    except ConnectionError as e:
        print('Ошибка соединения: ', e)
    except Exception as r:
        print("Непридвиденная ошибка: ", r)
    finally:
        print("Здесь всё закончилось")

Сделаем первый запуск! Для этого, в PyCharm-е нажмём зеленую кнопку старт в правом верхнем углу или же, можно запустить из консоли командой: python bot.py

Результат первого запуска:

2.1 Обработка нажатия на кнопки и создание inline keyboard

Так любое сообщение — это текст, то мы будем обрабатывать именно текстовые сообщения.

Сделаем следующее и аналогично разберём по строчкам:

@bot.message_handler(content_types=["text"])
def go_send_messages(message):
    if message.chat.type == 'private':
        if message.text == 'Приложения':
            keyboard = types.InlineKeyboardMarkup(row_width=1)
            itemboo = types.InlineKeyboardButton(text="Тыщ на кнопку и ты уже в Google", url="<https://www. google.ru>")
            itemboo1 = types.InlineKeyboardButton('Рандомное число', callback_data='good2')
            itemboo2 = types.InlineKeyboardButton("Калькулятор", callback_data='bad2')
            itemboo3 = types.InlineKeyboardButton("Хочу узнать погоду в моем городе/стране", callback_data='good3')
            itemboo4 = types.InlineKeyboardButton("Как твои дела?", callback_data='bad4')
            keyboard.add(itemboo, itemboo1, itemboo2, itemboo3, itemboo4)
            bot.send_message(message.chat.id,
                             "{0.first_name}, окей, смотри, что у нас есть тут:\\n".format(message.from_user),
                             reply_markup=keyboard)
        elif message.text == "Мероприятия":
            one_markup = types.InlineKeyboardMarkup(row_width=1)
            ite1 = types.InlineKeyboardButton("Ближайшие мероприятия", callback_data="one")
            ite2 = types.InlineKeyboardButton("Проведенные мероприятия", callback_data="two")
            ite3 = types. InlineKeyboardButton("Волонтерство на мероприятие", callback_data="three")
            ite4 = types.InlineKeyboardButton("Действующие проекты в НГТУ", callback_data="fourth")
            ite5 = types.InlineKeyboardButton("Мероприятия Межвузовского центра", callback_data="five")
            one_markup.add(ite1, ite2, ite3, ite4, ite5)
            bot.send_message(message.chat.id, "{0.first_name}, у нас <u>ежемесячно</u> проводится множество "
                                              "мероприятий,\\nмы постарались разбить их на следующие составляющие:".format(
                message.from_user), parse_mode="html", reply_markup=one_markup)

Строка 339 — обработчик любых текстовых сообщений

Строка 341 предназначена для того, чтобы сказать, что если данное сообщение предназначено боту, то сравни эту строку с теми, что здесь обрабатываются и отправь ответ.

Строки 344 — 351 — создаём инлайновую клавиатуру InlineKeyboardMarkup и помещаем в эту клавиатуру 5 элементов, которые также можно будет обработать по установленной callback_data. Элементы данной клавиатуры будут расположены друг под другом, так как в строке 344, мы установили row_width = 1, что обозначает самую широкую грань одной кнопки, поэтому они и будут расположены друг под другом.

Строки 353-355 — отправляют текст, вместе с нашей Inline Keyboard.

В условиях ниже представлены аналогичные представления обработки сообщений.

Итак, сделаем запуск:

2.2 Обработка InlineKeyboardButton

Как было сказано выше, каждый элемент InlineKeyboardButton имеет параметр callback_data, и именно по этим параметрам будет обрабатываться каждая кнопка. Для этого нам потребуется обработчик инлайновой клавиатуры callback_query_handler.

@bot.callback_query_handler(func=lambda call: call.data in ['one', 'two', 'three', 'fourth', 'five'])  # Мероприятия
def callback_inline_one(call):
    try:
        if call.message:
            if call.data == 'one':  # Ближайшие мероприятия
                bot. send_message(call.message.chat.id,
                                 "Итак,<b>ближайшие мероприятия</b>:\\n\\n"  # Здесь будут ссылки ещё
                                 "Форум «Байкал»\\n"
                                 "Конкурс «Цифровой ветер»\\n"
                                 "PRONETI", parse_mode="html")
            elif call.data == 'two':  # Проведённые мероприятия
                bot.send_message(call.message.chat.id, "Вот список <b>проведённых мероприятий</b>:\\n\\n"
                                                       "МНТК\\n"
                                                       "Семинары по проектной деятельности\\n"
                                                       "Встреча с представителями предприятий", parse_mode="html")
            elif call.data == 'three':

Итак, разберём по строчно:

Строка 269 — объявляем обработчик, который будет обрабатывать каждую из нажатых кнопок с использованием лямбда-функции

Строки 273-278 — В данном блоке if, мы просто обрабатываем сообщение и отправляем сообщение пользователю.

Строки 279-283 — Делают аналогичное действие, что и в предыдущем условном блоке.

и т. д.

Также, в данных блоках можно определить аналогичную инлайновую клавиатуру, только тогда придётся создать ещё один обработчик callback_data, аналогичный обработчику callback_query_handler, показанный на скриншоте выше.

Результат:

Так просто и обрабатываются inline keyboards.

3. Завершаем работу бота

Данная функция будет аналогичной функции обработки команд для старта бота, поэтому Вы сможете легко понять её функционал:

@bot.message_handler(commands=['stop'])  # Обработка команды для выхода
def bye(message):
    bye_Sti = open(path+'byeMorty.tgs', 'rb')
    hideBoard = types.ReplyKeyboardRemove()
    bot.send_message(message.chat.id,
                     "Досвидания, {0.first_name}!\\nМы, команда <b>{1.first_name}</b>, надеемся, что ты хорошо провел(а) время \\n\\n"
                     "Присоединяйся к нашей команде в <a href='<https://vk. com/projector_neti>'>vk</a>\\n"
                     "Наш <a href='<https://instagram.com/projector_neti>'>inst</a>\\n\\n"
                     "Напиши Координатору проектов (<a href='<https://vk.com/nikyats>'>Никите Яцию</a>) и задай интересующие тебя вопросы по <i>проектной деятельности</i>\\n\\n"
                     "Надеемся, что тебе ответят очень скоро \\n\\n"
                     "<u>Don't be ill and have a nice day</u> \\n\\n\\n"
                     "P.S.: Если есть какие-то пожелания или вопросы по боту, то напиши <a href='<https://vk.com/setmyaddresspls>'>мне</a>".format(
                         message.from_user, bot.get_me()), parse_mode='html', reply_markup=hideBoard)
    exit()

Здесь происходит следующее:

1. Отправляется прощальный стикер.
2. Закрывается встроенная клавиатура (строка 44).
3. Отправляется прощальное сообщение.

Так как мы используем bot.polling, с параметром none_stop = True, то пользователь может снова вознообновить общение с ботом при помощи команды /start или /go, обработка которых показано в пункте выше.

Результат:

ВК БОТ

Перейдём к реализации бота Вконтакте, написанном на том же родном языке Python, его основное отличие от предыдущего в том, что он был написан с использованием ООП, а именно класса. Внешне, он выполняет ту же миссию. Сама библиотека для написания вк бота намного проще телеграмм бота, поэтому разобраться в ней самостоятельно не составит большого труда. Итак, начнём.

1. Предварительные подготавления

Установим следующие библиотеки по тем же технологиям:

import vk_api # pip install vk-api
import json   # pip install json
from vk_api.longpoll import VkLongPoll, VkEventType

▍1.

1. На главной странице сообщества найти раздел «Управление»
2. Работа с API
3. Создать ключ. Выбираете нужные для вас пункты, которые будут доступны боту.

В итоге должно получиться примерно следующее:

Берем ключ и переходим в среду разработки и делаем следующее:

vk = vk_api.VkApi(token=
                  "Ваш_токен")

Далее — следующее:

longpoll = VkLongPoll(vk)

На этом, закончим подготавления.

2. Разворачиваем функционал

Первым делом создадим файл manage.py

Cоздадим прототип встроенной клавиатуры ( всё с помощью документации VkBotAPI ).

main_keyboard = {
    "one_time": False,
    "buttons": [
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"1\\"}",
                "label": "О нас"
            },
            "color": "positive"
        }],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"2\\"}",
                "label": "Мероприятия"
            },
            "color": "positive"
        },
            {
                "action": {
                    "type": "text",
                    "payload": "{\\"button\\": \\"3\\"}",
                    "label": "Приложения"
                },
                "color": "positive"
            }
        ],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"4\\"}",
                "label": "Контакты"
            },
            "color": "primary"
        }]
    ]
}

Затем переводим её в формат json, как требуется в документации:

main_keyboard = json. dumps(main_keyboard, ensure_ascii=False).encode('utf-8')
main_keyboard = str(main_keyboard.decode('utf-8'))

Пример инлайн клавиатуры:

about_us_keyboard = {
    "inline": True,
    "buttons": [
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"1\\"}",
                "label": "Основная информация"
            },
            "color": "positive"
        }],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"2\\"}",
                "label": "Чем мы занимаемся ?"
            },
            "color": "primary"
        },
        {
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"3\\"}",
                "label": "Где мы находимся ?",
            },
            "color": "positive"
        }],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"4\\"}",
                "label": "Как попасть в команду ?",
            },
            "color": "primary"
        }],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"5\\"}",
                "label": "Контакты",
            },
            "color": "secondary"
        }],
        [{
            "action": {
                "type": "text",
                "payload": "{\\"button\\": \\"6\\"}",
                "label": "Задать вопрос руководителю проекта",
            },
            "color": "negative"
        }]
    ],
}

Не забываем все используемые клавиатуры переводить в формат json:

about_us_keyboard = json. dumps(about_us_keyboard, ensure_ascii=False).encode('utf-8')
about_us_keyboard = str(about_us_keyboard.decode('utf-8'))

Создадим функцию write_msg, для того, чтобы не мучиться с постоянной отправкой сообщений от бота:

def write_msg(user_id, message, key):
    vk.method('messages.send',
              {'user_id': user_id,
               'message': message,
               'keyboard': key,
               'random_id': random.randint(0, 2048)})

После создания всех прототипов, мы можем перейти к следующему шагу. ( к этому файлу мы позже вернёмся и доработаем обработку общения пользователя и нашего vk-бота )

▍2.1 Основной функционал (создаем файл vk_bot.py).

Мы не будем разрабатывать методы, которые будут выполнять, например, функцию парсинга времени или погоды, назовем их второстепенными. Я покажу лишь основной метод, который будет обращаться к этим второстепенным методам, для обработки тех или иных сообщений от пользователя. В конце статьи я выложу ссылку на свой GitHub, где Вы сможете самостоятельно просмотреть интересующий Вас функционал любого из метода. Итак:

Конструктор класса:

class VkBot:
    def __init__(self, user_id):
        self.USER_ID = user_id
        self._USERNAME = self._get_user_name_from_vk_id(user_id)
        self.my_str = ""
        self._COMMANDS = ["привет", "погода", "время", "пока"]
        self._inputMes = {"основная информация": answers.about_us1,
                          "чем мы занимаемся ?": answers.about_us2,
                          "где мы находимся ?": answers.about_us3,
                          "ближайшие мероприятия": answers.events1,
                          "проведённые мероприятия": answers.events2,
                          "волонтёрство на мероприятие": answers.events3,
                          "действующие проекты в нгту": answers.events4,
                          "мероприятия межвузовского центра": answers.events5
                          }

Последнее свойство класса — inputMes — это особый словарь, у которого значения ключей — это текст из файла answers. py, где я расположил текст в виде строк, поэтому, чтобы не загромождать код я и вынес основной текст в другой файл.

(Пример кода из файла answers.py)

events1 = "Итак,ближайшие мероприятия:\\n\\n" \\
          "Форум «Байкал»\\n"\\
          "Конкурс «Цифровой ветер»\\n"\\
          "PRONETI"
events2 = "Вот список проведенных мероприятий:\\n"\\
        "МНТК\\n"\\
        "Семинары по проектной деятельности\\n"\\
        "Встреча с представителями предприятий\\n"\\
events3 = "По поводу этого критерия напиши Илье (<https://vk.com/ki1337ki>)\\n"\\
        "А также, ты можешь заполнить анкету, благодаря которой,\\n"\\
        "с тобой лично свяжется один из руководителей направления\\n"\\
        "или координатор проекта (<https://vk.com/nikyats>)"

Итак, основной метод класса — это new_message, который принимает один параметр — message, который обрабатывается соответствующим условным блоком и возвращает какое -то значение обратно туда, откуда был вызван.

def _get_user_name_from_vk_id(self, user_id):
    request = requests.get("<https://vk.com/id>" + str(user_id))
    bs = bs4.BeautifulSoup(request.text, "html.parser")
    user_name = self._clean_all_tag_from_str(bs.findAll("title")[0])
    return user_name.split()[0]
def new_message(self, message):
    # self.my_str = " ".join(re.findall('[0-9]{2}', message))
    if message.lower() == self._COMMANDS[0]:
        return f"Привет, {self._USERNAME}!"
    elif message.lower() == self._COMMANDS[1] or message.lower() == "узнать погоду ":
        return self._get_weather()
    elif message.lower() == self._COMMANDS[2] or message.lower() == "узнать точное время ":
        return self._get_time()
    elif message.lower() == self._COMMANDS[3]:
        return f"До скорой встречи, {self._USERNAME}!"
    else:
        for key, value in self._inputMes.items():
            if message.lower() == key:
                return value
        return "Не понимаю тебя "

3. Возвращаемся в manage.

Теперь в первых строках нам необходимо проимпортить файл vk_bot. А также нам потребуется библиотека random.

import random # pip install random
from vk_bot import VkBot

После того, как мы объявили longpoll, дописываем основной функционал.

longpoll = VkLongPoll(vk)
try:
    for event in longpoll.listen():
        if event.type == VkEventType.MESSAGE_NEW:
            if event.to_me:
                bot = VkBot(event.user_id)
                if event.text.lower() == "о нас":
                    write_msg(event.user_id, "Немного о нашем проекте", about_us_keyboard)
                elif event.text.lower() == "мероприятия":
                    write_msg(event.user_id, "Что ты хочешь узнать?", events_keyboard)
                elif event.text.lower() == "приложения":
                    write_msg(event.user_id, "Посмотри, что есть здесь!", app_keyboard)
                elif event. text.lower() == "контакты":
                    write_msg(event.user_id, "По любым вопросам можешь обращаться к:", contacts_keyboard)
                elif event.text.lower() == "задать вопрос руководителю проекта":
                    write_msg(event.user_id, "У тебя есть возможность написать сообщение нашему Руководителю проекта",
                              go_answer)
                elif event.text.lower() == "калькулятор":
                    write_msg(event.user_id, "В разработке...", calc_keyboard)
                # elif event.text == " ".join(re.findall('\\d{2}', event.text)):
                #     write_msg(event.user_id, "Отлично, мы здесь", calc_keyboard)
                elif event.text.lower() == "как попасть в команду ?":
                    write_msg(event.user_id, "Напиши координатору проекта - Никите\\n"
                                             "или перейди на сайт проектной деятельности,\\n"
                                             "найди проект номер 612 и подай заявку", in_team)
                else:
                    write_msg(event. user_id, bot.new_message(event.text), main_keyboard)
except Exception as e:
    print(e)

Как можете заметить, в условных блоках if и elif — присутствует обработка тех сообщений, которые подразумевают под собой вывод инлайн или встроенной клавиатуры (в данном примере — выводятся только инлайн клавиатуры). Сюда также можно добавить более сложные обработки сообщений, после которых обработка будет метаться туда сюда по блокам if и elif. Таким образом бот будет работать, пока не «упадёт с ошибкой».

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

Заключение

Надеюсь, что после прочтения данной статьи, Вы как минимум поняли основной принцип создания своего Telegram или Vk бота, а как максимум — легко сможете написать своего бота.

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

Весь код опубликован в моём профиле GitHub.

https://github.com/1chemp/telegram-bot — Телеграм Бот

https://github.com/1chemp/vk-bot — Бот Вконтакте

Первый бот — VKBottle

Добро пожаловать в первую часть туториала, здесь будет представлено как можно взаимодействовать с API и рассказано почему нужно использовать только асинхронные библиотеки при работе с vkbottle

Для начала работы с апи следует импортировать нужный объект — vkbottle.API

from vkbottle import API

API — готовый инструмент для того, чтобы делать запросы к апи вконтакте, приятная особенность этого инструмента в vkbottle — полная типизация (vkbottle-types). Что дает эта типизация?

Типизация

При условии, что у вас стоит нормальное IDE вы можете использовать подсказки типов:

Это значительно ускорит скорость разработки и позволит не обращаться в документацию api вконтакте каждый раз

Как уже стало понятно из картинки выше, для вызова метода используется ключевое слово await, которое является частью реализации асинхронности python, перед продолжением чтения туториала рекомендуется почитать официальную документацию, если вы этого не делали

Первый запрос

Для того чтобы инициализировать API вам понадобится строка (токен) или вы можете использовать лист строк (токенов), которые автоматически конвертируются в специальный token-generator

Обернем наш будущий запрос базовым способом исполнения асинхронного кода:

import asyncio
async def main():
    . ..
asyncio.run(main())

Теперь напишем само взаимодействие:

api = API("token")
await api.wall.post(message="#vkbottle прекрасен!")

Такой запрос создаст пост на стене группы/пользователя с указанным текстом, как вы видите параметры запроса принимаются в качестве аргументов (IDE вам все подскажет)

Вот, что должно получиться в итоге:

import asyncio
from vkbottle import API
async def main():
    api = API("token")
    await api.wall.post(message="#vkbottle прекрасен!")
asyncio.run(main())

Поздравляю, теперь вы умеете работать с инструментом API!

Первый бот

Чтобы начать работу с ботом, требуется импортировать класс Bot из корня проекта (vkbottle.Bot) или из специализированного пакета (vkbottle.bot.Bot):

Внимание

Bot — это бот исключительно для группы, если вы хотите юзербота, то сначала ознакомьтесь с этим.

from vkbottle.bot import Bot

Для инициализации бота обязателен аргумент — token или api. token нужен для сокращения кода: если вы передадите token, будет создан API с соответствующим генератором токена. Если вы передадите api, он и будет использоваться для бота

# Инициализация токеном
bot = Bot(token="token")
# (или) Инициализация с апи
bot = Bot(api=api)

Теперь вы можете добавить нужные хендлеры, за удобное добавление хендлеров отвечает элемент labeler, к которому вы можете обратиться через bot.labeler или bot.on (.on нужен просто для красоты и для традиционного legacy вкботла из второй версии)

from vkbottle.bot import Bot, Message
bot = Bot(token="token")
@bot.on.message(text="Привет")
async def hi_handler(message: Message):
    users_info = await bot.api.users.get(message.from_id)
    await message.answer("Привет, {}".format(users_info[0].first_name))
bot.run_forever()

Разберем новый код построчно:

@bot.on.message(text="Привет") — это декоратор, он означает, что если сообщение будет отвечать заданным правилам (text="привет"), сработает хендлер под декоратором

Для сообщений в vkbottle существует 3 декоратора:

. message — обрабатывает сообщения и из бесед и из личных переписок

.private_message — обрабатывает сообщения только из личных переписок

.chat_message — обрабатывает сообщения только из бесед

async def hi_handler(message: Message) — объявление хендлера, hi_handler — название функции, может быть разумно любым, message — аргумент, который обязательно вернется в хендлер, нужный для получения информации о событии

users_info = await bot.api.users.get(message.from_id) — запрос к API, получение информации о пользователе, написавшем сообщение

await message.answer("Привет, {}".format(users_info[0].first_name)) — отправка сообщения в чат с пользователем, answer — удобный шорткат для ответа на сообщения, аргументы идентичны методу messages.send, но шорткат не требует id чата и random_id

bot.run_forever() — помогает асинхронно запустить бота из синхронной среды, если бы была создана асинхронная, вы бы могли использовать await run_polling()

Если представленный код не работает, проверьте поставили ли вы галочки в настройках лонгпола на нужные события (в данном случае на новые сообщения) и сам лонгпол (стабильна версия 5. 131)

Экзамплы по этой части туториала

• easy-bot

Работаем с Чатом ВКонтакте

ПОЛЕЗНЫЕ ФУНКЦИИ, ПРИНЦИПЫ ОБЩЕНИЯ С ПОЛЬЗОВАТЕЛЯМИ И ВОЗМОЖНОСТИ АВТОМАТИЗАЦИИ

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

Станислав Хрусталёв

Первое, что стоит сделать, – это решить: подключать или не подключать функционал «Сообщения сообщества» в меню управления страницей

Подключение функции сообщений

С этого момента ваши клиенты смогут с вами общаться через ВКонтакте

При его подключении на странице появится интуитивно понятная кнопка «Написать сообщение»

Так сообщения сообщества выглядят в версии сайта ВКонтакте для ПК

А так – в мобильном приложении VK

Если вы решили использовать группу как дополнительный канал коммуникации, обязательно включайте этот функционал. Однако если вы планируете использовать сообщество в качестве заглушки или у вас нет ресурсов на то, чтобы оперативно обработать входящие сообщения, лучше вообще не включать этот функционал. Почему? Если пользователь зайдет в ваше сообщество, увидит контактные данные и свяжется по другому каналу (например, по указанному телефону), его customer experience будет нейтральным. Однако если он увидит, что можно написать ВКонтакте, и решит выйти на связь, а ему не ответят/ответят с задержкой, это точно вызовет негатив

Вы также можете упростить путь клиента, если ему нужно связаться с вами, давая вместо ссылки на сообщество прямую ссылку на диалог. Таким образом, для начала общения ему придется сделать не два клика, а всего лишь один. Прямая ссылка на диалог будет отличаться от ссылки на сообщество лишь доменом: вместо vk.com/название_сообщества используйте vk.me/название_сообщества. Эту ссылку вы можете использовать как онлайн, так и оффлайн. Например, на коробке с доставленной продукцией я могу увидеть наклейку: «Есть вопросы или возникли проблемы? Свяжись с нами ВКонтакте» и QR-код, содержащий ссылку на диалог с сообществом (QR-коды можно сгенерировать при помощи множества бесплатных сервисов, например, goqr. me)

Ссылка на диалог с сообществом

Помимо общения только в рамках ВКонтакте вы также можете настроить специальный виджет для чата ВКонтакте и установить его на свой сайт

Виджет ВКонтакте для сайта

Виджет чата ВКонтакте на сайте сервиса для парсинга аудитории Target Hunter

С одной стороны, это удобная функция, но с другой – вам нужно ответить на вопрос: «Какая часть моей аудитории использует ВКонтакте?». И если ответ – не 100%, лучше воспользоваться решениями для чата на сайте, позволяющими клиенту выбрать различные каналы связи

Это должны быть те, кто помимо ВКонтакте отвечает на вопросы клиентов по телефону, по email, через остальные сети и мессенджеры – служба поддержки. В этом случае можно быть уверенным, что поддержка клиентов будет вестись в рамках единой канвы вне зависимости от канала

Кто должен отвечать пользователям?

Дайте клиентам знать, что вы ответите прямо сейчас. Для этого есть специальная функция, которую можно подключить в разделе «Сообщения» на вашей странице

Статус «Онлайн»

В версии ВКонтакте для ПК индикатор отображается прямо в кнопке «Написать сообщение»

В мобильном приложении индикатор статуса «Онлайн» отображается под обложкой и выделяется зеленым цветом

Однако здесь важен следующий момент: включайте статус «Онлайн» только тогда, когда вы реально можете ответить в моменте, а не с задержкой в час. В противном случае это приведет к неоправданным ожиданиям и негативу со стороны клиентов. ВКонтакте старается это предотвратить, поэтому если вы не отвечаете на входящие сообщения в течение нескольких минут, статус «Онлайн» автоматически исчезает

В идеале поддержка клиентов должна вестись в режиме 24/7, но если у вас не хватает на это ресурсов, настройте чат-бота на работу в качестве автоответчика: установите время работы чат-бота в соответствии с вашим нерабочим временем и добавьте автоматическую реакцию на любой текст в виде сообщения, например, «К сожалению, нас сейчас нет на месте, но мы обязательно ответим вам завтра c 9:00». В этом случае клиент хотя бы будет понимать, когда стоит ожидать ответа. В подавляющем большинстве сервисов подобный функционал очень легко реализовать: например, в сервисе robochat.io у меня на это ушло не больше 5 минут

Ответы во внерабочее время

Вы можете настроить приветствие в окне сообщения при первом открытии диалога, однако размер его ограничен 200 символами, и много информации в него упаковать не получится. Поэтому сюда можно добавить лишь краткое приветствие, например, «Доброго времени суток! Чем мы можем Вам помочь?» или предупредить пользователя о том, что сейчас они будут общаться с чат-ботом

Приветствие в диалоге

Это первое сообщение, которое увидит ваш потенциальный клиент, открыв диалог

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

Реакция на первое сообщение

Помимо приветствий в диалогах вы можете настроить сообщение, которое будет отправлено пользователю при подписке на сообщество. Эта функция недоступна в рамках стандартного функционала ВКонтакте, но ее можно реализовать с помощью одного из сервисов создания чат-ботов. В таком сообщении вы сразу же можете рассказать пользователю о том, почему сообщество будет ему ценно, о структуре контента, об акциях, которые вы будете размещать только для подписчиков и т.д. Основная задача здесь – заинтересовать пользователя. Однако здесь есть одно ограничение: сообщение будет отправлено только если пользователь открывал диалог с вашим сообществом до этого.
В качестве примера можно рассмотреть механику привлечения в сообщество через скидку на продукцию: вы владелец кафе, продвигаете свое сообщество ВКонтакте по различным каналам и предлагаете, например, скидку на кофе за подписку. При создании чатбота в приветственном сообщении вы вставляете промо-код и инструкцию по его использованию. Подписавшись, пользователь получает сообщение с промо-кодом и при следующей покупке использует скидку

Реакция на подписку

ВКонтакте помогает формировать ожидания пользователей, отображая среднее время ответа компании при начале диалога с ней. Среднее время ответа рассчитывается автоматически на базе ответов за последние 3 дня

Индикатор скорости ответа

Для соц.сетей скорость ответа в 1 час – это довольно медленно, т.к. пользователи зачастую ищут ответ на свои вопросы в моменте

И если потенциальный клиент решит узнать дополнительные детали по продукции и увидит, что один из конкурентов отвечает в течение 5 минут, а другой – в течение нескольких дней, у первого шансы заполучить клиента будут гораздо выше

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

Оперативность ответа

Отвечая клиентам в моменте, старайтесь достичь именно такого индикатора

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

Оповещения

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

Индикатор сообщений

Вы можете установить приложение для администраторов VK Admin, которое не только будет оповещать вас с помощью push-уведомлений о новых сообщениях от клиентов, но и даст возможность отвечать на запросы прямо через смартфон, если вы не в офисе

VK Admin

Интегрировать сообщения сообщества ВКонтакте с вашей CRM-системой при помощи API и получать оповещения уже внутри CRM

CRM система

Так как индикатор скорости ответа фиксирует лишь ваше первое ответное сообщение, старайтесь отправить его как можно быстрее. Например, еще до основного ответа, сразу после получения сообщения отправить что-то типа «Станислав, добрый день! Мы получили Ваше сообщение, обязательно ответим в течение 10 минут!», закончить обработку предыдущих запросов и вернуться к клиенту. Таким образом, и клиент поймет, что его сообщением сейчас займутся, а индикатор скорости ответа посчитает, что он был получен оперативно. Кроме того, т.к. во всех соц.сетях и мессенджерах теперь видно, что собеседник прочитал ваше сообщение, нельзя просто ознакомиться со входящим запросом и начать думать – ведь в этом случае на другой стороне клиент увидит, что его сообщение прочитали, но не отвечают

Подтверждение о получении запроса

Для удобства работы администраторов в сообщениях сообщества ВКонтакте есть 3 специальных папки: непрочитанные (которые вы еще даже не открыли), неотвеченные (были просмотрены вами, но не получили ответа) и важные. Первые 2 категории влияют на время, отображаемое в индикаторе скорости ответа, о котором мы говорили ранее, поэтому важно обязательно подтверждать их получение либо маркировать диалог как завершенный (если клиент нас просто поблагодарил в конце беседы, и его сообщение оказалось последним). Также диалоги можно переводить в папку «Важные» – это будет означать, что с клиентом нужно связаться через некоторое время. Однако это лишь минимальный набор категорий, поэтому сейчас категоризацию и тегирование сообщений можно делать с помощью API ВКонтакте: либо уже в своей CRM, либо если вы используете сторонний сервис

Работа с категориями сообщений

Социальной сетью ВКонтакте мир не ограничивается: до того, как обратиться к вам через чат ВКонтакте, клиент может писать вам в Facebook, Whatsapp, направлять вам email’ы и т.д. И здесь важно, чтобы вы были в курсе всех предыдущих взаимодействий с ним и не общались с клиентом, как будто он обратился к вам впервые, если он связывается с вами уже 5-ый раз, пытаясь решить свою проблему. Внедрение омниканального подхода для бизнесов с большими клиентскими базами требует значительных усилий по автоматизации, и об этом мы поговорим в отдельной статье. Но на уровне малого бизнеса с минимумом ресурсов программа минимум – это при получении сообщения от клиента посмотреть предыдущую переписку в диалоге ВКонтакте и вручную проверить в CRM и других сетях, не общались ли вы с ним до этого

Омниканальность

ПОДПИСАТЬСЯ

Омниканальность – это большая комплексная тема, о которой мы поговорим в одной из следующих статей. Подписывайтесь и будьте в курсе выхода новых материалов.

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

Голосовые сообщения

Голосовые сообщения в чате ВКонтакте могут позиционироваться, как альтернатива входящим звонкам от клиентов

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

Шаблоны сообщений

Проанализируйте входящие запросы и подготовьте стандартные ответы на них

Анализ истории

Для персонализации пользовательского опыта вы также можете использовать имя и фамилию клиента, имя и фамилию администратора, который отвечает на сообщение, название сообщества и автоматическое приветствие (добрый день/добрый вечер).

Персонализация

Создайте шаблон на базе наиболее часто задаваемых вопросов и персонализируйте его с помощью специальных полей

В будущем он будет доступен вам в 2 клика при ответе на входящие запросы клиентов. Имя клиента, ваше имя, название сообщества и текст приветствия будут автоматически заполнены актуальными значениями

Предыдущий пример со скидкой на кофе от владельца кафе можно переиграть следующим образом: вместо включения промо-кода в приветственное сообщение вы заготавливаете шаблон и отсылаете его всем, кто обращается за промо-кодом: «Привет, Станислав! Это Антон из Кафе Х. Как и обещали, вот ваш промо-код на скидку 20% при покупке кофе HAPPYCOFFEE – сообщите его в следующий раз на кассе». В этом случае Станислав – имя клиента, Антон – имя отвечающего администратора, Кафе Х – название сообщества. Все это будет подставляться автоматически

Если в шаблоне вы используете автоматически подставляемые данные, не забывайте их проверить после выбора шаблона. Если пользователь нечаянно поменял имя и фамилию местами, может получиться казус: «Здравствуйте, Хрусталев! Чем мы можем вам помочь?»

Проверка шаблонов

Также не забудьте, что ответы должны соответствовать по тональности сообщениям клиента, и, если кто-то написал вам менее формальное сообщение, не стоит отправлять ему стандартное формальное сообщение, а перед отправкой подправить шаблон

Тональность ответов в шаблоне

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

Обновление шаблонов

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

Порядок в шаблонах

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

Ответ на конкретное сообщение

На каждый вопрос можно отвечать по отдельности. Это позволяет избежать путаницы

Для того чтобы с одним клиентом не начали общаться сразу несколько администраторов, ВКонтакте предусмотрена функция, которая блокирует диалог для всех, кроме того, кто первым начал отвечать клиенту. Функция срабатывает автоматически, поэтому неразберихи в чате не произойдет

Блокировка диалога

Естественно, что ваше общение с клиентами не ограничивается только сетью ВКонтакте, а количество каналов связи может перевалить за десяток. Поэтому в рамках построения системы поддержки необходимо максимально упростить работу операторов – так, чтобы они не разрывались между несколькими социальными сетями, мессенджерами и email’ом. В этом случае вы можете воспользоваться API ВКонтакте, чтобы интегрировать сообщения от клиентов в этой сети в вашу CRM-систему и позволить операторам отвечать на запросы в различных сетях через единый кабинет. Если у вас нет ресурсов на интеграцию с CRM, в качестве хорошей альтернативы также могу посоветовать сервис TextBack, позволяющий решить эту задачу

Интеграция с CRM

С помощью API ВКонтакте вы можете собирать обратную связь от клиентов: после окончания диалога клиент может получить от вас сообщение с просьбой оценить службу поддержки и двумя кнопками. Если клиенту что-то не понравилось, вы можете предложить ему описать причину недовольства и оповестить сотрудника, ответственного за контроль качества. Выглядеть это может вот так:

Оценка качества обслуживания

Клиенту лишь нужно нажать на кнопку, соответствующую его впечатлениям от использования сервиса – все максимально просто

Если я нажимаю на кнопку «Мне не понравилось», чат-бот оповещает сотрудника и с сожалением спрашивает, что же мне не понравилось, а я могу выбрать одну из причин, просто нажав на кнопку

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

Работа с контекстом и омниканальность

Эта механика схожа с реакцией на подписку: ее можно реализовать в рамках чат-бота, и она также будет отправлена только в том случае, если клиент общался с сообществом через чат. Однако если есть возможность реализовать такую функцию, почему бы ее не реализовать? В реакции на отписку вы можете добавить сообщение с сожалением и предложить выбрать из списка причину, по которой клиент решил отписаться. Помимо этого, если клиент предоставил обратную связь, вы также можете воспользоваться одной из механик удержания: предложить скидку, подарок при повторной покупке, бесплатную доставку при следующем заказе и т. д. Таким образом, вы не только покажете клиенту, что цените его, но и соберете ценную информацию об основных причинах отписки

Реакция на отписку

Если вы решили создать чат-бота, помните: чем сложнее его функционал, тем выше вероятность возникновения ошибок, поэтому перед тем, как подключить чат-бота к сообщениям и открыть для пользователей, дайте его протестировать коллегам и попросите оценить, насколько интуитивен интерфейс и как реализованы различные функции

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

Чат-боты как технология постепенно набирают популярность, но не всегда стоит слепо следовать тренду – иначе есть риск того, что технология сработает против вас:

Чат-бот vs. связь с оператором

Во-первых, перед тем, как разрабатывать чат-бота, спросите у клиентов, насколько это нововведение было бы для них ценно

Ценность в глазах клиентов

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

Связь с человеком

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

Остановка бота

При использовании чат-бота старайтесь максимально упростить для клиента ввод информации и вместо набора какой-либо команды предлагайте ему выбрать из нескольких вариантов, реализованных в виде кнопок

Кнопки в чат-ботах

Мне не нужно писать адрес для самовывоза в чат – достаточно просто нажать на кнопку

Сделайте так, чтобы кнопки привлекали внимание: добавьте в них эмоджи и задайте цвет, соответствующий варианту ответа (синий – основной, серый – второстепенный, зеленый – позитивный ответ, красный – негативный ответ). Таким образом, кнопки станут более заметными, и пользователю легче будет сориентироваться

Emoji соответствуют вариантам ответа и добавляют кнопкам красок, а подсветка кнопок синим и белым цветами проводит разделение между двумя типами команд: выбором транспорта и запросом связи с оператором

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

С помощью чат-бота вы также можете помочь пользователю выбрать товар в вашем интернет-магазине или уточнить наличие билетов. Однако, помимо этого, в рамках диалога теперь также можно провести и оплату через VK Pay или Яндекс.Деньги

Оплата с помощью чат-бота

В рамках чата ВКонтакте вы можете автоматизировать множество операций, например, бронирование столика в ресторане, запись в салон, заказ пиццы и т.д. При этом важно, чтобы данные, вводимые клиентом (например, телефон и email), проверялись на корректность, и чат-бот просил его повторить ввод, если данные содержат ошибки. Поэтому обязательно реализуйте функции валидации данных, если самостоятельно пишете чат-бота, или проверьте, есть ли подобный функционал в конструкторе чат-ботов, которым вы пользуетесь

Валидация вводимых данных

Некоторые сервисы по созданию чат-ботов для ВКонтакте позволяют вам задавать интервалы между сообщениями – от секунды до нескольких дней. Этот функционал можно использовать, продумывая customer journey ваших клиентов. Например, если пользователь решил купить товар в вашем интернет-магазине, нажал на кнопку «Оплатить через VK Pay» и транзакция прошла успешно, цепочка сообщений на этом не заканчивается, и через несколько дней пользователь получает сообщение a-la «Ну как, успели попробовать наш продукт? Надеемся, все понравилось. А если нет, пожалуйста, дайте нам знать»

Сообщения, отложенные во времени

Итак, мы поговорили с вами о чате ВКонтакте – о том, какие полезные функции предоставляет нам сама социальная сеть, о том, каких принципов стоит придерживаться при работе с клиентами через чат, а также о возможностях автоматизации и фишках, связанных с ней. Но чат – не единственный канал связи между вашей компанией и клиентами, ведь помимо этого вы можете взаимодействовать с аудиторией через публикации в ленте новостей, истории, прямые трансляции и рассылки, не говоря уже о множестве приложений, которые также могут стать точками контакта с клиентами.

TO BE CONTINUED…

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

ПОДПИСАТЬСЯ

ЧИТАТЬ ДАЛЕЕ

бот vk api python отправляет разные сообщения разным людям, в то время как они пишут одно и то же сообщение

Войти

Добро пожаловать! Войдите в свою учетную запись

ваше имя пользователя

ваш пароль

Забыли свой пароль?

Восстановление пароля

Восстановить пароль

ваш адрес электронной почты

Поиск

Автор

Дата

30. 09.2021

Категория

У меня есть бот для разговора ВК и матерная компания Мне нужно сделать если (их 5 человек) Лёха обматерил его, одного добавили в список переменная, а если Матвей ругался, то ему добавлялась единица и каждые 24 часа присылалось сообщение, сколько раз он ругался. Как это сделать правильно если есть возможность, желательно через если с пояснением. Я новичок в этом или ссылка на статью хотя бы с похожим вопросом

 случайный импорт, vk_api, vk
из vk_api.keyboard импортировать VkKeyboard, VkKeyboardColor
из vk_api.utils импортировать get_random_id
запросы на импорт
импорт системы
время импорта
импорт потоков
импортировать json
vk_session = vk_api.VkApi (токен = 'ТОКЕН')
из vk_api.bot_longpoll импортировать VkBotLongPoll, VkBotEventType
longpoll = VkBotLongPoll (vk_session, 204434733)
vk = vk_session.get_api ()
из vk_api.longpoll импортировать VkLongPoll, VkEventType
Lslongpoll = VkLongPoll (vk_session)
Lsvk = vk_session.get_api ()
деф бот ():
  lsvk. messages.send (
  идентификатор_пользователя = 496658805,
  message = "Бот запущен!",
  случайный_ид = получить_случайный_ид ()
  )
  для события в longpoll.listen():
    если event.type == VkBotEventType.MESSAGE_NEW:
      если 'BOT' в ул (событие) или 'Бот' в ул (событие) или 'бот' в ул (событие):
        если событие.from_chat:
          если событие.от_пользователя:
            vk.messages.send (
            key = ('b0409379fb3b81632ee943deb2e99280c53dd520'), # ВСТАВИТЬ ПАРАМЕТРЫ
            сервер = ('https://lp.vk.com/wh304434733'),
            ц = ('1'),
            случайный_ид = получить_случайный_ид(),
            сообщение = 'Привет! Я бот DDRX5, теперь вы можете звать меня по имени! ',
chat_id = событие.chat_id
            )
бот = threading.Thread (цель = бот)
бот.старт ()
################################################## # ##############
кроме:
  lsvk.messages.send (
    идентификатор_пользователя = 496658805,
    message = "Бот отключен :(",
    случайный_ид = получить_случайный_ид ()
   )
 

Вот и весь мой бот

Вот так я написал и user_id подчеркнут красным

 import random,vk_api,vk
из vk_api. keyboard импортировать VkKeyboard, VkKeyboardColor
из vk_api.utils импортировать get_random_id
запросы на импорт
импорт системы
время импорта
импорт потоков
импортировать json
из коллекций импортировать defaultdict
user_by_counter = defaultdict (целое число)
пытаться:
vk_session = vk_api.VkApi (токен = '')
из vk_api.bot_longpoll импортировать VkBotLongPoll, VkBotEventType
longpoll = VkBotLongPoll (vk_session, 204434733)
vk = vk_session.get_api ()
из vk_api.longpoll импортировать VkLongPoll, VkEventType
Lslongpoll = VkLongPoll (vk_session)
Lsvk = vk_session.get_api ()
деф бот ():
  lsvk.messages.send (
  идентификатор_пользователя = 496658805,
  message = "Бот запущен!",
  случайный_ид = получить_случайный_ид ()
  )
  для события в longpoll.listen():
    если event.type == VkBotEventType.MESSAGE_NEW:
      если 'BOT' в ул (событие) или 'Бот' в ул (событие) или 'бот' в ул (событие):
        если событие.from_chat:
          user_by_counter [user_id] + = 1
          vk. messages.send (
            key = 'b0409379fb3b81632ee943deb2e99280c53dd520', # ВСТАВИТЬ ПАРАМЕТРЫ
            сервер = ('https://lp.vk.com/wh304434733'),
            ц = ('1'),
            случайный_ид = получить_случайный_ид(),
            сообщение = 'Привет! Я бот DDRX5, теперь вы можете звать меня по имени! ',
chat_id = событие.chat_id
            )
 

В начале после всех импортов с новой строки пишем from collections import defaultdict
а на второй user_by_counter = defaultdict(int)

а что должно быть в отправке сообщения, точнее как это должно выглядеть

 для события в longpoll.listen():
      если event.type == VkBotEventType.MESSAGE_NEW:
        если «Текст от пользователя» в строке (событие):
          если событие.from_chat:
            user_id = событие.obj.from_id
            user_by_counter [user_id] + = 1
            vk.messages.send (
              key = (''), # ВСТАВИТЬ ПАРАМЕТРЫ
              сервер = (''),
              ц = (''),
              случайный_ид = получить_случайный_ид(),
              сообщение = 'ответить пользователю',
              chat_id = событие. chat_id
              )
 

© Copyright — Газета TagDiv

node-vk-bot — Анализ работоспособности пакетов npm

Все уязвимости безопасности принадлежат производственных зависимостей прямых и косвенных пакеты.

Риск безопасности и лицензии для основных версий

Все версии

Версия				Уязвимости	Лицензионный риск
1.2.3	|	12/2018		C H M L	H M L
1. 1.0	|	09/2018		С H M L	H M L
0. 3.1	|	06/2018		C H M L	H M L
0. 2.6	|	03/2018	Popular	C H M L	H M L
0. 1.5	|	02/2017		C H M L	H M L

Ваш проект подвержен уязвимостям?

Сканируйте свои проекты на наличие уязвимостей. Быстро исправить с помощью автоматизированного исправления. Начните работу со Snyk бесплатно.

Начните бесплатно

Еженедельные загрузки (44)

Скачать тренд

Иждивенцы

0

Звезды GitHub

35

Вилки

11

Авторы

9

Популярность прямого использования

Пакет npm node-vk-bot получает в общей сложности 44 загрузки в неделю. Таким образом, мы забили Уровень популярности node-vk-bot будет ограничен.

На основе статистики проекта из репозитория GitHub для npm пакет node-vk-bot, мы обнаружили, что он был снялся 35 раз, и это 0 других проектов в экосистеме зависят от него.

Загрузки рассчитываются как скользящие средние за период из последних 12 месяцев, за исключением выходных и известных отсутствующих точек данных.

Частота фиксации

Нет последних коммитов

Открытые задачи

4

Открытый PR

0

Последняя версия

4 года назад

Последняя фиксация

4 года назад

Дальнейший анализ состояния обслуживания node-vk-bot на основе каденция выпущенных версий npm, активность репозитория, и другие точки данных определили, что его обслуживание Неактивный.

Важным сигналом обслуживания проекта, который следует учитывать для node-vk-bot, является это не видел никаких новых версий, выпущенных для npm в за последние 12 месяцев и может считаться прекращенным проектом или проектом, который получает мало внимания со стороны его сопровождающих.

За последний месяц мы не обнаружили никаких запросов на вытягивание или изменений в статус issue был обнаружен для репозитория GitHub.

Совместимость с Node.js

не определено

Возраст

6 лет

Зависимости

3 прямых

Версии

36

Размер установки

66 КБ

Распределенные теги

1

Количество файлов

113

Обслуживающий персонал

1

Типы TS

Да

node-vk-bot имеет более одного и последнего тега по умолчанию, опубликованного для пакет нпм. Это означает, что для этого могут быть доступны другие теги. пакет, например рядом, чтобы указать будущие выпуски, или стабильный, чтобы указать стабильные релизы.

Как подтвердить адрес сервера с ботом Вк?

Результатом является более сложная перестановка, которую нелегко реконструировать. Структура шифра Фейстеля. Входными данными для алгоритма шифрования являются блоки открытого текста.

Сая членского хостинга 138 руб., без использования другой инфраструктуры, агар-бота, berfungsi: резервирование для Python + Django MySQL DBMS 25 ГБ, резервирование без SSH.

сообщения.Как отправлять POST запросы к VK API Stack Overflow ВКонтакте Как отправить длинное сообщение средствами VK API? Чат-бот Helperbyte Python ВКонтакте который.

Продукт находится на стадии тестирования. Пожалуйста, сообщайте обо всех недостатках через кнопку «Поддержка приложения» в настройках. «Контакт» — новый быстрый и надежный клиент для.

Связаться с техподдержкой через виджет в углу экрана. Вернуться в главное меню.Статьи по теме.Как подключить ВКонтакте? Создайте общедоступную страницу.

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

Shift — настольное приложение для управления Stack Overflow и всеми другими приложениями и учетными записями электронной почты в одном месте. Логотип Stack Overflow. Интеграция с Stack Overflow.

Многоканальная платформа поддержки клиентов: все цифровые каналы в одном интерфейсе + ИИ Хотите знать, как связать Usedesk с социальными сетями VTEX?

Криптография и сетевая безопасность. Автор Атул Кахате. Об этой книге Tata McGrawHill Education. Страницы отображаются с разрешения Tata McGrawHill Education.

Предполагаемая аудитория xiii.План книги xiv.Интернет-услуги для преподавателей и студентов xiv.Проекты по обучению криптографии и сетевой безопасности.

Python vk vkapi Обновлено 6 января 2019 г .; питон; negezor.Скрипт бота вконтакте будет доступен после установки.Для удаления ботов с сервера Discord следуйте инструкциям.

Обзор 2890 лучших библиотек Go vkapi Узнайте, как проектировать крупномасштабные системы. Помогите открыть локальный сервер за NAT или брандмауэром в Интернете.

Bot API — это интерфейс на основе HTTP, созданный для разработчиков, занимающихся созданием ботов для разрешенной отправки счетов в групповые супергрупповые и канальные чаты.

Отправка параметров Описание Иногда может потребоваться, чтобы пользователь перешел по ссылке в определенный диалог. ВКонтакте использует сервис коротких URL vk.me, который ожидает сообщения от сервера обмена сообщениями, а не.

Различные классы ошибок; регистратор; Другой метод аутентификации; Полезный Bot API, содержащий ключ API, на общедоступный форум, например, в GitHub Issues или Stack Overflow.

В этом руководстве описывается, как использовать API обмена сообщениями для создания LINE bot. URL-адрес веб-перехватчика — это конечная точка вашего бот-сервера, куда отправляются полезные нагрузки веб-перехватчика.

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

@vkontakte/callssdk Библиотека для видеозвонков на платформе vk.com @vkontakte/svgsprite Множество SVG-спрайтов и стеков Низкоуровневый модуль Node.js.

Это простой API бота ВКонтакте. Для работы вам необходимо получить токен доступа ВКонтакте с правами: messagesfriendsoffline см. ниже.https://github.com/nikepan/govkbot.

Вконтакте sdkfingerprint некорректен только на случайных устройствах Чат-бот вк с python + vkapi Как подтвердить URL сервера с ботом вк? php боты вк.

Buffer.easy.No Info Available Stack Overflow / Stack Exchange Accounts JustDelete.me стремится быть каталогом URL-адресов, чтобы вы могли легко удалять.

Prentice Hall 2011 Компьютеры 719 страниц. 3 Обзоры. Криптография и сетевая безопасность Уильяма Столлингса: принципы и практика 5e является практическим.

Здравствуйте! Написал бота для общения вк на PYTHON.Сейчас хочу его залить на хостинг чтобы бот работал нон-стоп и понимаю что не надо.

Инструмент для преобразования экспорта коллекции Postman в документацию Api Blueprint.Go 0.0k 0.0k.nikepan/govkbot.govkbot.VK Пакет бота для Go.Go 0.0k 0.0k.

.роботизированные платформы для создания и демонстрации новых возможностей задач роботов.для графического и вычислительного API Vulkan; VKGLCTS: Хронос Вулкан OpenGL.

С базой знаний Crisp вы можете создать многоязычный центр знаний, совместимый с вашим Viber Instagram Telegram VKontakte Chat2Desk Enterprise.

connect.ВКонтакте.ВКонтакте — российская социальная сеть, активно используемая для поддержки продаж с использованием чат-ботов в мессенджерах и искусственного интеллекта.

20211110 pkgndep Проверка тяжести зависимостей пакетов urlshorteneR R-оболочка для служб сокращения URL-адресов Bit. ly и Is.gd/v.gd.

Предисловие Прошу прощения, что не написал о работе с БД в первой статье, но эта часть посвящена работе с MySQL. Часть 3 w.

Фреймворк ботов ВКонтакте для Node.js на основе Bots Long Poll API и Callback API.bot.event’messageedit’ ctx { ctx.reply’Ваше сообщение было отредактировано’; }.

Фреймворк ботов ВКонтакте для Node.js на основе Bots Long Poll API и Callback API. Неплохо bot.command’/start’ async ctx { try { await ctx.reply’Hello.

Как подключить ВКонтакте? База знаний Chat2Desk.com узнайте больше о чат-центре для бизнеса WhatsApp Viber Telegram виджеты на вашем.

searchgirls не сообщает об уязвимостях, и в его зависимых библиотеках нет botact 20.JavaScript.Библиотека для создания ботов ВКонтакте на Node.js.

GitHub — это место, где люди создают программное обеспечение. Более 73 миллионов человек используют GitHub, чтобы найти ответвление и внести свой вклад в более чем 200 пакетов ботов VK для Go.

Пользователи могут взаимодействовать с ботами, отправляя им сообщения, команды и встроенные запросы. Вы управляете своими ботами, используя HTTPS-запросы к нашему Bot API.

Обзор самых популярных 16 Javascript Bot Vk Open Source Projects.Botact 20 Библиотека для создания ботов ВКонтакте на Node.js Vk To Telegram 18.

Tata McGrawHill Education 2003 Компьютерные сети 435 страниц Тематические исследования по криптографии и безопасности Ответы на вопросы с множественным выбором.

Есть код бота в целом работа его устраивает.Но не могу допилить как сделать что бы применить их в данной задаче.Подскажите куда копать.

Фреймворк бота ВКонтакте для Node.js на основе Bots Long Poll API и API обратного вызова. GitHub nodevkbotapi/nodevkbotapi: фреймворк бота ВКонтакте для Node.js.

Пакет ботов nikepan/govkbot.VK для Go.Current tag: v2.0.12 tagged 1 год назад | Последнее нажатие: 1 год назад | Звездочеты: 36 | Отжиманий в день: 0.

Фреймворк ботов ВКонтакте для Node.js на основе Bots Long Poll API и библиотеки Callback API для создания ботов Вконтакте с легкостью. vkvkontaktevkapi.

Как решить проблему с пересылкой сообщений? javascript node.js bots vk. Я создал чат-бот с использованием библиотеки botact, но когда я.

Nginx Essentials; Поваренная книга Nginx; Nginx HTTP Server Ru VK и Rambler. Короче говоря, он обеспечивает ядро ​​полных веб-стеков и является.

Ответы на большинство задач даны в конце книги. Основные характеристики Тема проиллюстрирована примерно 200 рисунками.

Как создать бота в вк или VK Callback API.Здравствуйте! Недавно на одном проекте пришлось столкнуться с ботом ВК, который живет в групповых сообщениях.

Легко создавать и контролировать ботов ВКонтакте.Botact 20 Библиотека для создания ботов ВКонтакте на Node.js Emailrepbotvk 7 Бот ВКонтакте на основе модуля vkio.

Целью этой книги является предоставление практического обзора как принципов, так и практики криптографии и сетевой безопасности.

nikepan/govkbot Пакет Go VK bot Это простой API бота VK.com. Старые версии Go вы также можете использовать go get github. com/nikepan/govkbot/v2.

Чат-центр Chat2Desk для продаж и поддержки APK Kontakt Client for VK VKontakte APK VK Video Master Загрузчик видео ВКонтакте APK.

Установка проксируемого url в плагине flutter videoplayer для hls Также в программе есть бот ВК, который должен работать при .

Разработчик Node.js Создатель @nodevkbotapi и @micromq.bifot/botact.Библиотека для создания ботов ВКонтакте на Node.js.5.20.JavaScript.

Это простой API бота ВКонтакте. В 201 ВКонтакте было ограничено messages.send для usertokens. Этот бот может работать с grouptoken и.

В facebook есть бот, который должен отправлять сообщения пользователям. Бот отправляет им токен сообщения с идентификатором пользователя.

Функциональная библиотека для поддержки ВКонтакте API API на node.js slack discord whatsapp twitter instagram и создание ботов вк.

Фреймворк ботов ВКонтакте для Node.js на основе Bots Long Poll API и Callback API.govkbot nikepan / govkbot.Пакет ботов ВКонтакте для Go.

http://socialbase.ru/vkontakte.php?userid474897436 https://evilcoder.ru/oshibkivopencartapiiliskazotompochemuzhno.

Каково же было мое удивление, когда я начал курить группы VK API касательно сообщений, я увидел это чудо Callback API.

http://socialbase.ru/vkontakte.php?userid474897436 https://evilcoder.ru/oshibkivopencartapiiliskazotompochemunuzhno

Сделать запрос в форме https://api.vk.com/method/messages.send?chatid&. Бот в беседе дал.

Пакет бота ВКонтакте для Go. Внесите свой вклад в развитие nikepan/govkbot, создав учетную запись на GitHub.

Пакет ВК для Go. Внесите свой вклад в развитие nikepan/govkbot, создав учетную запись на GitHub.

Пакет бота ВКонтакте для Go. Внесите свой вклад в развитие nikepan/govkbot, создав учетную запись на GitHub.

Здравствуйте! Написал бота для общения вк на PYTHON.Сейчас хочу залить его на хостинг так.

Botact — проект программного обеспечения с открытым исходным кодом. Библиотека для создания ботов ВКонтакте на Node. js.

Callback API filegetcontents’https://api.vk.com/method/messages.send?’

getLongPollServer.: {server}?actacheck&key{key}&ts{ts}&wait25.

ботов-викторин · PyPI

Боты-викторины для ТГ и ВК

Описание проекта

Описание

В этом репозитории находятся боты Вк и ТГ для викторины. Они привыкают к вопросам и проверяют правильность ответов на них.

Примеры ботов:

• Tg-бот
• Бот Вк — написать сообщение «Новый вопрос» в группу

Содержание

• Установка
• Как использовать
• Лицензия
• Цель проекта

Установка

• Установить с помощью pip:

   pip установить викторин-ботов
   

• Создайте бота в Telegram через BotFather и получите его API-токен.

• Создайте учетную запись Redis в Redislabs, а затем создайте облачную базу данных (вы можете выбрать бесплатный план). Получите URL-адрес базы данных конечной точки и порт.

• Создать группу ВКонтакте, разрешить ей отправлять сообщения и получить для нее токен доступа.

• Зарегистрировать переменные среды в операционной системе:

   экспорт TELEGRAM_TOKEN=telegram_token
  экспорт DB_ENDPOINT = конечная точка redis
  экспорт DB_PASSWORD=redis_password
  экспорт VK_GROUP_TOKEN=токен_вконтакте
   

• Поместите файлы вопросов в папку (примеры файлов находятся в папке репозитория quiz_files_example) и экспортируйте содержимое теста в Redis:

   роботов-викторин export_quiz_content [путь_к_папке_вопросов]
   

Как использовать

Запустить TG бота:

 quiz-bots tg-bot
 

Запустить бота ВК:

 викторины-боты вк-бот
 

Лицензия

Этот проект находится под лицензией MIT License — подробности см. в файле LICENSE.md

Цель проекта

Код написан в образовательных целях на онлайн-курсе для веб-разработчики dvmn. org.

Детали проекта

Эта версия

0.2.2

1 июня 2020 г.

0.2.1

1 июня 2020 г.

0.2.0

1 июня 2020 г.

0.1.7

13 мая 2020 г.

0.1.6

13 мая 2020 г.

0,1,5

13 мая 2020 г.

0.1.4

13 мая 2020 г.

0.1.3

13 мая 2020 г.

0.1.2

10 мая 2020 г.

0.1.1

10 мая 2020 г.

0.1.0

10 мая 2020 г.

Загрузить файлы

Загрузить файл для вашей платформы. Если вы не уверены, что выбрать, узнайте больше об установке пакетов.

Исходный дистрибутив

викторина-боты-0. 2.2.tar.gz (8,5 КБ посмотреть хеши)

Загружено 1 июня 2020 г. источник

Встроенный дистрибутив

quiz_bots-0.2.2-py3-none-any.whl (9,7 КБ посмотреть хеши)

Загружено 1 июня 2020 г. ру3

Закрывать

Хэши для викторин-ботов-0.2.2.tar.gz

Хэши для викторин-ботов-0. 2.2.tar.gz

Алгоритм	Дайджест хэша
ША256	84a5d4b218ad562346f57c4245b46603a7f28afe614420ac401a677db66fd10b
MD5	8e4f2a28bc5371606a360d0316c19a6b
БЛЕЙК2-256	8b09350b35bbd7d61f0c48724fb6b59479826ee6683bf3724736890c6e0588f0

Закрывать

Хэши для quiz_bots-0.2.2-py3-none-any.whl

Хэши для quiz_bots-0.2.2-py3-none-any. whl

Алгоритм	Дайджест хэша
ША256	c2f3ad8d1b1039c472860fcc2b49161ec7b0955f47c6eea8eff51294d4f0b8a0
MD5	8db1fe7cc4ca8a9de10bf465372d7814
БЛЕЙК2-256	c7e4afd76539351efe8c3e3f2db116f6163fc54e26620c93a7725f2b76d98a40

Не покупайте этот конструктор чат-ботов

Botmother — конструктор чат-ботов для Facebook Messenger, WhatsApp, Telegram, Viber, VK и OK. Это один из немногих конструкторов чат-ботов, созданных в России (что вы можете видеть по каналам, которые они предоставляют). Вопрос в том, стоит ли использовать Botmother для создания чат-ботов?

Погружаемся!

Содержание

Пользовательский интерфейс

Когда вы собираетесь создать своего чат-бота, Botmother использует Visual Flow Builder: справа вы можете выбрать элементы в своем потоке.

К сожалению, невозможно протестировать чат-бота до того, как вы его запустите.

В целом, должен сказать, что интерфейс Botmother довольно прост в использовании. Но в то же время настроить своего чат-бота непросто (за несколько минут не настроить). Botmother не предоставляет никаких руководств или шаблонов, которые помогут вам начать работу, поэтому вы должны сначала посмотреть, как работает интерфейс, что может занять некоторое время.

• Visual Flow Builder

• Тестовый чат-бот

• Интерфейс прост в использовании?

• Легко настроить чат-бота?

Элементы чат-бота

Botmother предоставляет множество элементов чат-бота, которые вы можете использовать для создания своего чат-бота.

Они не предоставляют задержек, вложений, вертикальных списков, постоянного меню и проверки даты, но это не мешает.

• Задержки

• Images

• Video

• Audio

• Attachments

• Gallery (Horizontal list)

• Vertical list

• Emojis

• Persistent Menu

• Быстрые ответы

• Кнопки

• Ввод произвольного текста

• Обмен местоположением

• Проверка электронной почты

• Проверка номера телефона

• Проверка даты

Пользователи

fields en tags пользователям вашего чат-бота.

К сожалению, невозможно создавать сегменты на основе этих настраиваемых полей и тегов.

• Пользовательские поля

• Теги

• Сегменты пользователей

Сообщения

С Botmother вы можете отправлять трансляции пользователям вашего чат-бота.

К сожалению, отправить последовательности своим пользователям невозможно.

Более того, можно иметь чат-бота на нескольких языках одновременно, но перевести своего чат-бота непросто (нужно все дублировать и переводить вручную).

• Трансляции

• Последовательности

• Условия

• Несколько языков

• Легко для перевода

AI & NLP

. :

Благодаря этому ваш чат-бот может распознавать ключевые слова и автоматически отвечать на них. Недостатком их раздела часто задаваемых вопросов является то, что вам всегда нужно ответить сообщением (и, возможно, добавить кнопку или изображение), но невозможно ответить потоком чат-бота.

К сожалению, вы не можете понять намерения пользователя или использовать сущности с Botmother.

ПРИМЕЧАНИЕ: У меня никогда не работал раздел часто задаваемых вопросов. Каждый раз, когда я вводил «Какое у вас время работы?», бот не отвечал.

Каналы

С помощью Botmother вы можете установить чат-бот на:

• Ваш сайт (виджет Facebook)
• Мессенджер Facebook
• WhatsApp
• Телеграмма
• Вайбер
• ВК (Социальная сеть в России)
• ОК (Социальная сеть в России)

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

• Website

• Facebook

• Instagram

• Whatsapp

• Telegram

• SMS

• Slack

• Skype

• Электронная почта

Интеграции

Botmother предоставляет встроенный чат, который является наиболее важной интеграцией любого программного обеспечения чат-бота:

Кроме того, они обеспечивают интеграцию с Zapier, что позволяет вам подключаться практически с любым программным приложением на земле.

К сожалению, они не дают возможности создавать собственные вебхуки.

• Живой чат

• Zapier

• Integromat

• Google Таблицы

• Webhooks

Маркетинг

Маркетинговые возможности Botmother весьма ограничены.

Можно только создать виджет веб-сайта Facebook или создать кнопку «Отправить в Messenger» для вашего веб-сайта.

• Виджет веб-сайта Facebook

• Нативный виджет веб-сайта

• Целевые страницы

• Facebook Ads

• Одноразовое уведомление

• Комментарии Facebook Auto-Reply

• Creator

• PRACIONS для вашего чата

1

• PRACIONS 9004 9013 9064 9064 9064 9063 9063 9064 9064 9064 9064 9063 9063 9063 9064 9064 9064 9063

  9063 9064 9064

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

  Если вы действительно хотите запустить своего чат-бота, вам нужно заплатить. Их первый платный план стоит 17 долларов в месяц и включает в себя все функции одного чат-бота:

  Если вам нужно более одного чат-бота, вы можете выбрать более высокий план, который дает вам 5 чат-ботов (за 70 долларов в месяц) и 20 чат-ботов (за 200 долларов в месяц).

  Более того, если вы хотите использовать WhatsApp как канал, вам нужно доплачивать. Чтобы использовать WhatsApp, вам нужно платить около 67 долларов в месяц. Кроме того, вам нужно заплатить 40 долларов за соединение с WhatsApp (только один раз).

  • Бесплатная пробная версия

  • Бесплатный план

  • Цена за месяц

    17

  • Возможен месячный тариф?

  • Гарантия возврата денег

  Аналитика

  Аналитика Botmother действительно минимальна.

  Botmother предоставляет только одну панель, где вы можете увидеть количество пользователей вашего чат-бота:

  Вот и все. С помощью этой минимальной аналитики невозможно проанализировать вашего чат-бота и оптимизировать потоки вашего чат-бота.

  Электронная коммерция

  Botmother обеспечивает несколько интеграций платежей:

  • Telegram Payment (собственная нативная интеграция с Telegram)
  • Яндекс.Касса
  • PayOnline
  • BePaid
  • Робокасса

  Благодаря этим интеграциям становится возможным позволить пользователю оплачивать ваши продукты внутри вашего чат-бота.

  Кроме того, если вы используете вариант оплаты Telegram, вы можете увидеть полный обзор всех ваших платежей внутри Botmother.

  Шаблоны и клонирование

  Botmother не предоставляет никаких шаблонов на своей платформе.

  С другой стороны, потоки ваших чат-ботов можно дублировать, чтобы вы могли легко использовать их повторно.

  • Templates

  • Make template

  • Share template

  • Duplicate chatbot flows

  • Duplicate chatbot elements

  Optimization

  Unfortunately, Botmother doesn’t provide any optimization.

  • A/B тестирование

  Поддержка

  Botmother предоставляет минимальную документацию о том, как вы можете использовать их платформу, что является недостатком (особенно если вы только начинаете работать с чат-ботами).

  Кроме того, они обеспечивают поддержку клиентов через свои социальные сети и электронную почту.

  • Учебники

  • Документация

  • Служба поддержки

  Заключение

  Итак, стоит ли создавать чат-ботов?

  Нет, не стоит.

  Есть две причины, по которым я бы не рекомендовал Botmother. Прежде всего, вы не можете установить приветственное сообщение вашего чат-бота (первое сообщение, если вы взаимодействуете с чат-ботом) или ответ по умолчанию (сообщение, когда чат-бот не понимает ваш вопрос). Это два самых основных сообщения чат-бота, и Botmother не предоставляет эти сообщения.

  Во-вторых, несмотря на все функции, которые предоставляет Botmother, я просто не мог заставить его работать. Чат-бот не отправляет мне сообщения, если я нажимаю слова, которые есть в FAQ. И работающий чат-бот очень важен…

  (Kotlin) Как создать чат-бота

  Что такое чат-бот? Это приложение Space, которое общается с пользователем Space в собственном канале чатов. Минимально жизнеспособный бот должен:

  • Отвечать списком доступных команд, когда пользователь вводит / (косая черта) в канале.

  • Укажите хотя бы одну команду: после того, как пользователь отправит эту команду на канал, бот должен что-то сделать, а затем ответить сообщением.

  Что мы будем делать

  Ваш первый чат-бот, конечно же! Без лишних слов, приветствуйте — бот «Напомнить мне»!

  Наш бот отправит пользователю напоминание через заданное время. Например, если пользователь отправляет боту команду напомнить 60 вздремнуть , через 60 секунд бот ответит сообщением вздремнуть . Кроме того, у нашего бота будет команда, которая предоставляет помощь по запросу.

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

  Стартовый набор для создания чат-ботов

  Что нам понадобится в нашем путешествии?

  	JetBrains IntelliJ IDEA Мы напишем нашего бота на Котлине. Таким образом, вы можете использовать любую IDE по вашему выбору, но в этом руководстве подразумевается, что вы используете IntelliJ IDEA.
  	Фреймворк Ktor Это фреймворк, позволяющий легко создавать все типы подключенных приложений, например серверы, клиенты, мобильные и браузерные приложения. Мы получим его как одну из зависимостей Gradle, так что никаких дополнительных действий с вашей стороны не потребуется. Конечно, вне этого руководства вы можете создать бота Space, используя любую понравившуюся вам веб-инфраструктуру, например Node.js, ASP. NET и т. д.
  	Space SDK Как вы, возможно, знаете из раздела «Приложения», любое приложение должно взаимодействовать со Space с помощью Space HTTP API. Чтобы облегчить жизнь разработчикам приложений Space, мы предоставляем Space SDK для Kotlin и .NET. SDK содержит клиент HTTP API, который позволяет легко проходить аутентификацию и взаимодействовать с Space с помощью нескольких высокоуровневых классов. Помимо фреймворка Ktor, мы получим SDK как зависимость Gradle.
  	Служба туннелирования Такая служба открывает локальные серверы для общедоступного Интернета. Это позволит нам запускать нашего чат-бота локально и получать к нему доступ из Space через общедоступный URL-адрес (мы укажем его как конечную точку чат-бота). Например, вы можете использовать для этой цели ngrok, PageKyte или другую службу туннелирования. Для начала работы с сервисом туннелирования необходимо скачать клиент сервиса: клиент ngrok, клиент PageKyte. Для наших целей достаточно бесплатного плана для ngrok или PageKyte. Мы настоятельно рекомендуем использовать службу туннелирования только в целях тестирования во время разработки. Не используйте его для регулярного размещения чат-бота на своем компьютере. Открытый и общедоступный порт на вашем компьютере представляет серьезную угрозу безопасности.

  Шаг 1. Создайте проект Ktor

  1. Откройте Intellij IDEA.

  2. Начните создавать новый проект с помощью File | Новый | Проект.

  3. В списке шаблонов выберите Ktor.

  4. Укажите имя проекта и имя веб-сайта, выберите Gradle Kotlin в системе сборки и снимите флажок Добавить пример кода.

  5. Щелкните Далее. Мы не собираемся устанавливать какие-либо плагины Ktor, поэтому на следующей странице просто нажмите «Создать».

  6. Вот оно! Теперь у нас есть пустой проект Ktor.

  Шаг 2.

  Получите Space SDK и другие зависимости

  Для нашего чат-бота требуются следующие библиотеки:

  • Space SDK для JVM

    Чтобы получить инструкции о том, как ссылаться на последнюю версию SDK, откройте API Playground в своем экземпляре Space (Extensions | API Playground). Справа в списке в разделе «Код» выберите Kotlin SDK и нажмите «Настроить зависимость». Откроется окно с фрагментами кода для Gradle и Maven. Фрагменты всегда ссылаются на последнюю доступную версию SDK.

  • FasterXML/jackson: для работы с полезными данными JSON.

  • HTTP-клиент Ktor: универсальное приложение Ktor не ссылается на библиотеки для HTTP-клиента. Нам понадобится клиент для отправки запросов в космос. Мы будем использовать HTTP-клиент CIO Ktor, но вы можете использовать любой другой веб-движок для HTTP-клиента.

  1. Откройте build.gradle.kts и добавьте:

     • В раздел репозиториев :

       3 maven(«https://maven/spacebrainspkg.

       pkg(«https://maven/spacebrainspkg.pkg) /maven»)

     • В раздел dependencies добавьте зависимости к необходимым библиотекам:

       реализация ‘com.fasterxml.jackson.module:jackson-module-kotlin:2.13.3’ реализация «org.jetbrains:space-sdk-jvm:$space_sdk_version» реализация «io.ktor:ktor-client-core:$ktor_version» реализация «io.ktor:ktor-client-cio:$ktor_version»

       реализация («com.fasterxml.jackson.module:jackson-module-kotlin:$jackson_version») реализация(«org.jetbrains:space-sdk-jvm:$space_sdk_version») реализация(«io.ktor:ktor-client-core:$ktor_version») реализация(«io.ktor:ktor-client-cio:$ktor_version»)

     В gradle.properties укажите нужные версии пакетов:

     ktor_version=2.0.3 jackson_version=2.13.3 # Мы используем SDK v. 106390, но когда вы читаете это руководство, может быть доступна более новая версия. # Чтобы узнать, какая версия SDK является последней доступной: откройте API Playground, # в разделе «Код» справа выберите «Kotlin SDK» и нажмите «Настроить зависимость…» space_sdk_version=106390-beta

  2. Мы не собираемся писать тесты для этого приложения, поэтому очистим все зависимости testImplementation от зависимостей 9раздел 0045.

     Ваш build.gradle.kts должен выглядеть так:

     val ktor_version: Строка по проекту val kotlin_version: строка по проекту val logback_version: строка по проекту val space_sdk_version: строка по проекту val jackson_version: строка по проекту плагины { заявление котлин ("jvm") версия "1. 7.10" } группа = "com.example" версия = "0.0.1" заявление { mainClass.set("com.example.ApplicationKt") val isDevelopment: Boolean = project.ext.has("разработка") applicationDefaultJvmArgs = listOf("-Dio.ktor.development=$isDevelopment") } репозитории { mavenCentral() maven("https://maven.pkg.jetbrains.space/public/p/space/maven") } зависимости { реализация ("io.ktor: ktor-server-core-jvm: $ktor_version") реализация("io.ktor:ktor-server-netty-jvm:$ktor_version") реализация ("ch.qos.logback: logback-classic: $ logback_version") реализация ("com.fasterxml. jackson.module: jackson-module-kotlin: $ jackson_version") реализация("org.jetbrains:space-sdk-jvm:$space_sdk_version") реализация("io.ktor:ktor-client-core:$ktor_version") реализация("io.ktor:ktor-client-cio:$ktor_version") }

     gradle.properties должно выглядеть так:

     ktor_version=2.0.3 котлин_версия = 1.7.10 logback_версия = 1.2.3 jackson_version=2.13.3 kotlin.code.style=официальный space_sdk_version=106390-beta

  3. В окне Gradle нажмите «Обновить все проекты Gradle», чтобы Gradle загрузил необходимые зависимости.

  4. Готово! Теперь у нас есть Space SDK в нашем проекте.

  Шаг 3. Запустите службу туннелирования

  Мы настоятельно рекомендуем использовать службу туннелирования только в целях тестирования во время разработки. Не используйте его для постоянного размещения чат-бота на своем компьютере. Открытый и общедоступный порт на вашем компьютере представляет серьезную угрозу безопасности.

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

  Прежде чем мы зарегистрируем нашего чат-бота в Space, мы должны получить для него общедоступный URL-адрес. Поскольку ваша среда разработки, вероятно, находится за NAT, самый простой способ получить URL-адрес — использовать службу туннелирования. В нашем случае мы будем использовать ngrok.

  1. Загрузите и разархивируйте клиент ngrok.

  2. В терминале (в macOS или Linux) или в командной строке (в Windows) откройте каталог ngrok.

  3. По умолчанию наш проект Ktor настроен на запуск HTTP-сервера на порту 8080 (это можно проверить в файле resources/application.conf ). Запустите туннелирование для этого порта:

     ./ngrok http 8080

  4. Служба ngrok запустится. Это будет выглядеть примерно так:

     Состояние сеанса онлайн Учетная запись [email protected] (план: бесплатно) Версия 3.0.6 Регион США (нас) Задержка - Веб-интерфейс http://127.0.0.1:4040 Перенаправление https://98af-94-158-242-146.ngrok.io -> http://localhost:8080 Соединения ttl opn rt1 rt5 p50 p90 0 0 0.00 0.00 0.00 0.00

     Здесь нас интересует строка Forwarding — она содержит публичный URL. ngrok перенаправляет запросы с этого URL-адреса на наш локальный хост, используя свою службу туннелирования. В приведенном выше примере адрес https://98af-94-158-242-146.ngrok.io , но в вашем случае это будет что-то другое, поскольку ngrok динамически генерирует эти случайные URL-адреса.

  5. Отличная работа! Теперь у нас есть работающая служба туннелирования и общедоступный URL-адрес нашего будущего чат-бота.

  Шаг 4. Зарегистрируйте чат-бота в Space

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

  При разработке приложения необходимо решить две важные вещи:

  • Распространение приложения:

    • Приложения для одной организации предназначены только для одной организации Space. Пользователь Space регистрирует и настраивает приложение для одной организации вручную в пользовательском интерфейсе Space.

    • Приложения для нескольких организаций предназначены для нескольких космических организаций. Мультиорганизационное приложение регистрируется и настраивается в конкретном экземпляре Space с помощью вызовов API.

    Поскольку мы просто практикуемся, нет смысла отвлекаться на сложности настройки мультиорганизационных приложений. Вместо этого мы зарегистрируем и настроим наше приложение с помощью Space UI. Итак, мы собираемся создать приложение для одной организации.

  • Предмет авторизации: решите, как ваше приложение должно действовать в Space — от своего имени, от имени конкретного пользователя Space или и то, и другое. Это определяет, какие потоки авторизации будет использовать приложение.

    В нашем случае чат-бот будет рассылать уведомления в своем чат-канале сам по себе. В качестве потока OAuth 2.0 мы будем использовать поток учетных данных клиента. Это позволяет приложению авторизоваться в Space с использованием идентификатора клиента и секрета клиента.

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

  1. Откройте экземпляр Space.

  2. На панели навигации щелкните Расширения и выберите Приложения.

  3. Щелкните Новое приложение.

  4. Дайте приложению уникальное имя, например, бот-напоминай и нажмите «Создать».

  5. Откройте вкладку Авторизация. На этой вкладке мы ничего менять не будем — наш бот простой и не получает никаких данных из космоса.

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

  6. Откройте вкладку Аутентификация. Обратите внимание, что поток учетных данных клиента включен для всех приложений по умолчанию. Нам нужно получить идентификатор клиента и секрет клиента приложения. Наш чат-бот будет использовать их для получения токена доступа к Space.

  7. Когда пользователь вводит что-либо в канал чат-бота, Space отправляет пользовательский ввод в приложение. Итак, наш следующий шаг — указать URL-адрес конечной точки нашего приложения и выбрать, как мы будем проверять запросы из Space.

     Откройте вкладку Конечная точка.

     В URI конечной точки укажите общедоступный URL-адрес, сгенерированный службой туннелирования для нашего бота. Давайте сделаем эту конечную точку менее универсальной и добавим постфикс к URL-адресу, например, api/space . Таким образом, конечной конечной точкой будет https://{random_string_from_ngrok}.ngrok.io/api/space

     . По умолчанию Space рекомендует использовать метод проверки открытого ключа. Оставим значение по умолчанию и нажмем Сохранить.

  8. Отличная работа! Теперь наш бот зарегистрирован в Space, у нас есть все необходимые данные для аутентификации, и мы готовы приступить к разработке нашего бота.

  Шаг 5. Создание клиента Space

  Все подготовительные этапы позади, давайте напишем код! Во-первых, мы должны начать с создания клиента Space, который позволит нам делать запросы к нашему экземпляру Space.

  1. Добавьте в проект файл Client.kt .

  2. Добавьте код в файл Client.kt :

     package org. remindme импортировать space.jetbrains.api.runtime.SpaceAppInstance импортировать space.jetbrains.api.runtime.SpaceAuth импортировать space.jetbrains.api.runtime.SpaceClient импортировать space.jetbrains.api.runtime.ktorClientForSpace импортировать space.jetbrains.api.runtime.resources.chats импортировать space.jetbrains.api.runtime.types.ChannelIdentifier импортировать space.jetbrains.api.runtime.types.ChatMessage импортировать space.jetbrains.api.runtime.types.ProfileIdentifier // описывает подключение к экземпляру Space val spaceAppInstance = SpaceAppInstance( // Скопируйте-вставьте идентификатор клиента и секрет клиента // ваше приложение получено из космоса. clientId = "идентификатор клиента, назначенный приложению", clientSecret = "секрет клиента, назначенный приложению", // URL вашего экземпляра Space spaceServerUrl = "https://mycompany. jetbrains.space" ) частный val spaceHttpClient = ktorClientForSpace() // Клиент Space используется для вызова методов Space API. // Приложение использует поток OAuth учетных данных клиента (см. [SpaceAuth.ClientCredentials]) // авторизоваться от своего имени. val spaceClient = SpaceClient(ktorClient = spaceHttpClient, appInstance = spaceAppInstance, аутентификация = SpaceAuth.ClientCredentials()) // Получаем пользователя по ID и отправляем ему «сообщение». // 'spaceClient' дает вам доступ к любой конечной точке пространства. приостановить удовольствие sendMessage (userId: String, сообщение: ChatMessage) { spaceClient.chats.messages.sendMessage( канал = ChannelIdentifier. Profile(ProfileIdentifier.Id(userId)), содержание = сообщение ) }

     Примечания:

     • sendMessage(userId: String, message: ChatMessage) использует клиент для отправки сообщений в Space. Давайте расширим это:

       • userId — это идентификатор пользователя, который отправил сообщение в наше приложение и которому мы хотим ответить.

       • ChatMessage — это класс API, который описывает сообщение чата. Дело в том, что сообщения — это не просто текст. Они могут включать сложное форматирование и даже элементы пользовательского интерфейса, такие как кнопки. Для упрощения создания таких сообщений в клиенте API предусмотрен специальный DSL — Конструктор сообщений. Мы рассмотрим это в следующих шагах.

       • spaceClient.chats.messages.sendMessage() — посмотрите, как мы ссылаемся на подсистему чатов. Самое классное в классе SpaceHttpClient — это то, что он позволяет получить доступ к любому модулю Space. Таким образом, если вы хотите получить профиль участника, вы можете позвонить в Team Directory:

         spaceClient.teamDirectory.profiles.getProfile(ProfileIdentifier.Username("John.Doe"))

         Чтобы увидеть список модулей, которые вы можете получить доступ через клиент, откройте API Playground. Заголовки верхнего уровня здесь — это модули, к которым можно получить доступ:

         Вы также можете использовать автозавершение кода в своей среде IDE — просто введите spaceClient. и изучить предложения.

  3. Готово! Теперь у нас есть клиент, поэтому мы можем двигаться дальше и создать первую команду для нашего чат-бота.

  Шаг 6. Создайте свою первую команду

  Давайте начнем с чего-то простого — команды help , которая показывает подсказки по использованию нашего чат-бота.

  1. Создайте CommandHelp.kt и добавьте следующий код:

     package org. remindme импортировать space.jetbrains.api.runtime.helpers.message импортировать space.jetbrains.api.runtime.types.ApiIcon импортировать space.jetbrains.api.runtime.types.ChatMessage импортировать space.jetbrains.api.runtime.types.MessageOutline импортировать space.jetbrains.api.runtime.types.MessageStyle // команда для отображения помощи чат-бота приостановить удовольствие runHelpCommand (полезная нагрузка: MessagePayload) { // получаем идентификатор пользователя из полезной нагрузки и отправляем ему справочное сообщение sendMessage(payload.userId, helpMessage()) } // строим справочное сообщение с помощью специального DSL весело helpMessage(): ChatMessage { ответное сообщение { раздел { text("Скоро помощь будет показана здесь!") } } }

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

  Шаг 7. Определение конечной точки

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

  Это не учебник Ktor, поэтому мы не будем вдаваться в подробности Ktor. Кстати, если вы не знакомы с Ktor, это хорошая возможность познакомиться с этим замечательным фреймворком: просто обратите внимание, насколько лаконичен синтаксис Ktor.

  1. Наш чат-бот — это не только клиентское приложение, но и сервер — он должен прослушивать и обрабатывать запросы, поступающие из космоса. Для этой цели Ktor предоставляет функцию маршрутизации. Давайте воспользуемся этой функцией для обработки запросов POST на конечной точке /api/space .

     Создайте файл Routes.kt и добавьте следующий код:

     package org.remindme импортировать com.fasterxml.jackson.databind.ObjectMapper импортировать io. ktor.http.* импортировать io.ktor.server.application.* импортировать io.ktor.server.request.* импортировать io.ktor.server.response.* импортировать io.ktor.server.routing.* импортировать kotlinx.coroutines.launch импортировать space.jetbrains.api.ExperimentalSpaceSdkApi импортировать space.jetbrains.api.runtime.helpers.command импортировать space.jetbrains.api.runtime.helpers.readPayload импортировать space.jetbrains.api.runtime.helpers.verifyWithPublicKey импортировать space.jetbrains.api.runtime.types.ListCommandsPayload импортировать space.jetbrains.api.runtime.types.MessagePayload весело Application.configureRouting () { маршрутизация { сообщение ("API/пространство") { // чтение тела запроса val body = call. receiveText() // чтение заголовков, необходимых для проверки пробелов val подпись = call.request.header("X-Space-Public-Key-Signature") val timestamp = call.request.header("X-Space-Timestamp")?.toLongOrNull() // verifyWithPublicKey получает ключ из Space, использует его для генерации хэша сообщения // и сравнивает сгенерированный хэш с хешем в сообщении if (signature.isNullOrBlank() || timestamp == null || !spaceClient.verifyWithPublicKey( тело, метка времени, подпись ) ) { call.respond(HttpStatusCode.Unauthorized) возврат@почта } // анализируем полезную нагрузку сообщения // MessagePayload = пользователь отправляет команду // ListCommandsPayload = пользователь вводит косую черту или символ когда (значение полезной нагрузки = readPayload (тело)) { это MessagePayload -> { runHelpCommand(контекст) call. respond(HttpStatusCode.OK, "") } это ListCommandsPayload -> { } } } } }

     Что здесь происходит:

     • Application.configureRouting() настраивает функцию маршрутизации Ktor.

     • spaceClient.verifyWithPublicKey() проверяет экземпляр Space, от которого клиент получает запрос. Он использует открытый ключ из Space для вычисления хэша сообщения и сравнения его с хешем, отправленным в заголовке сообщения. Вы можете найти больше информации о том, как это работает здесь. В этом руководстве мы обрабатываем и проверяем запросы самостоятельно. Кроме того, вы можете использовать Space.processPayload() вспомогательный метод для этой цели. В этом случае вам не нужно реализовывать проверку запроса.

     • readPayload(body: String) — это вспомогательная функция SDK, которая получает данные JSON из Space и десериализует их в ApplicationPayload . Например, в нашем случае необработанные данные из космоса могут выглядеть следующим образом:

       { "имя_класса": "MessagePayload", "сообщение": { "имя класса": "Контекст сообщения", "messageId": "JxT000JxT", "channelId": "31m0WE41iCBP", "тело": { "className": "СообщениеЧата.Текст", "текст": "помощь" }, "createdTime": "2020-11-08T21:34:24.919Z" }, "accessToken": "", "verificationToken": "85e23ff", "Идентификатор пользователя": "1eAeu31CZA" }

     • Самая интересная часть — анализ типа полезной нагрузки. В Space SDK есть несколько типов полезной нагрузки, но в этом руководстве мы сосредоточимся только на двух из них:

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

       • ListCommandsPayload : бот получает эту полезную нагрузку, когда пользователь нажимает кнопку косой черты /. Бот должен ответить списком доступных команд.

     • При получении MessagePayload важно ответить некоторым HTTP-кодом ( 200 OK в нашем случае). В противном случае пользователь получит 500 Internal Server Error .

  2. Убедитесь, что функция приложения main() в Application.kt запускает сервер с включенной маршрутизацией:

     fun main() { встроенный сервер (Netty, порт = 8080) { настроить маршрутизацию () }. старт(ожидание = истина) }

  3. Готово! Теперь у нас есть рабочая команда, и мы готовы запустить нашего бота в первый раз!

  Шаг 8. Запустите бота

  1. Откройте файл Application.kt .

  2. Запустите приложение, нажав Выполнить в поле рядом с основной функцией в Application.kt :

  3. Откройте экземпляр Space и найдите бота: нажмите Ctrl+K 8 его имя.

  4. Если посмотреть в код, то видно, что мы никак не анализируем отправленные пользователем команды. На любой запрос мы отвечаем helpMessage . Итак, чтобы протестировать нашего бота, напишите что-нибудь в чате. Вы должны получить справочное сообщение:

  5. Работает! Теперь давайте добавим остальные функции бота.

  Шаг 9.

  Добавьте поддержку слэш-команд

  Давайте сделаем нашего бота полностью функциональным:

  • Чтобы считаться чат-ботом, приложение должно иметь возможность отвечать списком доступных команд, когда пользователь нажимает / косая черта в чате. В этом случае бот получает ListCommandsPayload тип полезной нагрузки.

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

  1. Создайте файл Commands.kt :

     package org.remindme импортировать space.jetbrains.api.runtime.types.* класс ApplicationCommand( имя val: строка, val информация: строка, val run: suspend (полезная нагрузка: MessagePayload) -> Unit ) { /** * [CommandDetail] возвращается в Space с информацией о команде. * Список команд показывается пользователю. */ fun toSpaceCommand() = CommandDetail(имя, информация) } // список доступных команд значение поддерживаемых команд = listOf ( ApplicationCommand( "помощь", "Покажи эту справку", ) { полезная нагрузка -> runHelpCommand (полезная нагрузка) }, ApplicationCommand( "напоминать", "Напомни мне о чем-нибудь через N секунд, например, " + "чтобы напомнить о \"веще\" за 10 секунд, отправьте 'напомнить 10 о предмете'", ) { полезная нагрузка -> runRemindCommand (полезная нагрузка) } ) /** * Ответ на [ListCommandsPayload]. * Space будет отображать возвращенные команды как команды, поддерживаемые вашим приложением. */ весело getSupportedCommands() = Команды( поддерживаемыеCommands.map { it.toSpaceCommand() } )

     Здесь:

     • Класс ApplicationCommand описывает команду чат-бота: После того, как пользователь отправит чат-боту команду с именем name , бот выполнит функцию команды run .

       Обратите внимание, что команда должна реализовывать функцию toSpaceCommand , которая возвращает CommandDetail – имя и описание команды.

     • Когда бот получает ListCommandsPayload , getSupportedCommands() 9Функция 0045 вернет карту CommandDetail .

  2. Создайте файл CommandRemind. kt :

     пакет org.remindme импортировать kotlinx.coroutines.delay импортировать space.jetbrains.api.runtime.helpers.commandArguments импортировать space.jetbrains.api.runtime.helpers.message импортировать space.jetbrains.api.runtime.types.* приостановить веселье runRemindCommand (полезная нагрузка: MessagePayload) { val напомнитьMeArgs = getArgs (полезная нагрузка) ?: запустить { sendMessage(payload.userId, helpMessage()) возвращаться } напоминаниеAfterDelay(payload.userId, напоминаниеMeArgs) } приватная приостановка забавы sendMessage(userId, acceptRemindMessage(remindMeArgs)) задержка (напомнитьMeArgs.delayMs) sendMessage (идентификатор пользователя, напомнить сообщение (напомнитьMeArgs)) } личное развлечение acceptRemindMessage (remindMeArgs: RemindMeArgs): ChatMessage { ответное сообщение { контур( Структура сообщения( icon = ApiIcon("флажок установлен"), text = "Напоминание принято" ) ) раздел { text("Я напомню вам через ${remindMeArgs. delayMs / 1000} секунд о \"${remindMeArgs.reminderText}\"") } } } личное развлечение напоминаниеMessage(remindMeArgs: RemindMeArgs): ChatMessage { ответное сообщение { контур( Структура сообщения( значок = APIIcon("часы"), текст = "Напоминание" ) ) раздел { текст (напоминатьMeArgs.reminderText) текст( размер = РазмерТекстаСообщения.МАЛЕНЬКИЙ, content = "Прошло ${remindMeArgs.delayMs / 1000} секунд" ) } } } личное развлечение getArgs (полезная нагрузка: MessagePayload): RemindMeArgs? { val args = payload. commandArguments() ?: вернуть ноль val delayMs = args.substringBefore(" ").toLongOrNull()?.times(1000) ?: вернуть ноль val напоминаниеText = args.substringAfter(" ").trimStart().takeIf { it.isNotEmpty() } ?: вернуть ноль вернуть RemindMeArgs(delayMs, напоминаниетекст) } частный класс RemindMeArgs( val delayMs: Длинный, val напоминаниеТекст: строка, )

     Здесь:

     • runRemindCommand запускает таймер на указанное время. getArgs() получает аргументы команды напоминания (время и текст). Итак, когда пользователь набирает , напомнить 10 какой-то текст , аргументы будут такими: 10 , какой-то текст .

     • напоминаниеAfterDelay() отправляет acceptRemindMessage обратно пользователю и по истечении времени таймера отправляет напоминание .

     • acceptRemindMessage и напоминания используют DSL построителя сообщений для создания ChatMessage . MessageOutline — это небольшой блок, который предшествует основному тексту сообщения. ApiIcon возвращает изображение значка, которое будет отображаться перед сообщением.

  3. Отредактируйте файл CommandHelp.kt :

     package org.remindme импортировать space.jetbrains.api.runtime.helpers.message импортировать space.jetbrains.api.runtime.types.ApiIcon импортировать space.jetbrains.api.runtime.types.ChatMessage импортировать space.jetbrains.api.runtime.types.MessageOutline импортировать space.jetbrains.api.runtime.types.MessageStyle приостановить удовольствие runHelpCommand (полезная нагрузка: MessagePayload) { sendMessage(payload. userId, helpMessage()) } весело helpMessage(): ChatMessage { ответное сообщение { Структура сообщения( icon = ApiIcon("флажок установлен"), text = "Напомнить мне о помощи бота" ) раздел { text("Список доступных команд", MessageStyle.PRIMARY) поля { поддерживаемыеCommands.forEach { поле(it.name, it.info) } } } } }

     Здесь мы обновили helpMessage , так что теперь он возвращает список поддерживаемых команд .

  4. Отредактируйте файл Routes.kt :

     package org.remindme импортировать com.fasterxml.jackson.databind.ObjectMapper импортировать io.ktor.http.* импортировать io.ktor.server.application.* импортировать io.ktor.server.request.* импортировать io.ktor.server.response.* импортировать io.ktor.server.routing.* импортировать kotlinx.coroutines.launch импортировать space.jetbrains.api.runtime.helpers.command импортировать space.jetbrains.api.runtime.helpers.readPayload импортировать space.jetbrains.api.runtime.helpers.verifyWithPublicKey импортировать space.jetbrains.api.runtime.types.ListCommandsPayload импортировать space.jetbrains.api.runtime.types.MessagePayload весело Routing.api () { сообщение ("API/пространство") { // чтение тела запроса val body = call. receiveText() // проверить, исходит ли запрос от доверенного экземпляра Space val подпись = call.request.header("X-Space-Public-Key-Signature") val timestamp = call.request.header("X-Space-Timestamp")?.toLongOrNull() // verifyWithPublicKey получает ключ из Space, использует его для генерации хэша сообщения // и сравнивает сгенерированный хэш с хешем в сообщении if (signature.isNullOrBlank() || метка времени == null || !spaceClient.verifyWithPublicKey(тело, метка времени, подпись) ) { call.respond(HttpStatusCode.Unauthorized) возврат@почта } когда (значение полезной нагрузки = readPayload (тело)) { это ListCommandsPayload -> { // Пробел запрашивает список поддерживаемых команд call. respondText( // Сериализатор JSON ObjectMapper().writeValueAsString(getSupportedCommands()), ContentType.Application.Json ) } это MessagePayload -> { // пользователь отправил сообщение в приложение val имя_команды = полезная нагрузка.команда() val command = supportedCommands.find { it.name == commandName } если (команда == ноль) { runHelpCommand (полезная нагрузка) } еще { запустить { command.run (полезная нагрузка) } } call.respond(HttpStatusCode.