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

• Краткое описание
• ➕ Преимущества
• ➖ Недостатки
• Подробное описание
• Базовые сведения
• Бот Дюся и его семья
• Как общаться с ботом?
• Общая конфигурация
• Аватары
• Настройки бота
• Приветствие
• Режим вызова бота (триггер)
• Как отвечать, если ответ не найден
• Удалять ли сообщение, на которое среагировал бот
• Статистика
• Конфигурация вкладок Google Sheet, с которых бот читает данные ответов
• Команды
• Как создать экземпляр бота для своего города?
• Авторство и обратная связь
• См. также
• Ответственный за страницу

➕ Преимущества

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

➖ Недостатки

• Алгоритм поиска очень простой, поэтому возможны неверные ответы (когда ключевое слово случайно содержится в поисковом запросе)
• Все знания бота эксперты должны заносить вручную и поддерживать со временем.
• Пока нет удобного процесса обратной связи, собирающего запросы, оставшиеся без ответа по частотности (хотя можно видеть последние запросы без ответа по специальной команде)
• База знаний бота не связана напрямую с основной вики, так что любые знания надо заносить и в вики, и в таблицу бота.
• Единственный налаженный импорт данных — импорт немецких чатов на страницу
  💬

  Список чатов и групп по городам и землям Германии
  выполняется автоматически из конфига бота, а не заносится на страницу вручную.

Подробное описание

Базовые сведения

Бот Дюся и его семья

Как общаться с ботом?

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

Общая конфигурация

• Список региональных групп (в основном Телеграм, но также в базу внесены несколько WhatsApp-групп).
• Содержание вики uahelp.wiki (по общим темам).

Аватары

Настройки бота

Приветствие

Режим вызова бота (триггер)

• FULL_WORD — Вызов бота триггерит только сообщение, в котором имя бота указано как отдельное слово (так работает бот Нана).

• STRING_START — Вызов бота триггерит только сообщение, которое начинается с имени бота (так работает бот Нюся).

• ANY_SUBSTRING — Вызов бота триггерит любая подстрока с его именем.

Как отвечать, если ответ не найден

Удалять ли сообщение, на которое среагировал бот

Статистика

Конфигурация вкладок Google Sheet, с которых бот читает данные ответов

      {
        "commandTabs": [
          {
            "tabName": "Список болталки",
            "tabFormat": "COMMANDS",
            "tabType": "COMMANDS",
            "showHeader": false,
            "header": "Ответы бота",
            "bullet": "—"
          },
          {
            "tabName": "Общая болталка",
            "tabFormat": "COMMANDS",
            "tabType": "COMMANDS",
            "showHeader": false,
            "header": "Общие ответы всех ботов",
            "bullet": "—"
          }
        ],
        "dataTabs": [
          {
            "tabName": "Страницы вики и ключевые слова",
            "tabFormat": "WIKI_PAGES",
            "tabType": "WIKI_PAGES",
            "showHeader": true,
            "header": "\uD83D\uDCC1 Страницы вики"
          },
          {
            "tabName": "UAhelp.YouTube",
            "tabFormat": "COMMANDS",
            "tabType": "YOUTUBE_VIDEOS",
            "showHeader": true,
            "header": "\uD83C\uDFAC Видео UAhelp"
          },
          {
            "tabName": "Список чатов по городам",
            "tabFormat": "CHATS",
            "tabType": "CITY_CHATS",
            "showHeader": true,
            "header": "\uD83C\uDDE9\uD83C\uDDEA Чаты по городам Германии"
          },
          {
            "tabName": "Список чатов по странам",
            "tabFormat": "CHATS",
            "tabType": "COUNTRY_CHATS",
            "showHeader": true,
            "header": "\uD83C\uDF0E Чаты по странам"
          }
        ]
      }

• tabName — Название вкладки в Google Sheet.
• tabFormat — Формат данных на вкладке в Google Sheet. Одно из следующих значений:
• WIKI_PAGES — 3 столбца: имя страницы, адрес страницы, ключевые слова.
• CHATS — Много столбцов: имя чата, ключевые слова, произвольное число столбцов с чатами (каждое значение в стоблце чата должно содержать ссылку на чат, разделитель — и имя чата).
• COMMANDS — 2 столбца: ответ, ключевые слова.
• tabType — Тип данных на вкладке.
• showHeader — Показывать ли для вкладки заголовок перед списком ответом с этой вкладки (если ответы найдены).
• header — Заголовок перед списком ответов, найденных на вкладке (если найден хотя бы один ответ). Настройка будет использоваться в ответе бота из вкладки, только если для этой вкладки showHeader == true. В значении header можно для графической наглядности ответа использовать эмоджи.
• bullet — Если в ответах из вкладки будет использование форматирование в виде списка, то этот символ будет использоваться в качестве буллета этого списка.

• Вкладки команд — commandTabs.
• Вкладки данных — dataTabs.

• В пределах любой вкладки будут выданы все ответы, найденные на этой владке.
• Ищутся ответы во вкладках команд, в порядке их объявления в commandTabs.
• Если ответ найден на вкладке, он возвращается в ответе бота.
• То есть, если ответ нашёлся на вкладке commandTabs[0], то на вкладках commandTabs[1], commandTabs[2] и т.д. поиск выполняться уже не будет.
• Таким образом, можно перегружать ответы с одним и тем же словом на вкладке, расположенной ниже в commandTabs.
• Если ответы во вкладках команд не найдены — ищутся ответы во вкладках данных, в порядке их объявления в dataTabs.
• Если ответ найден на вкладке, он добавляется в список ответов.
• То есть, если ответ найден на вкладке dataTabs[0], то продолжается поиск на вкладке dataTabs[1], потом dataTabs[2] и так далее.
• Таким образом, можно переупорядочивать найденные ответы между вкладками данных, меняя их порядок в массиве dataTabs.
• Если хотя бы один ответ найден, то собранные ответы со всех вкладок в dataTabs выдаются в ответном сообщении бота.
• Если ответ по-прежнему не найден, выдаётся сообщение о том, что ответ не найден, согласно настройкам ReplyWhenNoAnswer и NoAnswerReply.

Команды

Как создать экземпляр бота для своего города?

• Имя бота (ориентируйтесь на уже имеющихся членов семьи и на название вашего города)
• Пол бота (чтобы проставить боту соответствующий аватар)
• Пожелания к настройкам бота (о них мы уже рассказали)
• Список администраторов для бота — тех пользователей Телеграм, от кого он должен выполнять команды (админы должны иметь имя пользователя (username) в Телеграме).
• Конфигурационная таблица с вашими ключевыми словами и ответами (можете начать делать ее заранее).
• E-mail людей, которые будут обновлять вашу конфигурационную таблицу (e-mail должен быть привязан к Гугл-аккаунту).

Авторство и обратная связь

См. также

Региональная группа взаимопомощи в Телеграм

Бот-привратник Shieldy

Ответственный за страницу