AiHummer
Dansk▾
Log indKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Telegram

Telegram

v1.0.x · opdateret 2026-06-26

Telegram er AiHummers produktionsklar, anbefalede første kanal. Det er den hurtigste måde at få en fungerende agent foran rigtige mennesker på: opret en bot med @BotFather, giv forbindelsen tokenet, og indgående beskeder begynder at strømme til gatewayen.

Telegram-forbindelsen installeres fra produktet Markedsplads og konfigureret i Admin UI. Det kører på værtens eget system og taler med gatewayen over den indgående API, så det skaleres og genstartes uafhængigt af turn-motoren.

Forbind Telegram på 6 trin

Her er hele vejen fra nul til en bot, der svarer dig på Telegram. Alt hvad du behøver, er en Telegram-konto og adgang til dit AiHummer webadmin-UI.

  1. Opret en bot med BotFather. Åbn i Telegram @BotFather, send /newbot, og indstil botens navn og brugernavn. Hvad du vil se: BotFather returnerer en token som 123456789:AA… — dette er botens adgangsnøgle, kopier den.
  2. Installer Telegram-forbindelsen. Åbn i admin UI Plugins/Markedsplads, find Telegram-forbindelsen i kataloget og klik på “Installer”. Vent på, at kortet bliver “online” (en installation fremskridtslinje vises).
  3. Indsæt tokenet. Gå til Kanaler skærm → det Konfigurer installerede kanaler blokér, åbn Telegram-kortet og indsæt bot-token ind i feltet fra stikform. Gem.
  4. Opret en agent (hvis du ikke allerede har en) — se Agenter: et navn og en systemprompt er nok.
  5. Bind agenten til kanalen. På Kanaler skærm, i den “Bindinger” blok, vælg en standardagent for Telegram — det regel “nye Telegram-samtaler drives af agent Y”. Valget gemmes med det samme.
  6. Send en besked til botten. Åbn din bot i Telegram og send den en besked. *Hvad du vil se: * agenten svarer i chatten, og den matchende samtale vises på skærmen “Sessions” i administrationsgrænsefladen.

[!NOTE] Som standard svarer agenten kun kendte brugere (personer registreret i AiHummer). Hvis botten forbliver tavs over for din besked — tilføj dig selv som en instansbruger, eller slå “Svar kun kendte brugere” fra på Kanaler skærm.

Hvorfor starte med Telegram

Telegram har mindst friktion af alle AiHummer-kanaler: ingen udbyder, ingen OAuth-samtykkeskærm, ingen app-gennemgang. Et bot-token er nok til at sende og modtage beskeder, og den samme connector dækker både interne medarbejderchat og kundeorienterede bots. Fordi den er produktionsegnet og fuldt afprøvet, er det den kanal, vi anbefaler, at du forbinder først, når du evaluerer AiHummer.

Afstemning eller webhook

Stikket understøtter begge indtagsmetoder, så det fungerer, uanset om din gateway er tilgængelig fra det offentlige internet eller ej.

  • Lang polling — forbindelsen henter opdateringer fra Telegram. Ingen indgående port eller TLS er påkrævet, hvilket gør det ideelt til lokal udvikling og privat netværk.
  • Webhook — Telegram sender opdateringer til en offentlig HTTPS URL. Lavere latenstid og bedre egnet til produktion bag en reverse proxy, der afslutter TLS.

Stikket lytter på port 8800 i en normal implementering, eller 8091 for en lokal kørsel. Hver indkommende besked sendes til gateway-URL’en, der er konfigureret i AIHUMMER_INBOUND_URL, autentificeret med den delte indgående hemmelighed.

Rige beskeder, beskedreaktioner og afstemninger

Udover almindelig tekst gengiver Telegram-kanalen Rige beskeder — formaterede svar, der kortlægger en agents strukturerede output på Telegrams indbyggede beskedfunktioner. Det understøtter også beskedreaktioner og meningsmålinger, så en agent kan reagere på en brugers besked eller lave en hurtig afstemning i en chat som en del af en tur.

[!TIP] Telegram er den kanal, der er identificeret for AiHummer som telegram. Brug den kanal id, når du binder en agent eller filtrerer samtaler efter kilde.

Bot-til-bot med en loopbeskytter

Agenter kan tale med andre bots. For at gøre det sikkert, leverer forbindelsen en sløjfevagt: det opdager og bryder løbske bot-til-bot-udvekslinger, før de udvikler sig til en uendelig ping-pong. Dette giver dig mulighed for at sammensætte arbejdsprocesser med flere bots uden den klassiske feedback-loop-fejltilstand.

Hemmelig mægling over OIDC

Bot-tokenet og andre forbindelseshemmeligheder er aldrig hardkodet ind i tjenesten. I stedet henter forbindelsen dem under kørslen fra en Secrets-tjeneste over OIDC — det autentificerer, og henter derefter de legitimationsoplysninger, det har brug for. Hemmeligheder forbliver i det krypterede hvælving og ude af konfigurationsfiler og procesargumenter.

[!NOTE] Indgående beskeder lægges på AIHUMMER_INBOUND_URL og sikret af delt HMAC indgående hemmelighed (AIHUMMER_INBOUND_SECRET). Gatewayen skal have en standardarbejdsområde konfigureret til at sende dem afsted.

Hvis det ikke virkede

  • Telegram-stikket er ikke på skærmen ‘Kanaler’ — installer det først på det Plugins/Markedsplads skærm; indtil installeret kanal vises ikke. På Community-planen er kun Telegram tilgængelig; resten har brug for en opgradering (HTTP 402).
  • Botten svarer ikke — tjek: (1) at tokenet er indsat korrekt og Telegram-kortet er “online”; (2) kanalen er bundet til en agent i “Bindings”; (3) afsenderen er registreret i systemet (som standard svarer agenten kun kendte brugere).
  • Svarene ser skabelonagtige ud — den simulerede model er sandsynligvis stadig aktiv; forbind en udbyder på Modeller side.
  • “Uautoriseret” / token afvist — tokenet er forkert eller tilbagekaldt; generer en ny en med @BotFather (/token) og indsæt det igen.
  • Webhooken ankommer ikke — i webhook-tilstand skal gatewayen være tilgængelig på en offentlig HTTPS-URL; på et privat netværk brug lang polling, som ikke kræver indgående port eller TLS.

Hvor til næste