{"draftJsState":{"blocks":[{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":70,"offset":0,"style":"BOLD"}],"text":"Для чего мы создали чат-бот Сервисдеска, какие трудности и как решали.","type":"unstyled","key":"i1o9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"unstyled","key":"m4d4"},{"data":{},"depth":0,"entityRanges":[{"key":0,"length":11,"offset":138},{"key":1,"length":19,"offset":151},{"key":2,"length":18,"offset":172}],"inlineStyleRanges":[],"text":"Привет, меня зовут Юрий, и я фулстек-разработчик в DataLine. В компании занимаюсь созданием и развитием внутренних и внешних ИТ-сервисов: Сервисдеска, мастер-справочников, учета оборудования.","type":"unstyled","key":"4sa69"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Но, как говорится, каждый разработчик в жизни должен сделать 3 вещи: развернуть дерево, распарсить DOM и вырастить своего чат-бота. О последнем и поговорим: расскажу, как делал своего первого чат-бота для нашего Сервисдеска, какие задачи и как решал, с какими трудностями и способами преодоления столкнулся.","type":"unstyled","key":"2r2on"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Задачи чат-бота и вводные","type":"header-two","key":"1spml"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"По умолчанию все обращения клиентов в нашу службу Сервисдеска собираются в почте – это официальный канал коммуникации. В договоре с каждой компанией мы прописываем электронную почту для связи, и на выбранный ящик приходят все оповещения: о регистрации запроса в техподдержку, об изменении ее статуса, о запросе дополнительной информации и решении вопроса.","type":"unstyled","key":"63ffc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Но в почте клиенту не всегда удобно отслеживать статус работ и переписываться с инженерами, особенно при работе “в полях”. Все-таки на электронные ящики приходит много информации, письма могут “теряться”. Поэтому идея бота назрела уже давно.","type":"unstyled","key":"3c5de"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":62,"offset":0,"style":"BOLD"}],"text":"Вот какие возможности мы хотели предложить пользователям бота:","type":"unstyled","key":"5eno"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"авторизовать существующих клиентов, у которых нет учетной записи в системе;","type":"unordered-list-item","key":"997lh"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"создавать заявки (с вложениями и без);","type":"unordered-list-item","key":"7bb0f"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"получать информацию по статусу заявок;","type":"unordered-list-item","key":"6ikfv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"вести и просматривать переписку с исполнителем заявки;","type":"unordered-list-item","key":"du00h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"получать все вложения по заявке и добавлять их в переписке;","type":"unordered-list-item","key":"7qjcb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"просматривать заявки своих коллег, подписываться на их изменения и участвовать в переписке;","type":"unordered-list-item","key":"19sl1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"просматривать перечень заявок, отфильтрованных по разным признакам (Мои заявки, Заявки организации и т.д.);","type":"unordered-list-item","key":"7pegm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"расширять функциональность параллельно с развитием Сервисдеска.","type":"unordered-list-item","key":"11o3s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":58,"offset":0,"style":"BOLD"}],"text":"Для реализации задумок выбрали такой технологический стек:","type":"unstyled","key":"510go"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Java 11,","type":"unordered-list-item","key":"as9un"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Kotlin,","type":"unordered-list-item","key":"9ql3a"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"org.telegram:telegrambots,","type":"unordered-list-item","key":"dass1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Jackson,","type":"unordered-list-item","key":"c0qcb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Spring (boot, JPA, mail, web, aop, cache, RestTemplate),","type":"unordered-list-item","key":"1s5q8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Hibernate,","type":"unordered-list-item","key":"av8q6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"PostgreSQL,","type":"unordered-list-item","key":"9lat"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Flywaydb,","type":"unordered-list-item","key":"d1ea8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Gradle,","type":"unordered-list-item","key":"aga9s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"API Servicedesk*.","type":"unordered-list-item","key":"feglh"},{"data":{},"depth":0,"entityRanges":[{"key":3,"length":13,"offset":46},{"key":4,"length":18,"offset":100},{"key":5,"length":13,"offset":487}],"inlineStyleRanges":[],"text":"* API Servicedesk (или, на внутреннем жаргоне, oapi.dtln.ru) – это опубликованный корпоративный API нашего Сервисдеска (на самом деле не только Сервисдеска, а и многих других внутренних сервисов компании). Его используют для общения с заявками различные внутренние сервисы компании: системы мониторинга, личный кабинет клиента, внутренние системы учета, различные администраторские скрипты и т.д.Данный сервис имеет OpenAPI-описание в Swagger и вполне удобен для интеграции.Подробнее про oapi.dtln.ru и проблемы интеграции корпоративных систем в единую точку входа для сервисов компании напишем в следующих статьях.","type":"blockquote","key":"9ctql"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В проекте было два вызова для разработчика. Во-первых, это новые инструменты разработки. Изначально я Java-разработчик, занят на проектах, написанных на Lucee. Для меня это был первый самостоятельный проект в компании, собранный с нуля. Во-вторых, изменившийся бэклог: стартовых задач нам показалось мало, и мы расширили их пул. Но обо всем по порядку.","type":"unstyled","key":"3nnds"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Начнем с базовой функциональности","type":"header-two","key":"art58"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":22,"offset":0,"style":"BOLD"}],"text":"Проектируем интерфейс. Первые сложности были в том, что конечных планов у проекта нет и надо делать достаточно легко расширяемую архитектуру. С нее и начал.","type":"unstyled","key":"3in6n"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На одном листе расписал всю бизнес-логику: для какого пользовательского сценария какие запросы используются. Вышло что-то такое.","type":"unstyled","key":"78jlh"},{"data":{"image":{"id":"646df9affe2aca4b3c215d38"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"3tsoo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это помогло разобраться в архитектуре приложения, иерархии создаваемых классов и их взаимосвязях, чтобы не наделать ошибок на старте разработки.","type":"unstyled","key":"akve"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Как пример понятного взаимодействия с пользователем я взял BotFather. По реализации решил не размениваться на простые команды типа: /start, /мои_заявки, /твои_заявки, – их может быть больше десятка, и это будет неудобно в использовании. Вместо этого стал формировать полноценные менюшки с кнопочками (CallBackQuery), благодаря чему получилось достаточно симпатичное и интуитивное меню.","type":"unstyled","key":"265k6"},{"data":{"image":{"id":"646df9affe2aca4b3c215d39"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Так выглядит меню внутри чата по заявке. Эту иллюстрацию делал в рамках пользовательской инструкции, чтобы сориентировать клиентов по меню\n","type":"atomic:image","key":"ach85"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"header-three","key":"a09qu"},{"data":{"image":{"id":"646df9afe3e0d771f2f294eb"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Так выглядит меню по заявка ","type":"atomic:image","key":"qcq6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В разных частях меню от бота может потребоваться разная реакция на одно и то же пользовательское сообщение. Например, если пользователь напишет в чат что-то из списка “Мои заявки”, то бот отфильтрует перечень в поиске совпадений. А если пользователь напишет это же сообщение из меню “Чат заявки”, то бот отреагирует так, будто пользователь хочет отправить сообщение в чат. ","type":"unstyled","key":"drd2i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы это реализовать, я закрепил за каждым меню “Состояние” (State) и сохранял его у пользователя. Покажу подробнее на примерах.","type":"unstyled","key":"7dm7d"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":25,"offset":0,"style":"BOLD"}],"text":"Реализуем первые команды. Самое первое, что нужно предложить клиентам, – создание заявок через бота и информирование по их исполнению. А все остальное уже потом.","type":"unstyled","key":"ivii"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В качестве способа взаимодействия с сервером Сервисдеска используется REST OAPI.","type":"unstyled","key":"34oc3"},{"data":{},"depth":0,"entityRanges":[{"key":6,"length":12,"offset":51}],"inlineStyleRanges":[],"text":"Для взаимодействия с сервером Telegram мы выбрали лонг-поллинг: так бот периодически сам опрашивает сервер в надежде на Update. Решение приняли из соображений безопасности, чтобы не нужно было публиковать сервер наружу для трансляции обновлений.","type":"unstyled","key":"327eg"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Схема взаимодействия (сетевая схема):","type":"unstyled","key":"aaaq1"},{"data":{"image":{"id":"646df9af2ece6b5eb68b3516"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"ev9j6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Что по коду. Bot наследует TelegramLongPollingBot с настройками и передачей прилетающего Update в сортировщик UpdateReceiver:","type":"unstyled","key":"fmt8h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"updateReceiver.handle(update)","type":"unstyled","key":"8idu1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"UpdateReceiver определяет, что прилетело, и выбирает для конкретного запроса обработчик Handler (или хендлер).","type":"unstyled","key":"5i18"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Тут нам помогает магия Spring. Чтобы все обработчики автоматом добавлялись в наш UpdateReceiver, я создал интерфейс Handler.","type":"unstyled","key":"26et"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Service\ninterface Handler {\n // основной метод, который будет обрабатывать действия пользователя\n fun handle(user: User, update: Update): List>\n\n // метод, который позволяет узнать, можем ли мы обработать текущий State у пользователя\n fun operatedBotState(state: State): Boolean\n\n // метод, который позволяет узнать, какие команды CallBackQuery мы можем обработать в этом классе\n fun operatedCallBackQuery(): List\n}","type":"unstyled","key":"1ab3o"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Каждый обработчик наследуется от него, например, HelpHandler.","type":"unstyled","key":"7192k"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Component\nclass HelpHandler : Handler {\n\n @Autowired\n private lateinit var globalMenu: GlobalMenu\n companion object {\n //Храним поддерживаемые CallBackQuery в виде констант\n const val MENU_MAIN = \"/help\"\n }\n\n override fun handle(user: User, update: Update): List> {\n return globalMenu.menuSD(user,update)\n }\n\n override fun operatedBotState(state: State): Boolean {\n return when (state) {\n State.MENU_MAIN -> true\n else -> false\n }\n }\n\n override fun operatedCallBackQuery(): List {\n return listOf(MENU_MAIN)\n }\n\n}","type":"unstyled","key":"4eclc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это способствует расширяемости: можем заинжектить все обработчики всего 2 строчками и не беспокоиться в дальнейшем о появлении новых.","type":"unstyled","key":"4shta"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Autowired // Храним доступные хендлеры в списке\nprivate lateinit var handlers: List","type":"unstyled","key":"bubsb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если пользователь что-то пишет в чат, то остается все обработать по такому алгоритму:","type":"unstyled","key":"31mn9"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"1) проходимся по списку наших обработчиков в UpdateReceiver:","type":"unstyled","key":"4v0g7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"fun handle(update: Update): List> {\n val messages: MutableList> = ArrayList()\n if (update.hasMessage()) {\nuser.botState.let { (getHandlerByState(it).handle(user, update)) }.let { messages.addAll(it) }\nreturn messages\n }\n}","type":"unstyled","key":"5cfpc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"2) спрашиваем у них, могут ли они обработать пришедший update:","type":"unstyled","key":"co6qr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"private fun getHandlerByState(state: State): Handler {\n return handlers.stream()\n .filter { h: Handler -> h.operatedBotState(state) }\n .findAny()\n .orElseThrow { UnsupportedOperationException() }\n}","type":"unstyled","key":"f35b6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"3) если кто-то отвечает “да”, то вызываем метод handle() у нужного хендлера.","type":"unstyled","key":"2dise"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":20,"offset":0,"style":"BOLD"}],"text":"Дополнительные фичи. Все реплики бота я вынес из кода и поместил в отдельный файл (messages_ru_RU.properties) в таком виде:","type":"unstyled","key":"anumi"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"button.cancel= ❌ Отмена\nbutton.cancel-en= ❌ Cancel","type":"unstyled","key":"elc4r"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Это помогло легко соорудить RU/EN меню и затем отдать тексты на редактирование профессиональному копирайтеру для формирования более грамотной речи у бота :-).","type":"unstyled","key":"6i21s"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Для получения реплик из файла создаем класс:","type":"unstyled","key":"cn6c8"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Service\nclass LocaleMessageService(@Value(\"\\${localeTag}\") localeTag: String, private val messageSource: MessageSource) {\n private val locale: Locale = Locale.forLanguageTag(localeTag)\n fun message(message: String, user: User): String {\n val mes:String = if(user.langEn) \"${message}-en\" else message\n return messageSource.getMessage(mes, null, locale)\n }\n}","type":"unstyled","key":"2hhqj"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Сам localeTag: ru-RU прописывается в application.yaml.","type":"unstyled","key":"f76ag"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Далее инжектим класс в наш хендлер и создаем кнопку:","type":"unstyled","key":"3avf1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"val btn = InlineKeyboardButton()\nbtn.text = localeMessageService.message(\"button.cancel\",user)\nbtn.callbackData = command","type":"unstyled","key":"7hndr"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Также я добавил сквозную функцию, по которой бот показывает свою реакцию на запрос пользователя, например: “... печатает” или ”>> отправляет файл”. Эта фишечка реализовалась благодаря Spring AOP. Функция срабатывает, как только запрос попадает в какой либо хендлер.","type":"unstyled","key":"4htvm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Aspect\n@Configuration\nclass AppAspects {\n\n @Autowired\n private lateinit var bot: Bot\n\n @Autowired\n private lateinit var telegramUtil: TelegramUtil\n\n // * - путь\n // * - класс\n // * - имя метода\n // (..) - параметры методов\n @Before(\"execution(* ru.путь.handler.*.handle(..))\")\n fun handler2Before(joinPoint: JoinPoint) {\n val user = joinPoint.args[0] as User\n val update = joinPoint.args[1] as Update\n bot.executeWithExceptionCheck(telegramUtil.sendAction(user))\n \n }\n}","type":"unstyled","key":"1oeik"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если что-то сломалось, у заявителя выскочит сообщение типа:","type":"unstyled","key":"cdok5"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"“Упс! Что-то пошло не так, но это не страшно!”","type":"blockquote","key":"b8f58"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"В это время нам на почту придет сообщение об ошибке:","type":"unstyled","key":"2a1hm"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@AfterThrowing (pointcut = \"execution(* ru.путь.*.*(..))\",throwing = \"ex\")\nfun throwingError(joinPoint: JoinPoint,ex: Exception){\n sendErrorOnMail(joinPoint, ex)\n}","type":"unstyled","key":"3d0ov"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Разберемся с безопасностью","type":"header-two","key":"d0qj3"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":26,"offset":0,"style":"BOLD"}],"text":"Регистрация пользователей. Изначально клиенты не имели прямого доступа к Сервисдеску, вся коммуникация шла через почту, прописанную в договоре. Нужно было выбрать способ, как идентифицировать “своих”:","type":"unstyled","key":"1o0tb"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Стандартно связать Telegram-аккаунт с аккаунтом в системе: предложить человеку, авторизованному на сайте, перейти по глубинной ссылке (Deep Link) в Telegram-бота. Этот способ нам не подошел, так как у клиентов нет авторизации на наших сайтах.","type":"ordered-list-item","key":"85fhc"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Идентифицировать и регистрировать, спросив у подключившегося к боту пользователя его e-mail, – так себе безопасность.","type":"ordered-list-item","key":"cl3be"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Воспользоваться функцией Telegramа “Поделиться своим контактом”. Мы выбрали этот вариант. Таким образом мы можем легко проверить и точно быть уверенными, что человек отправляет номер именно своего телефона, а не чей-то еще.","type":"ordered-list-item","key":"cm2dk"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Логика такая. Если пользователь – клиент DataLine, то информация о нем содержится в корпоративной информационной системе (Мастер-справочнике). Система проверит номер телефона и при необходимости предложит клиенту выбрать из списка организацию или договор, по которому он работает с DataLine.","type":"unstyled","key":"cg6pu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Нюанс в том, что человек со своим номером телефона может иметь несколько таких учеток. Он может числиться в нескольких организациях, быть нашим сотрудником и в то же время быть нашим клиентом. Все это надо было учесть: при регистрации после получения номера телефона мы задаем пару дополнительных вопросов, если телефон в системе встречается не один раз.","type":"unstyled","key":"9jj6j"},{"data":{"image":{"id":"646df9af14f4766b6be69199"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"8hjfv"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если в Telegram и в нашей системе у пользователя разные номера, то ему придется сменить контактный номер в Telegram, иначе с ботом связаться не получится. Если бот по каким-то причинам отказывается разговаривать с клиентом , то он может решить этот вопрос через своего сервис-менеджера.","type":"unstyled","key":"7iv3g"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чтобы уж наверняка все было безопасно, мы добавили двухфакторную аутентификацию.","type":"unstyled","key":"bgdnu"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Двухфакторка. В архитектурной схеме блок по 2FA выглядит вот так:","type":"unstyled","key":"bpaku"},{"data":{"image":{"id":"646df9afc9ca740ebd0223c0"}},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"atomic:image","key":"5etca"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Когда пользователь отправил свой номер телефона и мы выяснили, кто он, генерится 6-значный код.","type":"ordered-list-item","key":"17q91"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Код сохраняется в БД вместе с учетной записью, под которой пользователь хочет быть авторизован в Сервисдеске.","type":"ordered-list-item","key":"i8g2"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Через OAPI в Сервисдеск передается запрос на формирование и отправку смс через смс-шлюз. В смс содержится код и ссылка авторизации.","type":"ordered-list-item","key":"49rl6"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Когда пользователь отправляет в чат команду /start [code] или переходит по ссылке, я сопоставляю информацию в базе данных с тем, что прислал пользователь.","type":"ordered-list-item","key":"dpij1"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Если все хорошо, то код авторизации удаляется из БД и пользователь считается авторизованным.","type":"ordered-list-item","key":"91j62"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[{"length":13,"offset":0,"style":"BOLD"}],"text":"Лонг-поллинг. Итак, благодаря лонг-поллингу мы не светим свой адрес в мире и не позволяем кому попало слать на него всякие пакости. Вместо этого спрашиваем у api.telegram.org: “Есть чё?”","type":"unstyled","key":"5t01i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Чуть подробнее, как это сделано. Сам бот напрямую не имеет доступа к БД Сервисдеска, а получает информацию из него через OAPI при помощи REST-запросов. Для этого он предварительно авторизуется в OAPI и периодически обновляет свой token.","type":"unstyled","key":"8bqbe"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"При каждом запросе необходимо проверять уже авторизованного клиента на актуальность данных. Например, если сотрудник уволился, нужно обнулить его авторизацию. Каждая такая проверка – это дополнительный REST-запрос, что неслабо нагружает систему. Поэтому такой запрос пришлось кешировать. Для этого воспользовался возможностями Spring. Создал соответствующий бин:","type":"unstyled","key":"9aor"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Configuration\n@EnableCaching\nclass CacheConfig {\n @Bean\n fun cacheManager(): CacheManager? {\n val simpleCacheManager = SimpleCacheManager()\n simpleCacheManager.setCaches(\n listOf(\n ConcurrentMapCache(\n \"source\",\n CacheBuilder.newBuilder()\n .expireAfterWrite(10, TimeUnit.MINUTES)\n .maximumSize(10000)\n .build().asMap(), false\n )\n )\n )\n return simpleCacheManager\n }\n}","type":"unstyled","key":"687v7"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"И добавил аннотацию над необходимой мне функцией:","type":"unstyled","key":"a3g05"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"@Cacheable(value = [\"source\"], key = \"#sourceId\")\nfun checkAuth(sourceId: String): List {}","type":"unstyled","key":"dqdvo"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"“Подключим сюда сотрудников?”","type":"header-two","key":"7fjli"},{"data":{},"depth":0,"entityRanges":[{"key":7,"length":15,"offset":126}],"inlineStyleRanges":[],"text":"Теперь немного про развитие функциональности. Изначально бот разрабатывался в первую очередь для клиентов. У сотрудников есть свое приложение с доступом к Сервисдеску и другими свистелками, которых нет в боте. Но в приложении есть свои минусы, в частности: оно доступно только для Android и требует включенного VPN. Так что нам захотелось связать клиента с сотрудниками через интерфейс чат-бота.","type":"unstyled","key":"5hm0h"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"Конечно, перенести всю функциональность приложения в чат-бот не получится. Мы решили добавить в чат-бот для сотрудников уведомления по заявкам и переписку в заявке – через бота это получается быстрее, так как Telegram доступен всегда и на любых устройствах.","type":"unstyled","key":"4hm4i"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"На первом этапе разработки разделения на сотрудников и клиентов не предполагалось, так что писать разные интерфейсы для разных категорий я не стал. Но с самого начала проекта у нас не было конечного перечня необходимых возможностей. Поэтому на каждом шаге общения с ботом я учитывал, какому пользователю предназначается ответ бота. В коде интерфейс был один, просто для клиентов и сотрудников я показываю либо скрываю разные элементы интерфейса.","type":"unstyled","key":"99f7v"},{"data":{},"depth":0,"entityRanges":[],"inlineStyleRanges":[],"text":"","type":"marker","key":"JM1CmlZh6EH4Nr4CSZdS"}],"entityMap":{"0":{"data":{"href":"https://uni.dtln.ru/digest/kak-servis-provayder-delal-svoy-service-desk","url":"https://uni.dtln.ru/digest/kak-servis-provayder-delal-svoy-service-desk"},"mutability":"MUTABLE","type":"LINK"},"1":{"data":{"href":"https://info.dtln.ru/masterdata/index.cfm","url":"https://info.dtln.ru/masterdata/index.cfm"},"mutability":"MUTABLE","type":"LINK"},"2":{"data":{"href":"https://info.dtln.ru/am/index.cfm","url":"https://info.dtln.ru/am/index.cfm"},"mutability":"MUTABLE","type":"LINK"},"3":{"data":{"href":"http://oapi.dtln.ru/","url":"http://oapi.dtln.ru/"},"mutability":"MUTABLE","type":"LINK"},"4":{"data":{"href":"https://uni.dtln.ru/digest/kak-servis-provayder-delal-svoy-service-desk","url":"https://uni.dtln.ru/digest/kak-servis-provayder-delal-svoy-service-desk"},"mutability":"MUTABLE","type":"LINK"},"5":{"data":{"href":"http://oapi.dtln.ru/","url":"http://oapi.dtln.ru/"},"mutability":"MUTABLE","type":"LINK"},"6":{"data":{"href":"https://qna.habr.com/q/1080188","url":"https://qna.habr.com/q/1080188"},"mutability":"MUTABLE","type":"LINK"},"7":{"data":{"href":"https://uni.dtln.ru/digest/umestit-vse-cody-i-oblaka-v-karman-inzhenera-za-schet-mobilnogo-servisdeska","url":"https://uni.dtln.ru/digest/umestit-vse-cody-i-oblaka-v-karman-inzhenera-za-schet-mobilnogo-servisdeska"},"mutability":"MUTABLE","type":"LINK"}}},"mentions":[]}