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

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

Ожидаемый результат работы флагов будет примерно следующий:

Краткая вводная дана, переходим к порядку реализации.

Создаем бота через @BotFather, создаем новую ГТ и открываем AppsScripts (подробнее про создание ботов можно почитать тут.

Начало

Как правило, я делю скрипт на несколько логических кусочков и сохраняю в разные файлы

Настоятельно рекомендую поступать также.

В файл Global записываю глобальные переменные или константы.

const API = "Ваш АПИ";
const DOC = SpreadsheetApp.openById("Ваш ИД");
const Test = DOC.getSheetByName("Ваше название листа");
//в кавычки пропишите свои значения

Здесь

• API бота;

• ссылка на текущий гугл док;

• лист этого дока, с которым мы будем непосредственно работать.

Ссылка на гугл док расположена в адресной строке браузера

Клавиатура и ее отправка в чат

В файле Keyboards создадим нашу клавиатуру. Клавиатуру я записываю в отдельную переменную (в данном случае FLAGS)

Моя клава выглядит так:

let FLAGS =
  {
      "inline_keyboard": [
        [{"text": "➖ Уточнение деталей у клиента по вакансии устно", "callback_data": "0"}],
        [{"text": "➖ Уточнение деталей у клиента по вакансии письменно", "callback_data": "1"}],
        [{"text": "➖ Составление карты поиска", "callback_data": "2"}],
        [{"text": "➖ Размещение вакансий на различных источниках", "callback_data": "3"}],
        [{"text": "➖ Поиск на открытых источниках", "callback_data": "4"}],
        [{"text": "➖ Сорсинг", "callback_data": "5"}],
        [{"text": "➖ Телефонное интервью", "callback_data": "6"}],
        [{"text": "➖ Собеседование с видео по zoom/Skype", "callback_data": "7"}],
        [{"text": "➖ Технический скрининг на собеседование", "callback_data": "8"}],
        [{"text": "➖ Контроль выхода кандидата ", "callback_data": "9"}],
        [{"text": "➖ Контроль ИС", "callback_data": "10"}]
      ],
      "resize_keyboard": true
    }; 

Сейчас самое интересное…

Какая логика? Мы отправляем клаву в чат по запросу пользователя, по команде, например. Далее пользователь кликает на один из вариантов (кнопку), который хочет выбрать. Мы запоминаем его выбор и отправляем новую клавиатуру, где в тексте выбранной кнопки будет изменен флаг.

Внимательный читатель заметил, что в названиях кнопок есть смайлики. Они-то и будут нашими флагами, которые отражают одно из значений true/false, 1/0, да/нет.

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

function getInd(chat_id,sheet) { //возвращает индекс строки, в кот нах-ся ид
  let lr = sheet.getLastRow();
  let chat_id_arr = sheet.getRange(1,1,lr).getValues();
  chat_id_arr = chat_id_arr.flat();
  let ind = chat_id_arr.indexOf(chat_id);
  
  return ind;
}

Функция выше возвращает id строки таблицы, в которой записан искомый ид чата. Id строки в таблице и номер строки - не одно и то же. Когда мы забираем все значения из таблицы и записываем их в массив (методом getValues()), значения в массиве начинаются с 0, тогда как в таблице отсчет ведется с 1. Просто помним об этом)

Следующая функция ищет chat_id в таблице и возвращает соответствующую этому ид клаву. В ином случае возвращает дефолтную клаву.

function getKeyboard(chat_id) { //забирает клаву из табл
  let ind = getInd(chat_id,Test); 
  let lc = Test.getLastColumn();
  let cur_keyboard = [];
  let keys = [];
  let KEYBOARD = {};
  
  if (ind > 0) { //если ind=-1, chat_id не был найден в таблице
    keys = Test.getRange(ind+1,2,1,lc).getValues();
    keys = keys.flat();
    for (i=0; i<keys.length; i++) {
      cur_keyboard.push([{"text":keys[i], "callback_data":i}]);
    }
    if (cur_keyboard != "") {
      KEYBOARD = 
        {
          "inline_keyboard": cur_keyboard,
          "resize_keyboard": true
        }
    } else {
      KEYBOARD = FLAGS;
    }
  } else {
    KEYBOARD = FLAGS;
  }
  return KEYBOARD
}

И разумеется, нужна функция для сохранения клавиатуры в таблице гугл

function setKeyboard(chat_id,vote) { //записывает текст клавы в табл
  let ind = getInd(chat_id,Test);
  let KEYBOARD = getKeyboard(chat_id);
  let key = KEYBOARD.inline_keyboard[vote][0].text; 
  let flag = key.split(' ');
  switch (flag[0])
    {
      case '✅' : flag.splice(0,1,'➖'); break;
      case '➖' : flag.splice(0,1,'✅'); break;
    }
  flag = flag.join(' ');
  KEYBOARD.inline_keyboard[vote][0].text = flag;
  let new_arr = [];
  new_arr = KEYBOARD.inline_keyboard.flat();
  
  if (ind < 0) { //если ид нет в табл
    let new_ind = Test.getLastRow()+1; //строка для записи нового ид
    Test.getRange(new_ind,1).setValue(chat_id);
    for (i=0; i<new_arr.length; i++) {
      Test.getRange(new_ind,2+i).setValue(new_arr[i].text)
    }
  } else {
      for (i=0; i<new_arr.length; i++) {
      Test.getRange(ind+1,2+i).setValue(new_arr[i].text)
    }
  }
}

Здесь я сначала разделяю текст кнопки, которая была нажата, по пробелам, получая массив. Далее изменяю первый элемент (смайлик) на противоположное значение.

Объединяю все снова в один текст для этой кнопки и записываю в таблицу.

Сохраненная в таблице клавиатура будет выглядеть так

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

Также запилю функцию для отправки клавы пользователя в виде сообщения

function sendKeyboard(chat_id) { //вернет клаву в виде текста
  let ind_keyboard = getInd(chat_id,Test);
  let msg = Test.getRange(ind_keyboard+1,2,1,Test.getLastColumn()).getValues();
  msg = msg.flat();
  msg = msg.join(",\n");

  return msg
}

Функции отправки сообщений ботом

Бот будет общаться с пользователем с помощью двух функций send() и send_key().

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

function send_key (msg, chat_id, api, keyboard)
{
  var payload = {
    'method': 'sendMessage',
    'chat_id': String(chat_id),
    'text': msg,
    'parse_mode': 'HTML',
    reply_markup : JSON.stringify(keyboard)
  }
  var data = {
    "method": "post",
    "payload": payload
  }
  UrlFetchApp.fetch('https://api.telegram.org/bot' + api + '/', data);

Функция отправляет инлайн-клавиатуру в чат вместе с сообщением. Соответственно на входе нам нужны текст сообщения, ид чата, куда мы эти сообщение и клаву отправляем, апи бота и сама клава.

Вызываем функции send() и send_key() из тела функции doPost().

Стандартная функция doPost() для коммуникации с ботом получает от нас одну из двух команд и выполняет два соотвутствующих этим командам действия:

• отправляет клаву в чат;

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

function doPost(e)
{
  let update = JSON.parse(e.postData.contents);
  if (update.hasOwnProperty('message'))
  {
    let msg = update.message;
    let chat_id = msg.chat.id;
    let text = msg.text;
    
    if (text == "/getkeyboard") {
      let keyboardToSend = getKeyboard(chat_id);
      Demo.send_key("Галочки", chat_id, API, keyboardToSend)
    }
    if (text == "/save") {
      Demo.send("Клавиатура сохранена: \n" + sendKeyboard(chat_id), chat_id, API)
    }
  }

  if (update.hasOwnProperty('callback_query')) {
    let chat_id = update.callback_query.message.chat.id;
    let vote = update.callback_query.data;
    let msg_id = update.callback_query.message.message_id;

    if (vote >= 0 && vote <= 11) {
      setKeyboard(chat_id,vote);
      Demo.send_key("Ваш выбор: ",chat_id,API,getKeyboard(chat_id));
    }
  }
}

В функции выше у нас имеются два условия

• update.hasOwnProperty('message')

• update.hasOwnProperty('callback_query')

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

В переменную vote я записываю значение callback_data нажатой кнопки. callback_data мы указали в переменной FLAGS для каждой кнопки, и эти значения - числа от 0 до 10.

Эти же числа выполняют роль номера элемента массива при работе c кнопками в функции setKeyboard().

Сохраняем и деплоим

Создадим файл Api connector и запишем сюда функцию установки вебхука

function api_connector ()
{
  let App_link = " ";
  //App_link указываем свой и обновляем после каждого деплоя
  UrlFetchApp.fetch("https://api.telegram.org/bot"+API+"/setWebHook?url="+App_link); 
}

Укажем App_link (ссылка появляется в окне после деплоя) и запустим функцию api_connector.

Тестируем бота

Я отправила боту сообщение "/getkeyboard", на что он мне вернул клаву без галочек

Далее результат клика по одной из кнопок

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

К списку функций в файл functions допишем следующую функцию

function del_inline(chat_id, msg_id) {
  var payload = {
    'method': 'editMessageReplyMarkup',
    'chat_id': String(chat_id),
    'message_id': String(msg_id)
  }
  var Data = {
    "method": "post",
    "payload": payload
  }
  UrlFetchApp.fetch('https://api.telegram.org/bot' + API + '/', Data); 
}

И добавим вызов этой функции в doPost()

Проверяем работу бота снова

Предыдущая клава успешна удалена.

По команде "/save" мы получаем от бота нашу клаву в виде сообщения

Заключение

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