AiHummer
Norsk▾
Logg påKonto
v1.2.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Telegram

Telegram

v1.2.x · oppdatert 2026-06-26

Telegram er AiHummers produksjonsnivå, anbefalt første kanal. Det er den raskeste måten å få en fungerende agent foran ekte mennesker på: lag en bot med @BotFather, gi koblingen tokenet, og innkommende meldinger begynner å strømme til gatewayen.

Telegram-tilkoblingen installeres fra produktet Marked og konfigurert i administrasjonsgrensesnittet. Den kjører på verts-maskinen og kommuniserer med gatewayen over den innkommende API-en, slik at den skalerer og starter på nytt uavhengig av turmotoren.

Koble til Telegram i 6 trinn

Her er hele prosessen fra null til en bot som svarer deg på Telegram. Alt du trenger er en Telegram-konto og tilgang til AiHummer-nettadmingrensesnittet ditt.

  1. Lag en bot med BotFather. Åpne i Telegram @BotFather, send /newbot, og angi botens navn og brukernavn. Hva du vil se: BotFather returnerer en token like 123456789:AA… — dette er båtens tilgangsnøkkel, kopier den.
  2. Installer Telegram-koblingen. Åpne i administrasjonsgrensesnittet Plugins/Markedsplass, finn Telegram-koblingen i katalogen og klikk “Installer”. Vent til kortet blir “online” (en installasjon fremdriftslinje vises).
  3. Lim inn tokenet. Gå til Kanaler skjerm → det Konfigurer installerte kanaler blokkere, åpne Telegram-kortet og lim inn bot-token inn i feltet fra koblingsskjemaet. Lagre.
  4. Lag en agent (hvis du ikke har en ennå) — se Agenter: et navn og et systemprompt er nok.
  5. Knytt agenten til kanalen. På Kanaler skjerm, i den Bindinger blokk, plukk en standardagent for Telegram — det regel “nye Telegram-samtaler drives av agent Y”. Valget lagres umiddelbart.
  6. Send melding til boten. Åpne boten din i Telegram og send den en melding. *Hva du vil se: * agenten svarer i chatten, og den tilhørende samtalen vises på skjermen «Sessions» i administrasjonsgrensesnittet.

[!NOTE] Som standard svarer agenten kun kjente brukere (personer registrert i AiHummer). Hvis boten forblir stille på meldingen din — legg enten til deg selv som en instansbruker, eller slå av “Svar kun kjente brukere” på Kanaler skjerm.

Hvorfor starte med Telegram

Telegram har minst friksjon av alle AiHummer-kanaler: ingen operatør, ingen OAuth-samtykkeskjerm, ingen app-gjennomgang. En bot-token er nok til å sende og motta meldinger, og den samme koblingen dekker både interne personalchatter og kundevendte roboter. Fordi den er produksjonsklar og fullt ut testet, er det kanalen vi anbefaler at du kobler opp først når du evaluerer AiHummer.

Polling eller webhook

Konnektoren støtter begge inntaksmoduser, så den fungerer enten gatewayen din er tilgjengelig fra det offentlige internettet eller ikke.

  • Lang polling — koblingen henter oppdateringer fra Telegram. Ingen inngående port eller TLS er påkrevd, noe som gjør det ideelt for lokal utvikling og privat nettverk.
  • Webhook — Telegram sender oppdateringer til en offentlig HTTPS URL. Lavere ventetid og bedre egnet for produksjon bak en omvendt proxy som avslutter TLS.

Koblingen lytter på port 8800 i en normal distribusjon, eller 8091 for en lokal kjøring. Hver innkommende melding blir sendt til gateway-URLen som er konfigurert i AIHUMMER_INBOUND_URL, autentisert med den delte innkommende hemmeligheten.

Rike meldinger, meldingsreaksjoner og avstemninger

Utover vanlig tekst, gjengir Telegram-kanalen Rike meldinger — formaterte svar som kartlegger en agents strukturerte utdata på Telegrams innebygde meldingsfunksjoner. Den støtter også meldingsreaksjoner og meningsmålinger, slik at en agent kan reagere på en brukers melding eller legge inn en rask avstemning i en chat som en del av en runde.

[!TIP] Telegram er kanalen identifisert for AiHummer som telegram. Bruk den kanalen id når du binder en agent eller filtrerer samtaler etter kilde.

Bot-til-bot med en sløyfebeskytter

Agenter kan snakke med andre roboter. For å gjøre det trygt, leveres kobleren med en sløyfevakt: det oppdager og bryter løpske bot-til-bot-utvekslinger før de utvikler seg til en uendelig pingpong. Dette lar deg komponere arbeidsflyter med flere roboter uten den klassiske feilsituasjonen med tilbakemeldingssløyfer.

Hemmelig formidling over OIDC

Bot-tokenet og andre tilkoblingshemmeligheter blir aldri hardkodet inn i tjenesten. I stedet henter tilkoblingen dem under kjøring fra en Secrets-tjeneste over OIDC — det autentiserer, og henter deretter de nødvendige legitimasjonene. Hemmeligheter forblir i den krypterte hvelvet og ute av konfigurasjonsfiler og prosessargumenter.

[!NOTE] Innkommende meldinger blir sendt til AIHUMMER_INBOUND_URL og sikret av delt HMAC innkommende hemmelighet (AIHUMMER_INBOUND_SECRET). Gatewayen må ha en standard arbeidsområde konfigurert til å sende dem.

Hvis det ikke fungerte

  • Telegram-tilkoblingen er ikke på skjermen “Kanaler” — installer det først på det Plugins/Markedsplass skjerm; til installert den kanal vises ikke. På Community-planen er kun Telegram tilgjengelig; resten trenger en oppgradering (HTTP 402).
  • Botten svarer ikke — sjekk: (1) at tokenet er limt inn korrekt og Telegram-kortet er “online”; (2) kanalen er knyttet til en agent i “Bindings”; (3) avsenderen er registrert i systemet (som standard svarer agenten bare kjente brukere).
  • Svarene ser malbaserte ut — den simulerte modellen er sannsynligvis fortsatt aktiv; koble til en leverandør på Modeller side.
  • “Uautorisert” / token avvist — tokenet er feil eller tilbakekalt; generer en ny en med @BotFather (/token) og lim det inn igjen.
  • Webhooken kommer ikke fram — i webhook-modus må gatewayen være tilgjengelig på en offentlig HTTPS-URL; på et privat nettverk bruk lang polling, som ikke trenger innkommende port eller TLS.

Hvor til neste