Бот для атрымання ў Telegram

Дайце вашым кліентам магчымасць спампоўваць свае сертыфікаты пасля ўводу персанальных даных.

Telegram-бот запросіць персанальныя даныя, напрыклад, адрас электроннай пошты ці Імя, і выдасць файлы з Дыска, што адпавядаюць запыту. Калі файлаў некалькі, будуць выдадзены ўсе.

Інтэграцыя з Telegram знаходзіцца ў раздзеле «Інтэграцыі» – Telegram-бот.

Налады інтэграцыі

• Дазволіць Telegram-бот.

  Гэты пераключальнік уключае або адключае выкарыстанне бота. Калі бот адключаны, пры спробе адпраўкі паведамлення ў адказ будзе прыходзіць "Бот не працуе".

• Токен

  Токен для доступу да Telegram API. Яго трэба атрымаць пры стварэнні новага бота. Пасля ўводу токена і захавання даных пад полем для ўводу павінна з’явіцца надпіс «Бот паспяхова актываваны ў Telegram API». Гэта азначае, што токен правільны, і бот прайшоў паспяховую актывацыю ў Telegram.

  Стварэнне бота

  Спачатку трэба зарэгістраваць новага бота ў @BotFather, каб атрымаць токен для працы з Telegram API. Рэгістрацыя складаецца з некалькіх простых этапаў:

  1. У Telegram неабходна адкрыць чат з @BotFather;
  2. Далей увесці або выбраць з спісу каманду /newbot;
  3. Затым адправіць жаданае назву для бота, напрыклад, «Алімпіяда Новы час»;
  4. Далей напісаць імя карыстальніка (юзернейм) бота, па якім яго будуць знаходзіць у пошуку. Абавязкова ў канцы новага юзернейма павінна быць слова «bot» ці «_bot». Напрыклад, OlympNewTime_bot;
  5. Можна напісаць апісанне бота. Для гэтага трэба ўвесці або выбраць з спісу каманду /setdescription і выбраць новага бота. Затым напісаць тэкст і кароткую інструкцыю прыблізна наступнага зместу:
     Атрымаеце вашыя дыпломы і граматы за ўдзел у алімпіядзе "Новы час". Проста напішыце свае прозвішча і імя. У адказ вы атрымаеце ваш дыплом ці грамату. Калі файл не знойдзены — праверце правільнасць напісання Імя ці звярніцеся да нас. Калі плануецца выдача файлаў не па Імя, а па іншых даных — трэба ўказаць гэта.
  6. Можна дадаць каманду запуску, для гэтага трэба адправіць /setcommands, выбраць новага бота і напісаць «start - Запусціць. Пры адкрыцці бота кнопка "Запусціць" будзе адпраўляць пачатковы запыт.
  7. Па жаданні, можна загрузіць лагатып бота. Для гэтага ёсць каманда /setuserpic
• Паведамленні

  Паведамленні, якія будзе адпраўляць бот, і параметры пошуку даных. Магчымыя два варыянты — з выкарыстаннем аднаго або двух паведамленняў.

  Толькі адно паведамленне

  Можна выкарыстоўваць толькі адно паведамленне для пошуку файлаў. Пасля атрымання даных будзе выкананы пошук па файлах, і пры знаходжанні адпаведных файлаў яны будуць адпраўлены карыстальніку.

  Самы просты варыянт — пытаць прозвішча і імя. Для гэтага ў полі "Паведамленне" трэба напісаць тэкст "Напішыце прозвішча і імя". А ў полі "Зменная 1" — тую зменную, якая пазначана ў дакументах, напрыклад %name. Іншы варыянт — пошук толькі па прозвішчу. Для гэтага ў тыпе пошуку трэба ўказаць "першае слова" — і пошук будзе выкананы толькі па першым слове пазначанай зменнай. Адрас электроннай пошты — %email.

  Два паведамленні

  Для лепшай абароны можна выкарыстоўваць два паведамленні. Бот адпраўляе файлы, якія адпавядаюць абодвум запытам.

  Напрыклад, пры стварэнні файлаў можна дадаць у табліцу пароль, і бот будзе пытаць яго спачатку. А затым — Імя. Калі пароль і Імя будуць знойдзены — бот адправіць файлы. Пароль можна перадаць сваім кліентам праз закрытыя каналы сувязі. Ён можа быць аднолькавым (ці розным) для ўсіх у рамках аднаго або некалькіх мерапрыемстваў.

  Каб дадаць пароль у табліцу, трэба ў "Пытанне 2" дадаць зменную %пароль. Затым у дакуменце клікнуць па пустой калонцы і выбраць гэтую зменную. У гэтую калонку трэба ўнесці пароль.

  У абодвух запытах могуць быць запытаныя персанальныя даныя для кожнага файла, якія могуць быць як нанесены на сам файл, так і захаваны разам з ім.

• Тып пошуку

  У гэтым выпадальным спісе можна выбраць, наколькі дакладна праводзіць пошук па зменных. Можна настроіць пошук па толькі першаму слову, напрыклад, па прозвішчу. Гэта будзе актуальна, калі ў файлах недакладныя даныя (напрыклад, не ўсе пазначылі). Калі прасіць карыстальніка бота ўказаць поўнае Імя, а ў файлах недакладныя даныя, то файл проста не будзе знойдзены. Але, пры наладзе тыпу пошуку "па першаму слову", бот можа прасіць уводзіць толькі прозвішча. Каб не адпраўляць даныя аднофамільцам, можна настроіць пошук па двух параметрах.

• Доступ да файлаў. Абмежаванне доступу да файлаў, якія будуць даступныя праз бота. Можна ўказаць некалькі каталогаў, ці выбраць усе файлы на Дыску. Калі файл знаходзіцца ў падкаталогу, а ў гэтым полі пазначаны родны каталог, то ён таксама будзе даступны. Узровень укладзенасці не мае значэння.

Іншыя інтэграцыі