AiHummer
Suomi▾
Kirjaudu sisäänTili
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanavat/Telegram

Telegram

v1.0.x · päivitetty 2026-06-26

Telegram on AiHummerin tuotantotason, suositeltu ensimmäinen kanava. Se on nopein tapa saada toimiva agentti oikeiden ihmisten eteen: luo botti käyttämällä @BotFather, anna liittimelle tunnus, ja saapuvat viestit alkavat virrata porttiin.

Telegram-liitin asennetaan tuotteen sisäisestä valikosta Markkinapaikka ja määritetty hallintaliittymässä. Se toimii isäntäkohtaisesti ja kommunikoi portin kanssa saapuvan API:n kautta, joten se skaalaa ja käynnistyy uudelleen riippumatta kääntömoottorista.

Yhdistä Telegram kuudessa vaiheessa

Tässä on koko polku nollasta bottiin, joka vastaa sinulle Telegramissa. Tarvitset vain Telegram-tilin ja pääsyn AiHummer-verkkohallintaliittymääsi.

  1. Luo botti BotFatherin kanssa. Avaa Telegramissa @BotFather, lähetä /newbot, ja aseta botin nimi ja käyttäjänimi. Mitä näet: BotFather palauttaa tunnus kuin 123456789:AA… — tämä on botin käyttöavain, kopioi se.
  2. Asenna Telegram-liitin. Avaa hallinnon käyttöliittymässä Laajennukset/Markkinapaikka, etsi Telegram-liitin osoitteesta luettelo ja klikkaa “Asenna”. Odota, että kortti muuttuu “verkkoyhteyteen” (asennus edistymispalkki näytetään).
  3. Liitä tunnus. Mene kohtaan Kanavat näyttö → se Määritä asennetut kanavat lohko, avaa Telegram-kortti ja liitä bottitunnus kenttään liittimen muodosta. Tallenna.
  4. Luo agentti (jos sinulla ei vielä ole sellaista) — katso Agentit: nimi ja järjestelmäkehotus riittävät.
  5. Sido agentti kanavaan. Päällä Kanavat näyttö, sisällä Sitoja lohko, valitse yksi oletusagentti Telegramille — sääntö “uudet Telegram-keskustelut hoitaa agentti Y”. Valinta tallentuu heti.
  6. Lähetä viesti botille. Avaa bottisi Telegramissa ja lähetä sille viesti. Mitä näet: asiakasvastaanottaja vastaa keskustelussa, ja vastaava keskustelu ilmestyy hallintakäyttöliittymän “Istunnot”-näytössä.

[!NOTE] Oletuksena agentti vastaa vain tunnetut käyttäjät (henkilöt rekisteröityinä AiHummer). Jos botti pysyy hiljaa viestiisi — lisää joko itsesi esimerkkikäyttäjä, tai poista käytöstä ”Vastaa vain tunnetuille käyttäjille” päällä Kanavat näyttö.

Miksi aloittaa Telegramilla

Telegramilla on vähiten kitkaa kaikista AiHummerin kanavista: ei operaattoria, ei OAuth-suostumuksen näyttöä, ei sovelluksen tarkistusta. Riittää, että sinulla on bottitunnus viestien lähettämiseen ja vastaanottamiseen, ja sama liitin kattaa sekä sisäisten työntekijöiden keskustelut että asiakkaille suunnatut botit. Koska se on tuotantovalmius ja täysin käytetty, se on kanava, jonka suosittelemme liittämään ensimmäisenä arvioidessasi AiHummeria.

Kysely tai webhook

Liitin tukee molempia syöttötiloja, joten se toimii riippumatta siitä, onko yhdyskäytäväsi saavutettavissa julkisesta internetistä vai ei.

  • Pitkä kysely — liitin hakee päivitykset Telegramista. Ei sisäänpäin suuntautuvaa porttia tai TLS vaaditaan, mikä tekee siitä ihanteellisen paikalliseen kehitykseen ja yksityiseen verkot.
  • Webhook — Telegram työntää päivityksiä julkiseen HTTPS-URL-osoitteeseen. Alemman viiveen ja paremmin soveltuu tuotantoon käänteisen välityspalvelimen takana, joka päättää TLS-yhteyden.

Liitin kuuntelee osoitteessa portti 8800 tavallisessa käyttöönotossa, tai 8091 paikallista juoksua varten. Jokainen saapuva viesti lähetetään portaalin URL-osoitteeseen, joka on määritetty AIHUMMER_INBOUND_URL, todennettu jaettuun sisäänmenon salaisuuteen perustuen.

Rikkaat viestit, viestireaktiot ja äänestykset

Yksinkertaisen tekstin lisäksi Telegram-kanava näyttää Rikkaat viestit — muotoillut vastaukset, jotka sovittavat agentin strukturoitua tuotosta Telegramin natiiveihin viestiominaisuuksiin. Se tukee myös viestien reaktiot ja kyselyt, jotta edustaja voi reagoida käyttäjän viestiin tai laittaa nopean kyselyn keskusteluun osana vuoroa.

[!TIP] Telegram on AiHummerille tunnistettu kanava nimeltä telegram. Käytä sitä kanavaa id kun sitot agentin tai suodatat keskusteluja lähteen mukaan.

Botti-botille silmukkasuojalla

Agentit voivat puhua muiden bottien kanssa. Tehdäkseen siitä turvallista, liitin toimittaa silmukan suojain: se havaitsee ja katkaisee karkuun pääsevät botti-botti-vaihdot ennen kuin niistä tulee loputon pingpong-tilanne. Tämä antaa sinun koostaa monibottityönkulkuja ilman perinteistä palautesilmukan epäonnistumistilaa.

Salainen välittäminen OIDC:n yli

Bottitunnusta ja muita liitännäisen salaisuuksia ei koskaan koodata suoraan palveluun. Sen sijaan liitin noutaa ne ajon aikana Salaisuuksien palvelu OIDC:n yli — se todentaa, sitten hakee tarvitsemansa tunnistetiedot. Salaisuudet pysyvät salatussa holvissa eivätkä konfiguraatiotiedostoissa tai prosessin komennoissa.

[!NOTE] Saapuvat viestit lähetetään AIHUMMER_INBOUND_URL ja turvattu jaettu HMAC-saapuva salaisuus (AIHUMMER_INBOUND_SECRET). Portin on oltava oletustyötila määritetty lähettämään ne.

Jos se ei toiminut

  • Telegram-liitin ei ole ‘Kanavat’-näytössä — asenna se ensin kohteeseen se Laajennukset/Markkinapaikka näyttö; kunnes asennettu kanavaa ei näytetä. Yhteisösuunnitelmassa on saatavilla vain Telegram; loput tarvitsevat päivityksen (HTTP 402).
  • Botti ei vastaa — tarkista: (1) että tunniste on liitetty oikein ja Telegram-kortti on “verkkoyhteydessä”; (2) kanava on sidottu agenttiin “Sidonnat”-osiossa; (3) lähettäjä on rekisteröity järjestelmään (oletuksena agentti vastaa vain tunnetut käyttäjät).
  • Vastaukset näyttävät mallipohjaisilta — pilamalli on luultavasti edelleen aktiivinen; liitä tarjoaja on Mallit sivu.
  • “Luvaton” / tunnusta ei hyväksytty — tunnus on väärä tai peruutettu; luo uusi kanssa @BotFather (/token) ja liitä se uudelleen.
  • Verkkokoukku ei saavu — webhook-tilassa portin on oltava saavutettavissa osoitteessa julkinen HTTPS-URL; yksityisessä verkossa käytä pitkää kyselyä, joka ei tarvitse saapuvaa liikennettä portti tai TLS.

Minne seuraavaksi