AiHummer
Svenska▾
Logga inKonto
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Kanaler/Telegram

Telegram

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

Telegram är AiHummers produktionsnivå, rekommenderade första kanal. Det är det snabbaste sättet att få en fungerande agent framför riktiga människor: skapa en bot med @BotFather, ge kopplaren tokenet, och inkommande meddelanden börjar flöda till gatewayen.

Telegram-anslutningen installeras från produkten Marknad och konfigureras i Admin UI. Det körs värd-native och kommunicerar med gatewayen över inbound-API:et, så det skalas och startas om oberoende av turn-motorn.

Anslut Telegram på 6 steg

Här är hela vägen från noll till en bot som svarar dig på Telegram. Allt du behöver är ett Telegram-konto och tillgång till ditt AiHummer webbadministrationsgränssnitt.

  1. Skapa en bot med BotFather. I Telegram öppna @BotFather, skicka /newbot, och ställ in botens namn och användarnamn. Vad du kommer att se: BotFather returnerar en token gilla 123456789:AA… — detta är botens åtkomstnyckel, kopiera den.
  2. Installera Telegram-anslutningen. Öppna i administratörsgränssnittet Plugins/Marknadsplats, hitta Telegram-anslutningen i katalogen och klicka på “Installera”. Vänta på att kortet blir “online” (en installation förloppsindikator visas).
  3. Klistra in token. Gå till Kanaler skärm → den Konfigurera installerade kanaler blockera, öppna Telegram-kortet och klistra in bottoken till fältet från kontaktformuläret. Spara.
  4. Skapa en agent (om du inte redan har en) — se Agenter: ett namn och en systemprompt räcker.
  5. Bind agenten till kanalen. På Kanaler skärm, i “Bindningar” block, välj en standardagent för Telegram — det regel “nya Telegram-konversationer hanteras av agent Y”. Valet sparas omedelbart.
  6. Skicka meddelande till boten. Öppna din bot i Telegram och skicka ett meddelande till den. Vad du kommer att se: agenten svarar i chatten, och den matchande konversationen visas på skärmen “Sessions” i administrationsgränssnittet.

[!NOTE] Som standard svarar agenten endast kända användare (personer registrerade i AiHummer). Om boten förblir tyst på ditt meddelande — lägg antingen till dig själv som en instansanvändare, eller stäng av “Svara endast på kända användare” på Kanaler skärm.

Varför börja med Telegram

Telegram har minst friktion av alla AiHummer-kanaler: ingen operatör, ingen OAuth-samtyckesskärm, ingen appgranskning. En bot-token räcker för att skicka och ta emot meddelanden, och samma kontakt täcker både interna personalchattar och kundorienterade botar. Eftersom den är produktionsredo och fullt testad är det kanalen vi rekommenderar att du kopplar upp först när du utvärderar AiHummer.

Polling eller webhook

Anslutningen stöder båda inmatningslägena, så den fungerar oavsett om din gateway är nåbar från det offentliga internet eller inte.

  • Långpollning — anslutningen hämtar uppdateringar från Telegram. Ingen inkommande port eller TLS krävs, vilket gör det idealiskt för lokal utveckling och privat nätverk.
  • Webhook — Telegram skickar uppdateringar till en offentlig HTTPS-URL. Lägre latens och bättre lämpad för produktion bakom en omvänd proxy som avslutar TLS.

Anslutningen lyssnar på port 8800 i en normal implementering, eller 8091 för en lokal körning. Varje inkommande meddelande skickas till gateway-URL:en som är konfigurerad i AIHUMMER_INBOUND_URL, autentiserad med den delade inkommande hemligheten.

Rika meddelanden, meddelandereaktioner och omröstningar

Bortom vanlig text, återger Telegram-kanalen Rika meddelanden — formaterade svar som kartlägger en agents strukturerade utdata på Telegrams inbyggda meddelandefunktioner. Det stöder också meddelandereaktioner och undersökningar, så att en agent kan reagera på en användares meddelande eller lägga in en snabb undersökning i en chatt som en del av en tur.

[!TIP] Telegram är kanalen som identifierats för AiHummer som telegram. Använd den kanalen id när du binder en agent eller filtrerar konversationer efter källa.

Bot-till-bot med en loop-vakt

Agenter kan prata med andra botar. För att göra det säkert levereras kopplaren med en loopvakt: det upptäcker och bryter löpande bot-till-bot-utbyten innan de förvandlas till ett oändligt pingpongspel. Detta låter dig skapa arbetsflöden med flera botar utan det klassiska återkopplingsfel-läget.

Hemlig förmedling över OIDC

Bot-token och andra kopplingshemligheter är aldrig hårdkodade i tjänsten. Istället hämtar kopplingen dem vid körning från en Secrets-tjänst över OIDC — det autentiserar, sedan hämtar de uppgifter det behöver. Hemligheter stannar i det krypterade valvet och utanför konfigurationsfiler och processargument.

[!NOTE] Inkommande meddelanden skickas till AIHUMMER_INBOUND_URL och säkrad av delad HMAC inbound-hemlighet (AIHUMMER_INBOUND_SECRET). Gatewayen måste ha en standardarbetsyta konfigurerad för att skicka dem.

Om det inte fungerade

  • Telegram-anslutningen finns inte på skärmen “Kanaler” — installera det först på det Plugins/Marknadsplats skärm; tills den är installerad kanal visas inte. På Community-planen är endast Telegram tillgängligt; resten behöver en uppgradering (HTTP 402).
  • Botten svarar inte — kontrollera: (1) att token har klistrats in korrekt och Telegram-kortet är “online”; (2) kanalen är bunden till en agent i “Bindings”; (3) avsändaren är registrerad i systemet (som standard svarar agenten bara kända användare).
  • Svar ser mallmässiga ut — den simulerade modellen är förmodligen fortfarande aktiv; anslut en leverantör på Modeller sida.
  • “Obehörig” / token avvisad — tokenet är fel eller återkallat; generera en ny en med @BotFather (/token) och klistra in det igen.
  • Webhooken anländer inte — i webbhook-läge måste gatewayen vara nåbar på en offentlig HTTPS-URL; på ett privat nätverk använd lång polling, vilket inte behöver inkommande port eller TLS.

Vart härnäst