Часть 1: где рассматривается «серверная» часть, находящаяся на стороне гугл таблиц

Часть 2: начало работы с ботом, вебхуки, doPost

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

doPost(e)

// основная функция, которая обрабатывает входящие данные от телеграма
function doPost(e){

  const main = JSON.parse(e.postData.contents); // получаем данные из телеграм бота
 
  // вытаскиваем все данные из contents
  const chatId = main.message.chat.id;
  const firstName = main.message.chat.first_name;
  const lastName = main.message.chat.last_name;
  const messageText = main.message.text;
  const arrayText = messageText.split(" "); // массив для последующей обработки команд
  
  const detailsArray = [chatId, firstName, lastName, messageText, arrayText]; //собираем все что выше массив
  const objToTransfer = Object.assign({}, detailsArray); // делаем из массива объект для передачи

  analyseDetails(objToTransfer); //вызываем функцию для дальнейшей обработки того, что пришло
      
}

Первую часть с JSON я описывал ранее.

Далее я беру по ключу объекта его значение и самое важное тут chatId = main.message.chat.id;

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

Далее я собираю все это в массив, на основе которого создаю объект при помощи Object.assign({}, detailsArray)

В чем прелесть Object.assign так это то, что созданный объект имеет вид: {0: chatId, 1: firstName, 2: lastName}.

Далее созданный объект я передаю в функцию analyseDetails

analyseDetails(obj)

function analyseDetails(objReceived){ // анализ того, что пришло со стороны телеграма
 
  const receivedCommand = objReceived[4][0].toLowerCase(); // "4": ["/list", "", "" и тд]

  switch(receivedCommand){ //если пришла команда
    case '/start':
      sendStartMessage(objReceived);
      break;

    case '/help':
      sendStartMessage(objReceived);
      break;
        
    case '/join':
      setNewUser(objReceived);
      break;

    case '/list':
      sendList(objReceived);
      break;

    default: // если пришло что-то отличное от команды
      onModer(objReceived);
      break;
  }
}

Функция берет пятое ([4]) значение объекта — текстовый массив arrayText и смотрит на содержание его первого ([0]) элемента. Если там какая-либо команда то происходит выполнение функции по имени этой команды, если там текст — отправка его на модерацию администратору телеграм-бота

Case /start и /help

function sendStartMessage(obj){ 
  
  const userId = obj[0]; //Юзер id
  const startMessage = `🤖 Привет! 🤖\n\n В своей базе  я храню данные по срокам предоставления налоговых и бухгалтерских отчетов и деклараций. За ${LESSDAYS} дней до окончания срока я высылаю уведомление об этом.\n\n Чтобы я смог присылать такие уведомления Вам, отправьте команду /join\n\n Чтобы получить список деклараций и сроков их подачи в ближайший квартал, отправьте команду /list\n\n Если Вам необходимо добавить в базу недостающие сроки подачи деклараций, отправьте мне сообщение в виде "Дата: Декларация" и я передам его на модерацию`

  sendMessage(userId, startMessage);
}

Obj — это тот объект, что приходит из doPost в analyseDetails и далее из него идет на все команды

sendMessage — основная функция, передающая что-либо в телеграм

sendMessage(chatid, chatText)

Вся информация по методу детально описана здесь — https://core.telegram.org/bots/api#sendmessage и повторять ее нет никакого смысла

// базовая функция для отправки сообщения в телеграм с "сервера"
function sendMessage(chatid, chatText) {
 
  const chatId = chatid;
  const text = chatText;

  const payload = {
      "method": "sendMessage",
      "chat_id": String(chatId),
      "text": text,
      "parse_mode": 'HTML',
      "disable_web_page_preview": true
  };

  const data = {
       "method": "post",
      "payload": payload
  };

  UrlFetchApp.fetch(telegramUrl, data);
}

UrlFetchApp.fetch(telegramUrl, data); — передает данные со стороны гугл таблиц на телеграм

Case /join — setNewUser(obj)

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

function setNewUser(obj){
  const userId = obj[0]; //Юзер id
 
  const userArr = wsUsers.getDataRange().getValues() // получаю массив массивов c пользовательскими id
  const flatUserArr = userArr.flat() // делаю его обычным массивом для последующего indexOf
  const userIsHere = flatUserArr.indexOf(userId) // делаю проверку наличия записи пользовательского ID

  if(userIsHere !== -1){ // если такой пользователь уже есть 
    sendMessage(userId, "Пользователь уже есть в моей базе 🧐")
  } else { // добавляю нового пользователя
    wsUsers.appendRow([userId]) // appendRow - каждая ячейка это массив
    sendMessage(userId, "Пользователь был успешно добавлен.\nВ ближайшее время ждите рассылку!")
  }
  
}

Функция setNewUser() проверяет наличие записанного пользовательского id на листе «Users» и если такого айди там нет — записывает его через wsUsers.appendRow([userId])

Case /list — отправка списка деклараций к подаче в ближайшие 90 дней

// для выполнения /list - список подаваемых деклараций на ближайшие QUARTER дней
function getQuarterList(){
    
  const today = new Date() // сегодня

  const quarter = new Date()
  quarter.setDate(today.getDate() + QUARTER) // сегодня + QUARTER дней

  const allArr = wsDb.getDataRange().getValues() // массив со всеми датами и декларациями

  const filteredArr = allArr.filter(row => (new Date(row[0])) > today && (new Date(row[0])) < quarter) // выбираем записи которые больше чем сегодня и меньше чем через QUARTER дней
  const beautyArr = filteredArr.map(row => [(row[0].toLocaleString().split(',')[0]) + " : " + row[1]]) // причесываем для последующей конвертации в текст
  
  const arrToText = beautyArr.join('\n')
  
  return arrToText
}

// послать список подаваемых деклараций на ближайшие QUARTER дней
function sendList(obj){
 const userId = obj[0]; //Юзер id
 const text =  getQuarterList() // данные к подаче на ближайшие QUARTER дней

 sendMessage(userId, text);
}

getQuarterList — выбирает весь список данных и фильтрует их между датами сегодня и сегодня + 90 дней

sendList — посылает список пользователю

Case default — когда приходит что угодно

// если пришло что-то отличное от команды - отправить администратору бота
function onModer(obj){
  const userId = obj[0]
  const userName = obj[1]
  const userSurname = obj[2]
  const userMessage = obj[3]

  const text = `Пользователь ${userName} ${userSurname} с ID ${userId} послал на модерацию сообщение: ${userMessage}`
  
  sendMessage(ADMIN_ID, text)
}

Функция отправляет «что угодно, отличное от пришедших команд» администратору ADMIN_ID на модерацию

И последняя часть — «серверная»:

Отправка боту «списка приближающихся сроков» по триггеру

// Фильтрованный массив с датами в текст
 function filteredArrToText(){
   
  const filteredArr = filteredDaysArr(); // фильтрованный массив
  const beautyArr = filteredArr.map(row =>[row[0]+" : " +row[1]]) // "причесанный" фильтрованный массив
  
  const textFromArr = beautyArr.join('\n') // массив в текст с разделителем новой строки для отправки в телеграм
  
  return textFromArr
 
 }

 // Для ежедневного триггера - проверка на наличие отправки
 function checkerToSend(){
   const text = filteredArrToText() // что сегодня рассылать - текст из фильтрованного массива
   
   if(text.length !== 0){ // если длина текста не равна 0 - т.е. там есть что отправлять
     const userArr = wsUsers.getDataRange().getValues() // получаю массив с пользовательскими id - кому идет рассылка
     
     for(let elem of userArr){ // для каждого элемента массива с пользовательскими id
       let messageText = `📨  Через ${LESSDAYS} дней срок подачи:\n`
       sendMessage(elem, (messageText + text)) // отправка сообшения
     }
   }
 }

checkerToSend вешается на триггер по дням и если длина text собранного из filteredArrToText не равна 0, т.е. когда там есть текст — отправляется на всех пользователей из wsUsers.getDataRange().getValues()

На этом написание телеграм-бота можно считать законченным. Останется только навести красоту через @BotFather с командами.

---

Ваше мнение важно и может улучшить блог

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