Telegram — AiHummer Dokumendid

Telegram on AiHummeri tootmistaseme, soovitatud esimene kanal. See on kõige kiirem viis saada toimiv agent tõeliste inimeste ette: loo bot koos @BotFather, anna ühendajale sõlm, ja sissetulevad sõnumid hakkavad voolama väravapunkti.

Telegrami ühendus paigaldatakse tootesisese kaudu Turg ja konfigureeritud administraatori liideses. See töötab hosti-loomulikult ja suhtleb väravat üle sissetuleva API, nii et see skaleerub ja taaskäivitub pöörlemismootorist sõltumatult.

Ühenda Telegram kuues etapis

Siin on lõplik tee nullist kuni botini, mis vastab sulle Telegramis. Kõik, mida vajad, on Telegrami konto ja juurdepääs oma AiHummeri veebihaldusliidesele.

Loo bot BotFatheriga. Ava Telegramis @BotFather, saada /newbot, ja määrake boti nimi ja kasutajanimi. Mida sa näed: BotFather tagastab märk meeldima 123456789:AA… — see on boti ligipääsu võti, kopeeri see.
Paigalda Telegrami pistikprogramm. Ava administraatori kasutajaliideses Pistikprogrammid/Turg, leia Telegrami ühendaja kataloogi ja klõpsake „Installi“. Oodake, kuni kaart muutub „võrguühenduseks“ (paigaldamine edusammude riba kuvatakse).
Kleebi märgis. Mine sellele Kanalid ekraan → Konfigureeri paigaldatud kanalid blokeeri, ava Telegrami kaart ja kleebi boti märge ühendaja vormist väljale. Salvesta.
Loo agent (kui sul seda veel pole) — vaata Agendid: nimi ja süsteemi päring on piisavad.
Seosta agent kanaliga. Peal Kanalid ekraanil Sidemed plokk, vali üks vaikeseade agent Telegrami jaoks — see reegel “uusi Telegrami vestlusi juhib agent Y”. Valik salvestub koheselt.
Saada sõnum robotile. Ava oma bot Telegramis ja saada talle sõnum. Mis näed: esindaja vastab vestluses ja sobiv vestlus ilmub admini kasutajaliidese ekraanil „Sessioonid”.

[!NOTE] Vaikimisi vastab agent ainult teadaolevad kasutajad (inimesed registreerunud AiHummer). Kui bot jääb teie sõnumile vaikima — lisage end lihtsalt kui nt kasutaja, või lülitage välja “Vasta ainult tuntud kasutajatele” Kanalid ekraan.

Miks alustada Telegramiga

Telegramil on kõige vähem hõõrdumist kõigist AiHummeri kanalitest: pole operaatorit, pole OAuth-i nõusolekuekraani, pole rakenduse ülevaatust. Sõnumite saatmiseks ja vastuvõtmiseks piisab botitemplit, ja sama ühendaja katab nii sisemised töötajate jututoad kui ka klientidele suunatud botid. Kuna see on tootmisvalmis ja täielikult kasutatud, on see kanal, mida me soovitame teil esimesena ühendada, kui hindate AiHummerit.

Puurimine või veebikonks

Liides toetab mõlemat andmete sissetoomise režiimi, nii et see töötab olenemata sellest, kas teie värav on avaliku interneti kaudu kättesaadav.

Pikk päring — ühendaja tõmbab värskendusi Telegramist. Sissetulevat porti pole või TLS on vajalik, mis teeb selle ideaalseks kohalikuks arenduseks ja privaatseks võrgud.
Veebikonks — Telegram saadab värskendusi avalikku HTTPS-aadressi. Madalam latentsus ja paremini sobib tootmiseks pöördproksiga, mis lõpetab TLS-i.

Konnektor kuulab aadressil port 8800 tavapärases juurutuses või 8091 kohalikuks jooksuks. Iga sissetulev sõnum postitatakse pääsupunkti URL-ile, mis on seadistatud AIHUMMER_INBOUND_URL, autentitud ühise sissetuleva saladusega.

Rikkad sõnumid, sõnumi reaktsioonid ja küsitlused

Lihtsast tekstist kaugemale, kuvab Telegrami kanal Rikkalikud sõnumid — vormindatud vastused, mis kaardistavad agendi struktureeritud väljundi Telegrami natiivsete sõnumifunktsioonide peale. See toetab ka sõnumi reaktsioonid ja küsitlused, nii et agent saab reageerida kasutaja sõnumile või panna jututoas kiire küsitluse peale ühe käigu osana.

[!TIP] Telegram on kanal, mis on AiHummerile identifitseeritud kui telegram. Kasuta seda kanalit ID, kui seote agendi või filtreerite vestlusi allika järgi.

Bot-botiga koos silmusekaitsjaga

Agendid saavad rääkida teiste robotitega. Selle turvaliseks muutmiseks tarnib ühendaja tsükli kaitse: see tuvastab ja katkestab jooksik-botidevahelised vahetused enne, kui need muutuvad lõpmatuks ping-pongiks. See võimaldab teil koostada mitme-botiga töövooge ilma klassikalise tagasisidetsükli rikke režiimita.

Salajane vahendamine OIDC kaudu

Boti märgendeid ja teisi ühenduse saladusi ei kodeerita teenuses kunagi kõvakodeeritult. Selle asemel hangib ühendus need jooksvalt Salateenistus OIDC kaudu — see autentib, seejärel hangib vajalikke mandaate. Saladused jäävad krüpteeritud seifi ning ei satu konfiguratsioonifailidesse ega protsessi argumentidesse.

[!NOTE] Sissetulevad sõnumid postitatakse aadressile AIHUMMER_INBOUND_URL ja kinnitatud jagatud HMAC sissetulev saladus (AIHUMMER_INBOUND_SECRET). Ühenduspunktil peab olema vaikimisi tööruum on seadistatud nende saatmiseks.

Kui see ei töötanud

Telegrami ühendaja ei ole lehel „Kanalid” — paigalda see esmalt see Pistikprogrammid/Turg ekraan; kuni paigaldatakse kanal ei ole näidatud. Ainult Kogukonna plaanil on saadaval Telegram; ülejäänud vajavad uuendust (HTTP 402).
Bot ei vasta — kontrolli: (1) et võti on õigesti kleepitud ja Telegrammi kaart on “veebis”; (2) kanal on seotud agendiga “Seostustes”; (3) saatja on süsteemis registreeritud (vaikimisi vastab agent ainult tuntud kasutajad).
Vastused näivad olevat malli järgi — näidisjuhend on tõenäoliselt endiselt aktiivne; ühenda teenusepakkuja on Mudelid leht.
“Luba puudub” / märgend lükati tagasi — märgend on vale või tühistatud; genereeri uus koos @BotFather (/token) ja kleepige see uuesti.
Veebikonks ei jõua kohale — webhook-režiimis peab värav olema kättesaadav aadressil avalik HTTPS URL; privaatvõrgus kasuta pikaajalist päringut, mis ei vaja sissetulevat ühendust port või TLS.

Kuhu järgmine

Võrdle kanaleid selles MAX, Bitrix24 ja SIP telefon juhendid.
Seosed ja juurdepääsu seadistamine — Kanalid.
Mittesõnumiallikate puhul vaata Üldine sissetulev.
Rakenduse loomiseks API vastu? Vaata vestlus/valmimised.