Telegram api çfarë është? Një mënyrë e thjeshtë për të rritur njoftimet në Telegram Shtypni API-në për të ndryshuar motin

Nëse një fillestar vjen vetëm në mesazherin Telegram, atëherë ai menjëherë do të duhet të shqetësohet për ushqimin, si të fillojë ose, ndoshta, si të regjistrohet për shërbimin. Për këtë ju nevojitet një numër celulari dhe një nga shtesat për Telegram, të cilat mund t'i gjeni dhe shkarkoni në çdo platformë apo sistem operativ në adresën: https://www.telegram.org. Pasi të ketë përfunduar gjithçka, ne po kërkojmë një klient të ri të Telegram dhe një klient të mundshëm të kanaleve tona, i cili do të promovohet në shërbimin më të lartë.

Telegram.me angazhohet ose zhbllokohet për të hyrë në kanal

Përveç kësaj, ndërsa një i sapoardhur vazhdon rrugëtimin e tij me Telegramet, hapet gradualisht drita e panjohur deri tani e kanaleve të ndryshme. Për të parë Telegram.me, duhet të klikoni mbi të ose ta hapni në pajisjen tuaj në mënyrë që të shkoni në kanalin që keni klikuar. Aty ka biseda me bots të tjerë koristuvach dhe shërbimesh, duke parë artikuj të rinj, foto, video, koristuvach (tani parapagues i kanalit) me shumë orë njoftime reklamash, në të cilat ky kanal fiton para. Sigurisht, disa prej nesh do të dëshironin të kishin një kanal të tillë, por jo të gjithë e dinë se si.

Telegram API Rusisht i arritshëm për fillestarët

Ngritja e biznesit tuaj me telegram tani nuk është aq e lehtë sa më parë. Telegram API ka qenë prej kohësh i hapur për standardet ruse dhe ju lejon të krijoni kanalin tuaj bot me ndihmën e shablloneve dhe konstruktorëve shtesë.
Pjesa më e rëndësishme e punës është mashtrimi i parapagimeve duke marrë përsipër shërbimin nga mashtrimi në Top. Cilat janë nevojat e parapagimeve? Sa më shumë, aq më shumë kushton postimi reklamues dhe aq më shumë qindarkë sjell në kanalin Vlasnik. Pyetni botën përmes telegramit.

Pjesën tjetër të kohës, Telegrami është në buzët e të gjithëve. Është e nevojshme t'i kushtohet kujdes marketingut të këtij programi, i cili ka sjellë sukses të madh në gala. Një nga "truket" kryesore të Telegramit është se ai është jashtëzakonisht i sigurt - sipas Pavel Durov, i gjithë shfletimi midis llogarive është i koduar. Për më tepër, çdo shërbim special i botës nuk lejon akses derisa të na informoni. Megjithatë, ky artikull nuk thotë asgjë për këtë. Sot do të doja të flisja jo për veçorinë më pak të lezetshme në Telegram, por për vetë robotët. Për më tepër, në të njëjtën kohë, tashmë ka shumë informacione për bot të ndryshëm të Telegram (për shembull, bot github), mesazheri ka hapur API-në e tij për përdoruesit, dhe tani ju mund të krijoni botin tuaj të fuqishëm me blackjack dhe buns.

Këtu do t'ju tregoj se si të shkruani një bot në internet duke përdorur kornizën shtesë Python dhe Django. Pastaj ne do të krijojmë një shtesë të plotë në internet që do të funksionojë në një host të largët dhe do të pranojë komanda nga përdoruesit. I gjithë teksti i daljes është i disponueshëm në depon time github.

Dokumentacioni që përshkruan procesin e ndërveprimit me robotët e Telegram është i disponueshëm. Që biçikleta të mos shkojë keq, e di që e urrej bibliotekën Python që zbaton të gjitha funksionet kryesore të robotëve telepot. Siç e kam menduar tashmë më herët, për t'u shërbyer përdoruesve të botit tonë, ne do të zhvillojmë një shtesë në internet, një kornizë vikory dhe Django.

Si të krijoni një bot Telegram?

Për të filluar, duhet të regjistrojmë robotin tonë të ri në Telegram. Provojeni kështu:

  • Duhet të instaloni programin Telegram në telefonin ose kompjuterin tuaj. Ju mund të magjepsni programin
  • Le të shtojmë listën e kontakteve të robotit me im'yam BotBabai
  • Fillojmë procedurën e bashkimit me bot duke shtypur butonin Filloni. Më poshtë kemi një listë të komandave saktësisht si në pamjen e ekranit.
  • Për të krijuar një bot të ri, duhet të regjistroheni në komandën /newbot dhe ndiqni udhëzimet. Kthejeni respektin që emri i përdoruesit për bot është fajtor për hakmarrjen gjithmonë ndaj fjalës bot. Për shembull, DjangoBot ose Django_bot.

  • Për robotin tonë, zgjodha emrin PythonPlanetBot, sepse funksioni i tij kryesor është të analizojë burimin RSS në faqen e internetit të Python Planet dhe të sigurojë informacione për mbjelljet e mbetura të kopshtarit :)

Pas krijimit të botit, rrisni pak respektin me tekstin:

Vikorist këtë thirrje për Vikorist HTTP API:

Që pasohet nga i ashtuquajturi token që do të përdorim për të manipuluar robotin tonë. Përveç funksioneve të një boti telegrami të krijuar, BotFather gjithashtu ka aftësi të tjera të ulëta:

  • Jepini robotit një përshkrim
  • Vendosni një avatar
  • Ndrysho token

Le të fillojmë me kodimin

Siç e kam menduar tashmë, po ju shkruaj shtesa në internet në Django. Gjurmë Ale tregon se nuk është e nevojshme të punohet. Mund t'ia dilni me një skript bazë Python, megjithëse në këtë rast do të jetë e nevojshme të testoni periodikisht Telegramin me pyetje të reja nga roboti i përdoruesit (metoda Vikory merrni Përditësimet) dhe një kompensim më i madh për të hequr të dhënat e mbetura pa i përsëritur ato. Telegrami ka dy metoda ekskluzive reciproke për marrjen e komandave/njoftime për botin tuaj.

  • Wikoristan në metodën API merrni Përditësimet
  • Instalimi i Webhook

Vendosja e një Webhook përfshin kalimin e një URL të veçantë për robotin në kërkesën e duhur POST sa herë që dëshironi t'i dërgoni mesazhin robotit. Ne do të përdorim pikërisht këtë opsion për ndërveprim midis robotit dhe klientit të tij. Për të vendosur URL-në, duhet të përdorni metodën API setWebhook. Kjo do të thotë që URL-ja mund të fillojë me https, atëherë lidhja SSL me një certifikatë të vlefshme mbrohet. Telegrami ju lejon të përdorni një certifikatë të vetë-nënshkruar, e cila kërkon një metodë setWebhook transferoni gjithashtu çelësin publik në formatin PEM (baza ASCII64). Ose mund ta zgjidhni si Let's Encrypt.

Raportoni rreth merrni Përditësimetі setWebhook mund të lexohet në detaje.

Ok, le të kthehemi te biblioteka e python për robotët me Telegram - telepot. Aktualisht versioni i mbetur është 6.7. Ne e instalojmë atë në mjedisin virtual python virtualenv:

Pip instaloni telepot

Opsioni më i thjeshtë për të bashkëvepruar me një bot Telegram në Python duket kështu:

Importo token telepot = "123456" TelegramBot = telepot.Bot(token) print TelegramBot.getMe()

Rrymës së shkëmbimit i jepet vlera e tokenit të marrë kur bot u krijua nëpërmjet BotFather. Si rezultat, pas futjes së këtyre komandave mund të heqim:

(u"emri i përdoruesit": u"PythonPlanetBot", u"first_name": u"Python Planet Bot", u"id": 199266571)

Une po fluturoj! Kemi klikuar në API-në më të thjeshtë të quajtur getMe, e cila kthen informacione rreth botit: emri i përdoruesit, id, emri i parë.

Shtoni bot-in tonë në listën tuaj të kontakteve dhe dërgojini komandën standarde /start

Kodi Vikonuemo:

TelegramBot.getUpdates() [(u"mesazh": (u"datë": 1459927254, u"tekst": u"/start", u"from": (u"emri i përdoruesit": u"adilkhash", u"emri_first_name ": u"Adil", u"id": 31337), u"message_id": 1, u"chat": (u"emri i përdoruesit": u"adilkhash", u"emri_par": u"Adil", u" type": u"private", u"id": 7350)), u"update_id": 649179764)]

Procesi i lidhjes me një bot telegram kryhet përmes HTTPS; JSON përdoret për transmetim. Metoda merrni Përditësimet rrotullon një listë/arresë objektesh të llojit Update. Në mes të Përditësimit ka një objekt Mesazhi. Për ndërveprim standard me robotin, ne në fakt duhet të krijojmë vetë objektin Message, i cili ka një atribut teksti që ruan tekstin e dërguar në bot dhe objektin e bisedës, i cili përmban informacione për klientin që po fillon bashkimin me robotin tonë Telegram. Ekziston edhe parametri update_id, i cili shërben si parametër offset kur thirret metoda getUpdates. Më pas update_id+1 do të kthejë të gjitha njoftimet që kanë ardhur pas update_id-it të fundit dhe të gjitha njoftimet e mëparshme do të fshihen.

TelegramBot.getUpdates(649179764+1) [(u"mesazh": (u"datë": 1459928527, u"tekst": u"përshëndetje vëlla", u"nga": (u"emri i përdoruesit": u"adilkhash", u"first_name": u"Adil", u"id": 31337), u"message_id": 13, u"chat": (u"emri i përdoruesit: u"adilkhash", u"emri_emri": u"Adil" , u"type": u"private", u"id": 7350)), u"update_id": 649179765)]

Në fazën e shkrimit të botit më të thjeshtë Telegram, kemi mjaft nga këto klikime. Le të fillojmë të shkruajmë programe Django për t'i shërbyer zhvilluesve tanë.

Një funksion i thjeshtë i analizimit të furnizimit RSS të Planet Python duket kështu.

Rritja e Telegram reflektohet kryesisht në praninë e një numri të madh robotësh - robotë të vegjël shërbimi. Ato mund të krijohen nga kozhen koristuvach, i njohur me programet në rajonin e mesëm. Telegram API Bot është një ndërfaqe softuerike që ju lejon të programoni një robot të fuqishëm.

API përfshin objekte dhe komanda të përdorura për të vendosur sjelljen e botit Telegram. Duke përdorur ndërfaqen Vikorist, mund të krijoni kodet tuaja të programit, të cilat, kur lansohen në Telegram, fillojnë të funksionojnë si bots.

Elementet e kontrollit

API Bot Telegram ka të gjithë elementët e kontrollit për objektet, të cilat përfaqësohen në JSON, kështu që duket si një rresht i përcaktuar nga rregullat e këngës. Kjo lejon që shkëmbimi i të dhënave të kryhet sa më shpejt dhe me kosto efektive, pasi nuk është kodi i programit që transferohet, por një grup çiftesh "çelësi: vlera" në pamjen e tekstit. Tabela tregon të gjitha llojet e API-ve. Shumica e objekteve caktohen përpara se të krijohen komandat bot. Çelësat ofrojnë një kuptim më të gjerë të aftësive të objektit.

Emri Përshkrim Çelësat
Përdoruesi Koristuvach në Telegram id
Emri
mbiemri
emri i përdoruesit
Bisedë Bisedë id
lloji
titullin
emri i përdoruesit
Emri
mbiemri
all_members_are_administrators
Mesazh urime mesazh_id
nga
datë
chat
përpara_nga
përpara_data
reply_to_message
teksti
subjektet
audio
dokument
Foto
ngjitëse
video
zëri
mbishkrim
kontakt
vendndodhjen
vendi i zhvillimit
new_chat_amber
la_chat_member
new_chat_title
new_chat_photo
delete_chat_photo
grup_chat_krijuar
supergrupi_chat_created
channel_chat_created
migrate_to_chat_id
migrate_from_chat_id
pinned_message
MessageEntity Realiteti Okrema në mesazhin me tekst (hashtag, mesazh, etj.) lloji
gjatësia
url
kompensuar
Madhësia e fotografisë Një imazh i një madhësie të caktuar ose një pamje paraprake fotografie, skedari ose ngjitësi file_id
gjerësia
lartësia
madhësia e skedarit
Audio Regjistrimi audio file_id
kohëzgjatja
interpretues
titullin
mime_lloji
madhësia e skedarit
Dokumenti Qoftë një skedar, jo një imazh, një regjistrim audio ose një regjistrim zanor file_id
gishtin e madh
emri i skedarit
mime_lloji
madhësia e skedarit
Ngjitëse Ngjitëse file_id
gjerësia
lartësia
gishtin e madh
madhësia e skedarit
Video Regjistrim video file_id
gjerësia
lartësia
kohëzgjatja
gishtin e madh
mime_lloji
madhësia e skedarit
Zëri Njoftimi i Golosovës file_id
kohëzgjatja
mime_lloji
madhësia e skedarit
Kontaktoni Kontakt telefonik Numri i telefonit
Emri
mbiemri
user_id
Vendndodhja Krapka në hartë gjatësia gjeografike
gjerësi gjeografike
Vendi i zhvillimit Objekti në hartë vendndodhjen
titullin
adresë
katror_id
Fotot e profilit të përdoruesit Fotografia e profilit të koristuvach numri_gjithsej
Fotografitë
Skedari Skedari gati për shkarkim file_id
madhësia e skedarit
shtegu i skedarit
ReplyKeyboardMarkup Tastierë me opsione të shumta hyrjeje tastierë
ndryshimi i madhësisë së tastierës
tastierë_one_time
selektive
Butoni i tastierës Butoni i tastierës për zërin teksti
kërkesë_kontakti
kërkesa_vendndodhja
ReplyKeyboardHide Zëvendëson tastierën bot me një tastierë standarde Telegram fsheh_tastierë
selektive
InlineKeyboardMarkup Është instaluar një tastierë që shfaqet te njoftimet tastierë_inline
InlineKeyboard Button Një buton në tastierën e re teksti
url
kthimi_të dhënat
switch_inline_query
switch_inline_query_current_chat
kthimi_lojës
CallbackQuery Hyrja do të japë sinjalin e kthimit të thirrjes për butonin e hyrjes nga parametri i specifikuar callback_data id
nga
mesazh
inline_message_id
të dhëna
ForceReply Kjo është ajo që bën klienti: zgjidhni një njoftim dhe shtypni butonin "Raporto". forcë_përgjigje
selektive
Parametrat e përgjigjes Tregon pse kërkesa nuk ishte e suksesshme migrate_to_chat_id
riprovo_pas

Rreshtat që rezultojnë që fuqitë e mesazherit janë paraqitur në formën e objekteve API.

Mesazhet shkëmbehen si kërkesa. Në pikat poshtë tabelës ka shembuj të veprimeve prej tyre.

Të gjitha metodat (dhe ka shumë prej tyre) ndahen në grupe:

  1. Refuzoni të përditësoni informacionin.
  2. Puna e bisedës.
  3. Forcimi i elementeve të ndryshëm.
  4. Puna me ngjitëse.
  5. Përditësimi do të shpallet.
  6. Modaliteti në linjë.
  7. Funksionaliteti i pagesës.
  8. Për igorin.

Nuk ka ende një dokumentacion të plotë për API-në ruse të Telegram Bot. Sidoqoftë, përkthimi standard në shfletuesin Google Chrome i përballon mrekullisht detyrat.

Programimi i filmave

Telegram API mbështet programimin pa njerëz. Kjo i jep autorit lirinë për të zgjedhur.

Dashamirët e JavaScript mund të kontrollojnë API-në e Bot Telegram Node.js. Këtu ju duhet të dini se si të flisni gjuhën dhe të punoni me zgjuarsi me këtë kornizë, duke e shndërruar gjuhën e klientit në një ndërfaqe të plotë të serverit.

Një nga më të njohurit për të shkruar bot në Telegram Bot API është PHP. Kjo gjuhë është menduar kryesisht për krijimin e shtesave në ueb nga ana e serverit. Kjo vihet në pah nga thjeshtësia, logjika dhe specializimi i vetë mjedisit të internetit.

Telegram Bot API në Python shpesh vikorizohet. Kjo gjuhë dallohet nga minimalizmi dhe është mjaft e thjeshtë për t'u përdorur në mjekësi. Ai tashmë është popullor për shkak të produktivitetit të tij.
Klasikja është Telegram Bot API C++. Gjuha nuk mund të quhet kohë boshe, por është baza mbi të cilën u krijuan të gjitha ndryshimet e tjera të gjuhës. Mesa duket në asnjë prej tyre nuk ka asnjë specializim kantoje. Mjetet ju lejojnë të krijoni programe.

Vikoristanny prapanicë

API përmban një sërë metodash që ju lejojnë të përmirësoni njoftimet, skedarët, ngjitësit e fotografive, modifikoni dhe shumë më tepër. Të gjitha këto komanda mund të gjenden në përshkrimin e API në faqen zyrtare të internetit.

Për krijimin në Telegram ekziston një shërbim i veçantë @Botfather. Shkoni te ai i ri dhe shkruani komandat që do t'ju ndihmojnë të krijoni një robot të ri. Shtypni menjëherë komandën /newbot. Pastaj futni në mënyrë sekuenciale emrat për tregtarët dhe emrin. Do të përfundojë patjetër me "bot". Pasi ju dërgon një token (identifikues), krijohet një bot i ri. Autorizimi realizohet përmes një token. Për të nisur programin në Telegram, gjeni fëmijën tuaj dhe klikoni butonin "Start". Pastaj ekzekutoni komandën / start. Komandat / cilësimet dhe /help janë gjithashtu të rezervuara për robotin e lëkurës.

Gjithçka duket si:

http://api.telegram.org/bot /EKIPI

Të gjithë dimë 4 mënyra për të pyetur:

  1. Futni në URL
  2. aplikacioni/x-www-form-urlencoded
  3. aplikacion/json (jo i përshtatshëm për importimin e skedarëve)
  4. të dhëna me shumë pjesë/forma (për ruajtjen e skedarëve)

Në dispozicion si kërkesa GET dhe POST.

Mënyra më e lehtë për të provuar komandat API është në shiritin e adresave të shfletuesit tuaj. Hyni në robot tuaj nga versioni në internet ose nga një pajisje celulare. Pastaj shkruani komandën në shfletuesin tuaj:

https://api.telegram.org/bot507226896:AAGT_fsEfg1milOkqbNp-VolQDJ0tGjaPvD7/getUpdates

Si rezultat, dritarja do të shfaqë një sekuencë JSON

("ok":true,"rezultat":[("update_id":231886689,
"message":("message_id":3,"from":("id":391911270,"is_bot":false,"first_name":"Irina","last_name":"12345678","kodi_gjuhës":"uk "),,"chat":("id":391911270,"first_name":"Irina","last_name":"12345678","type:"private"),"date":1514900431,"tekst": " \u044b\u0443\u0442\u0430\u043e\u0430\u043c\"))])

Biseda me parametra":("id – ky është identifikuesi i bisedës. Më pas futni rreshtin:

https://api.telegram.org/ bot507226896:AAGT_fsEfg1milOkqbNp-VolQDJ0tGjaPvD7/sendMessage?chat_id=391911270&text=Përshëndetje

Shfletuesi do të tregojë një rresht

("ok":true,"rezultat":("message_id":4,"nga":("id":507226896,"is_bot":true,"first_name":"Anna","username":"Annatuola_bot" ),"chat":("id":391911270,"first_name":"Irina","last_name":"12345678","type":"private"),"date":1514900499,"text":"Përshëndetje "))

Dhe në bisedën Telegram do të merrni privatësi nga roboti i krijuar.

Siç e dini, krijimi i një elementi të ri për telegramet nga e para nuk është i lehtë. Problemet fillojnë në momentin e programimit, siç është e dukshme në artikuj të tjerë.

  • Tutorial

Chatbots janë një temë e mrekullueshme që tërheq si entuziastët e geek-ve ashtu edhe kompanitë që duan të organizojnë ndërveprime me klientët e tyre në mënyrën më të përshtatshme për ta.


Sot do t'ju përshkruaj një shembull të thjeshtë të një roboti Telegram të krijuar duke përdorur një platformë wiki për krijimin e ndërfaqeve fleksibël API.AI, i cili është i dobishëm për motin. Këtu, unë ndjek këto udhëzime, në praktikë reale, nuk mund të kufizoheni nga moti dhe të zbatoni ndërfaqe
për promovim dhe shitje të automatizuar.

Krok së pari: Përgatitja e infrastrukturës.

Në këtë rast, ne do të fitojmë pa bot Telegram dhe API.AI, shërbimi do të ofendohet pa kosto - do të privohemi nga krijimi i regjistrave të cloud.

Krijo një bot Telegram

Për të krijuar një bot, thjesht shkruani @BotFather (ky është lloji i botit që mund të krijojë dhe konfigurojë robotë të tjerë):

  1. Dërgoni komandën /newbot - kështu informojmë @BotFather se na duhet një bot i ri
  2. Tani @BotFather na kërkoni të emërojmë robotin e ri. Këto janë tonat
    Mayday koristuvachs, ai emër duhet dhënë me mençuri dhe thjesht.
  3. Shkurtorja e mbetur tregohet për emrin e përdoruesit të robotit, i cili në fund kërkohet
    shkruani "bot".
  4. Nëse nuk përdorni emrin e përdoruesit, njoftimet e konfirmimit dhe shenjat e hyrjes do të hiqen.

Për ta bërë më të qartë, më poshtë është një pamje e ekranit me të gjitha veprimet:

Pak teori

Ka ardhur koha për të krijuar një agjent API.AI, i cili është ose një projekt ose një kontejner (siç preferoni ta quani). Agjenti do të rregullojë kontekstet, esencat dhe llojet:

  • "kontekst" (qëllimi) shfaq lidhjen ndërmjet këtyre, çfarë tha koristuvach?і
    Tim Çfarë mund të fitoni nga programi ynë?
  • "entitete"- ky mjet përdoret për të marrë vlerat e parametrave për
    programet tona nga gjuha natyrore (duke thënë dhe shkruar
    koristuvach)
  • llojet” – ky është rezultati përfundimtar i punës së programit tonë, të cilin ne
    ne detyrojmë koristuvaçevën t'ju informojë

Ka gjithashtu informacion të mjaftueshëm nga dialogu i rrjedhës për llojin e korrespondencës, në mënyrë që të dhënat statike të mund të rregullohen llojet V kontekstet. Në fakt, për të rikuperuar një lloj shërbimi specifik, mund të na duhet një shërbim i jashtëm ose logjika jonë e biznesit, për shembull, për të tërhequr informacione rreth motit për nesër, duhet të thërrasim peshën API të shërbimit të jashtëm Më vonë, unë do t'ju them të hiqni informacionin nga sistemet e jashtme përpara se të përgatisim fillimisht bazën e të dhënave.

Krijo një projekt me API.AI

Për t'u regjistruar me API.AI, do t'ju duhet një rekord llogarie Google (thjesht duhet ta shtoni atë në llogarinë tuaj Gmail). Tani shkoni në adresën https://api.ai/, klikoni butonin "REGJISTROHU FALAS" dhe më pas zgjidhni hyrjen e llogarisë nën emrin e së cilës dëshironi të identifikoheni.


Tani le të kalojmë në krijimin e vetë agjentit. Klikoni në "Krijo agjent" dhe zgjidhni të paktën emrin, gjuhën dhe zonën kohore.


Krok është ndryshe: Trajnoni agjentin.

Konteksti krijon lidhje midis asaj që duket të jetë fitimprurëse dhe asaj që mund të fitojë agjenti ynë. Le të hedhim një vështrim në parashikimin e motit me parashikimin: prisni një minutë:


  1. Klikoni në seksionin "Konteksti". Agjenti ka rregulluar tashmë "kontekstet" për zbatimin dhe amendamentet dhe do t'i lërë ato për momentin pa ndryshim.
  2. Jepni emrin për "kontekstin" - në mënyrë që të jetë e qartë për ju dhe kolegët tuaj.
  3. Në seksionin "Përdoruesi thotë", vendosni informacionin për mikun tuaj. Për sa kohë që po flasim për motin, njerëzit mund të vënë energjinë në lidhje deri në orën e duhur që ai vend të jetë. Sa më shumë aplikacione të jepni në cilësime, aq më saktë do të funksionojë agjenti. Unë kam treguar disa shembuj në pamjet e ekranit:


Në rastin tjetër, fjalët "nesër" dhe "Nizhny Tagil" theksohen me ngjyra të ndryshme - në këtë mënyrë fjalët lidhen me thelbin ( Subjektet) (për mendimin tonë, thelbi është sistemik). Parametrat e Vikorist, agjenti i "ndjeshmërisë" në cilin vend dhe për cilën datë është e nevojshme të kontrollohet moti.


Shtoni disa bashkëngjitje të tjera dhe klikoni "RUAJ".

Duke testuar!

Le të kontrollojmë robotin e agjentit në terma të thjeshtë, për shembull, "Moti afër Perm të mërkurën":



Gjatë gjithë orës, mesazhi "Provojeni tani" shfaqet në pjesën e sipërme të djathtë të ekranit - shkruani në këtë fushë ose thjesht shkruani për motin dhe klikoni "Hyrje".


Ne nuk kemi vendosur ende transmetime automatike, por agjenti tashmë ka mësuar të vendosë parametrat! Seksioni INTENT tregon se çfarë moti qëndron pas "mendimit" të agjentit ("konteksti" i humorit) dhe PARAMETRI tregon datën dhe emrin e vendit të ndryshimeve të tjera.

Shto furnizime automatike

Le të vrasim agjentin tonë! Nuk kemi mësuar ende të nxjerrim informacione për motin nga ngjarjet aktuale të motit, ndoshta si një formë frazash të thjeshta.


Shkoni te seksioni "Përgjigje" dhe futni përgjigjet e thjeshta në të njëjtën mënyrë si më parë të futni "Përgjigjet nga një korrespondent":



Ndërsa po lexoni, mund të zgjidhni mesazhet mbi temën, të filloni të shkruani $ dhe ndërfaqja do t'ju kërkojë të zgjidhni një vlerë specifike.


Kur formohet një lloj, agjenti përmban një sërë substancash thelbësore dhe lloje jo-vikoristike, për të cilat nuk ka të dhëna të mjaftueshme. Për shembull, kur pyetet pa specifikuar një vend, agjenti merr një konfirmim nga një rresht tjetër.


Ruani cilësimet dhe rishikoni sërish:



Tani kemi një tjetër konfirmim!

Mësimi i tretë: Shto shërbim të jashtëm.

Agjenti ynë tashmë po “kupton” në disa raste korrespondentët që duan të dinë motin, në cilën datë dhe në cilin vend. Tani nuk mund t'i marr më të dhënat nga shërbimi telefonik dhe t'i transferoj ato te agjenti. Për këtë ju duhet të shkruani disa skripta në JS dhe t'i vendosni ato në një shërbim të mirë, versioni ynë - Google Cloud Project.

Krijoni një skedar JS fillestar

Për të filluar, krijoni dhe shkoni te drejtoria me emrin e projektit tuaj:

    Linux ose Mac OS X:


    mkdir ~/
    cd ~/


    mkdir %HOMEPATH%
    cd %HOMEPATH%

Tani krijoni skedarin index.js me këtë ndryshim:


kodi index.js

/* * Funksioni i resë kompjuterike HTTP. * * @param (Objekt) req kontekstin e kërkesës së funksionit të resë kompjuterike. * @param (Object) res konteksti i përgjigjes së funksionit të resë kompjuterike. */ exports.itsm365Weather = funksion itsm365Weather (kërkesa, res) ( përgjigja = "Ky është rezultati i grepës tuaj në internet!" //Përgjigja e parazgjedhur nga uebhook për ta shfaqur"working res.setHeader("Content-Type", "application / json"); //Kërkon aplikacion/json lloji MIME res.send(JSON.stringify(( "fjalim": përgjigje, "displayText": përgjigja //"fjalim" është versioni i folur i përgjigjes, "displayText" është versioni vizual)));

Personalizo Projektin Google Cloud

  • Melodi Vikonite “Para teje
    filloni” 1 deri në 5 pikë
  • Aktivizo funksionin në hmaria duke u identifikuar në tastierë:


    Funksioni beta i gcloud vendos itsm365Weather --stage-bucket --trigger-http

de, itsm365Weather - emri i funksionit dhe - emri i mekanizmit
homazhe për projektin.


Pasi të përfundojë operacioni, ju do të merrni rezultatin nga URL-ja e nxitjes http:


Fshih Webhook në API.AI

  1. Shkoni te çdo agjent që ju nevojitet dhe më pas klikoni " Përmbushja” në menunë e majtë.
  2. Klikoni në ikonën Webhook në krye të djathtë të ekranit.
  3. Futni URL-në që keni zgjedhur në hapin e mëparshëm.
  4. Kurseni paratë tuaja.

Aktivizo funksionet e reja në "kontekst" të rregulluar

  1. Shkoni te parashikimi i motit "kontekst".
  2. Djeg bllokun Përmbushja në fund të faqes
  3. Kontrolloni kutinë "Vikoristuvati Webhook"
  4. Ruani rregullimet dhe ktheni rezultatin:

Ndrysho API-në për ta paraqitur më vonë

Për lehtësinë e aksesit, shërbimi WWO (World Weather Online) kërkon që ju të merrni një çelës API (thjesht regjistrohuni përmes Facebook ose Github).


Përditësoni kodin e skedarit fillestar JS, duke mos harruar të futni çelësin API për nxjerrjen e informacionit të motit:


Kodi i daljes për shërbimin për gjenerimin e parashikimeve të motit

// E drejta e autorit 2017, Google, Inc. // Licencuar sipas licencës Apache, Version 2.0 ("Licenca"); // Ju nuk mund ta vikorizoni këtë skedar përveçse në përputhje me Licencën. // Ju mund t'i shikoni imazhet në faqen e internetit // // http://www.apache.org/licenses/LICENSE-2.0 // // Kërkesa e panevojshme në ligjin në fuqi ose e vendosur në njoftimin, softueri // i shpërndarë nën Licenca shtrihet në të gjitha BAZËT "SIÇ ËSHTË", // PA GARANCI OSE KUSHTE TË NDONJË LLOJI, eterexpress ose të nënkuptuar. // Klikoni mbi Licencën për lejet dhe // kufizimet specifike të qeverisjes së gjuhës sipas Licencës. "përdor strikte"; const http = kërkoj ("http"); const host = "api.worldweatheronline.com"; const wwoApiKey = "98cfb8e40ecc47c4a2f205209172608"; exports.itsm365Weather = (req, res) => ( // Merr qytetin dhe të dhënat nga kërkesa le city = req.body.result.parameters["geo-city"]; // qyteti kërkohet param // Merr datën për parashikimin e motit (nëse është i pranishëm) let date = "" ("Data: " + data ) // Thirrni API-në e motit callWeatherApi(qytet, datë).pastaj ((dalje) => ( // Kthejeni rezultatet e API-së së motit; te API.AI res.setHeader("Content -Type", "application/json" është gabim që përdoruesi e di res.setHeader("Content-Type", "application/json"); fjalimi": gabim, "displayText": gabim ))); funksioni callWeatherApi (qyteti, data) ( kthimi i premtimit të ri((zgjidh, refuzo) => ( // Krijo shtegun për kërkesën HTTP për të marrë shtegun e lejes së motit = "/premium/v1/weather.ashx?format=json&num_of_days= 1" + "&q=" + encodeURIcomponent(qytet) + "&key=" + wwoApiKey + "&date=" + data + "&lang=ru" console.log ("Kërkesë API: " + host + shteg // Bëni kërkesën HTTP për të marrë motin http.get((host: host, path: path), (res) => (let body = ""); // var për të ruajtur pjesët e përgjigjes res.on ("të dhëna", (d) => (trup += d; )); = JSON.parse(trup); let forecast = përgjigje["të dhëna"]["moti"]; "]; temperatura varion nga $(parashikimi["mintempC"])°C deri në $(parashikimi["maxtempC"])°C. `; // Zgjidheni premtimin me konsolën e tekstit të daljes.log(output); zgjidh ( output res.on("gabim", (gabim) => (refuzo(gabim); ));


Do të rindez funksionin e projektit të zymtë.

Croc of quarters: rregullimi i mirë i dialogut

Kur ndërveprojmë me korrespondentin, nuk mund të pritet që ne të na ofrojmë të gjithë informacionin e nevojshëm për të përgatitur një përgjigje për ofruesin tonë të shërbimit sa më shpejt të jetë e mundur. Për të krijuar një parashikim, shërbimi ynë ka nevojë për një datë dhe vend. Meqenëse data nuk dihet, mund të supozojmë me sukses se koristuvaçi respektohet "sot", por vendin mund ta njohim vetëm nga vetë koristuvaçi.

Punoni "rostashuvannya" me parametrin musculoskeletal


Hapni kontekstin "Parashikimi i motit" dhe zgjidhni parametrin gjeo-qytet për ta përfunduar atë. Pastaj kontrolloni informacionin më të detajuar ushqimor në kolonën "Kërkesat".


Ruani rregullimet dhe ndryshoni sjelljen e agjentit duke e vendosur atë në një furnizim të thjeshtë "moti" me energji elektrike:



Agjenti na dha informacion më të saktë, tastiera shfaq parametrat e transmetimit
situatave.

Krijo një sqarim të asaj që po kthehet, për riformësimin

Për të korrigjuar të dhënat e mbledhura në fazat e avancuara të ndërveprimit me klientin, do t'ju duhet të rregulloni sqarimet e mëposhtme.



Kur vendosni kontekstin e "parashikimit të motit", vendosni emrin e specifikimit "lokacioni" në fushën "Shto kontekstin e daljes", e cila do të rrotullohet dhe ruani cilësimet.

Krijo një kontekst të ri për sqarim

Është e dobishme, nëse mund të vendosni një tenxhere me ushqim në të njëjtin plan urbanistik, pa pasur nevojë të sqaroni me blerësin se cili vend është në linjë. Ju keni bërë tashmë disa sqarime se si mund ta përdorni vikoristin për të përpunuar sqarimet e ushqimit.


  1. Krijo një kontekst të ri për një seksion Synimet ose klikoni në ikonën në rresht
    Synimet menuja e majtë që shfaqet.
  2. Emërtoni kontekstin e ri "Përditësim i motit" (ose ndoshta dikush tjetër e ka kuptuar emrin).
  3. Cakto detajet e hyrjes dhe daljes si "vendndodhja"
  4. Shtoni disa vërejtje nga Koristuvach, për shembull, Çfarë është në raft nesër
  5. Shtoni një parametër dimensioni me vlerat e mëposhtme:
    - Emri i parametrit:
    gjeo-qytet
    - Vlera:#lokacioni.gjeo-qytet
  6. Shtoni një konfirmim për korrespondentin në "seksionin" Përgjigje”:
    - Vibach, por nuk mund të llogaris parashikimin për $date-period në #location.geo-city
  7. Hiq vikoristannya uebgrep në meny Përmbushja.
  8. Ruani cilësimet dhe provoni në tastierë:

Krok i të pestave: situata Privitannya dhe obrabotka nepredbachennyh

Bërthama kryesore e agjentit është gati, tani është keq të punosh si robot
Duke përshëndetur infermieren dhe duke ditur gjithashtu se çfarë të presësh nga ushqimi i pafurnizuar.

Vendosni linjat tuaja "prapa-momenti" për të mos u mbingarkuar nga situata

Nëse dëshironi të vendosni ushqim të papërgatitur (në rastin tonë - jo për motin), agjenti duhet të përfshijë një kontekst që roboti të përpunojë situata të papërgatitura ( Synimi i parazgjedhur i kthimit):



Shkoni te konteksti i rregulluar, rregulloni variantet tuaja të raporteve sipas nevojës.

Rregulloni kontekstin e privatësisë suaj

Privatësia mund të rregullohet në një mënyrë të ngjashme për përmbajtjen e lidhur -
Synimi i parazgjedhur i mirëseardhjes


Krok gjashtëdhjetë: lësho bot

Lidhni robotin e Telegram me agjentin

Shkoni te cilësimet "Integrimet" dhe zgjidhni robotin nga seksioni
"Integrimet me një klikim":



Kopjo nga fusha "Telegram token" tokenin që ke marrë nga @botFather
shtypni START.

Kthejeni robotin robot

Shkoni te boti juaj dhe përpiquni të shkruani atë që dëshironi, sipas mendimit tim
@itsm365_weather_bot (Isha i interesuar për llogaritë pa mace, por pas 500 kërkesave në ditë, boti do të kthehet në një shalqi).


Visnovok

API.AI tani mund të përdoret për të krijuar ndërfaqe dialogu në mesazhe, për të mbështetur bisedat dhe rrjetet sociale. Fakti është se mjeti mund të integrohet lehtësisht me shërbimet tuaja - ky është një mjet i shkëlqyeshëm për automatizimin e komunikimit me klientët tuaj.


P.S. Ky është postimi im i parë, do t'ju falënderoj për komentet tuaja konstruktive!

Etiketa:

  • api.ai
  • telegram
  • botet e telegramit
Shto etiketa

shtesë Telegrami Mund të mburremi sinqerisht për bazën e re, absolutisht unike për krijimin e robotëve. Megjithëse platforma e robotëve është çmontuar që nga fillimi i verës (prezantimi u mbajt më 24 qershor), vetëm një pjesë e vogël e zhvilluesve të jashtëm aktivë filluan të lustrojnë dhe shpërbëjnë programet e energjisë. Sot bot është një asistent i domosdoshëm për Telegrami, i cili gjithashtu ndihmon në krijimin e lidhjeve me serverët me fuqi TelegramBot API. Sigurisht, vetë procesi i drejtimit robotik mbi kafshën URL Nga parametrat e specifikuar, pas së cilës shfaqet Telegram JSON- Kjo është historia. Le të shkojmë në sallën e ushqimit dhe t'i hedhim një sy prapanicës së robotit të krijuar (të një lloji të parëndësishëm).

Procedura për regjistrimin e një programi (bot)

Përpara se të mund të printoni drejtpërdrejt robotin e shkarkuar në ndërfaqen e backend-it dhe bisedën, duhet të futni kodin tuaj personal (lloji id), i cili është një shenjë unike e personalizuar. Për të kryer këtë operacion, duhet të dërgoni një kërkesë te një bot specifik. @BotFather.

Për të kryer këtë operacion, është e nevojshme të ndiqni algoritmin e mëposhtëm:

  • Ne shkruajmë mesazhe me tekst me informacion mbi temat e mëposhtme " filloni»;
  • Pas kësaj, transferimi i të gjitha komandave dhe funksioneve të mundshme opsionale eliminohet;
  • Më pas ne dërgojmë njoftime me tekst te boti newbot" Dhe pas komandës hyrëse të botit kryesor, mund të shihni pseudonimin e botit tuaj (një mendje: ka një prapashtesë/parashtesë në emër " bot»);
  • Nëse të gjitha rregullat janë në përputhje me rregullat, atëherë roboti aktual do të shohë kërkesën tuaj dhe do t'ju dërgojë leje (do t'ju duhet të shtoni botin e krijuar në listën tuaj të kontakteve).

Në parim, deri në këtë pikë ju tashmë mund të nisni robotin ose, në pjesën më të madhe, mund të krijoni një njoftim të detajuar për përdoruesit e ardhshëm dhe një përshkrim të robotit. Ndoshta, nëse doni të impresiononi një audiencë të vetme me një këngë, mund të shtoni një përbërje ose imazh harmonik muzikor. Është e rëndësishme: ju lutemi kontrolloni veçantinë dhe origjinalitetin e tokenit tuaj duke shkuar në adresë. (api.telegram.org/bot/getMe). Procesi i programimit bot

Bëni robotët e krijuar në modalitet Python3 Sidoqoftë, për shkak të progresivitetit të teknologjive të TI-së, mund të përdorni shpejt ose modalitetin manual ose bazë. Cilësimet e telegramit për njoftimet automatike, është më mirë të krijoni kaos konfidencialiteti, i cili do të përshpejtojë ndjeshëm procesin e shkarkimit të njoftimeve me tekst (më të zakonshmet dhe të ndenjura tornado.web.). Lëreni që pjesa e kornizës së robotit të shfaqet në frazën e këngës (është më logjike të zëvendësohet ajo që përfaqëson informacionin nga jashtë robotit të programuar). Përpara se të nisni robotin, duhet të përfundoni procedurën e aktivizimit WebHook me lokalizimin në adresën tuaj. Më pas, vendoset sinjali i alarmit (dalja në 6) dhe shfaqet treguesi i hapave/veprimeve që janë duke u zgjedhur.

  • fjalori;
  • veçori funksionale e llojeve tekstuale mbizotëruese (mbifuqishme);
  • derdhur informoj.

Pasi të keni futur të gjitha nuancat në logjikën e robotit, duhet të filloni të zhvilloni komandat kryesore që përdor programi juaj.

Krijimi i ekipeve

Sipas rregullave të programit Telegram, një bot absolutisht inteligjent (pavarësisht nga specifikat, popullariteti dhe popullariteti) kërkohet për t'iu përgjigjur 2 komandave:

  • Filloni;
  • Ndihmë.

p align="justify"> Komanda e parë u krijua për të identifikuar robotin dhe jo për të rishikuar informacionin e ruajtur. Më shpesh, kjo procedurë është e lidhur ngushtë me procedurën e autorizimit për çdo program.

Ekipi " Ndihmë ka për qëllim shfaqjen e parametrave kryesorë të botit, karakteristikat e tij specifike, veçoritë dhe komandat.

Për krijimin e komandave, boti kryesor është një asistent i domosdoshëm @BotFather e cila do t'ju ndihmojë të krijoni transferimin e nevojshëm dhe të nevojshëm të komandave për klasifikimin tuaj.

Zagalnist

Tashmë keni vënë re se programi Telegram ofron informacion absolutisht të plotë dhe kuptimplotë në një nivel shqisor, pa i ndarë ato në pjesë boshe. Kjo është për shkak të mundësisë së programimit të botit tuaj për të lexuar fjalimin njerëzor (njohja e zërit). Paralajmërimi i vetëm është se roboti "baby" do të jetë i disponueshëm vetëm në mesazhe private, sepse në chat kjo veçori nuk është e mundur. Për të filluar procesin e "të folurit" të robotit, kryhen një sërë operacionesh lidhëse:

  • Mesazhi me tekst "setprivacy" në @BotFather zbatohet;
  • kaloni në privatësi;
  • Kur transferoni komanda, shtohet opsioni "pseudo-gjuhë".

Së fundmi, roboti mund të njoftojë me zë dhe të ofrojë informacion në modalitetin zanor.

Aspektet dhe mundësitë e medias

Bot-et nuk janë shumë të ndryshëm nga mesazherët realë të Telegramit, por ato gjithashtu mund të jenë në gjendje të përplasen me fotografi të rastësishme, skedarë muzikorë, video dhe ngjitëse.

Për të anuluar paketën e ngjitëseve, duhet të dërgoni një mesazh me tekst. at_sticker» dhe kryeni modifikimin e parametrave dërgo_përgjigje. Në këtë mënyrë, pranë tekstit, roboti juaj do të shtojë ngjitëse dixhitale dhe do të shfaqë treguesit e orës.

Potenciali

Për platformë shtesë të besueshme API, robotët mund të bëhen ndihmës të domosdoshëm dhe bazë për automatizimin e procesit, duke formuar kuize, sondazhe, konkurse dhe raportime. Theksi kryesor mund të vendoset në specifikat e CTF, DozoR.

Korniza

Kornizat e sotme të vështira për vikoristanin WebHook. Në të djathtë është se funksionon vetëm në bazë të https (subjekt i një certifikate të vlefshme). Asnjë shitës me pakicë lëkure nuk ka një certifikatë të vlefshme. Dhe arsyeja është se ka mbështetje të përditshme nga DPR. Megjithatë, është e qartë se modaliteti manual është në Telegrami, është e mundur të dalloni kodet dhe shërbimet e të dhënave të qarta nga ato të cilave u është përshtatur programi juaj, në mënyrë që të shkarkohet dhe të përcillet në adresat lokale.

Materiale të tjera rreth robotëve të Telegram:

  • Robot Anton - robotë në Telegram
  • Mundësitë e zhvilluesve të api Telegram
  • Telegrami Boti
  • Telegram 3.0 ka funksionin e lëshimit të boteve me ngjyra.