Navigácia
ELOWEN · Dokumentácia

Posledná aktualizácia: 27. októbra 2026

Prechádzať dokumentáciu · Pripojenie bota Microsoft Teams
Kanály a chatboty

Pripojenie bota Microsoft Teams

Vytvorte bota Azure, nainštalujte plugin, zadajte prihlasovacie údaje bota a prepojte identity Microsoft, ktoré ho majú používať.

Skôr ako začnete

  • Chetty 0.30.47 alebo novšia, so zdieľaným API verzie 16 a webovým API verzie 73.
  • Tenant Microsoft Entra, v ktorom môžete registrovať aplikácie, a predplatné Azure, v ktorom môžete vytvoriť bota.
  • Verejná adresa HTTPS pre Chettyho. Teams posielajú správy bota tam a za adresou len s HTTP nič nefunguje.
  • Administrátor tenanta na kroky so súhlasmi. Delegované rozsahy Microsoft 365 aj aplikačné oprávnenia Graph potrebujú jeho súhlas.

Inštalácia pluginu

  1. Otvorte Nastavenia → Dostupné pluginy a nainštalujte Microsoft Teams.
  2. Zapnite ho. Chetty vyžiada oprávnenie, ktoré prežije jednu odpoveď – tu menenie používateľov – a detail pluginu vypisuje zdieľané dáta a súbory Projektov, ktoré číta.
  3. Potvrďte reštart. Zapnutie, vypnutie alebo uloženie nastavení ho vyžiada a reštart môže počkať na bežiace kolá. Zmeny sa ukladajú najskôr; ak sa reštart nedá vyžiadať, prejavia sa pri ďalšom štarte.

Vytvorenie bota v Azure

  1. V centre správy Entra vytvorte registráciu aplikácie pre jedného tenanta a skopírujte jej Application (client) ID a Directory (tenant) ID.
  2. V časti Certificates & secrets vytvorte tajný kľúč klienta a skopírujte jeho hodnotu. Chetty tajný kľúč ukáže len raz, rovnako ako Microsoft.
  3. Na portáli Azure vytvorte Azure Bot typu Single Tenant s týmto ID aplikácie a zapnite kanál Microsoft Teams.
  4. Nastavte Messaging endpoint bota na https://<your-domain>/hooks/msteams/messages, kde doména je verejná adresa Vašej inštancie Chettyho. Reverzná proxy musí smerovať /hooks/ do Chettyho.
  5. Na stránke MS Teams zvoľte Stiahnuť balíček aplikácie, nahrajte súbor v Centre správy Teams → Spravovať aplikácie a pridajte aplikáciu do chatu alebo tímu.

Tip: Stránka Microsoft Teams prechádza rovnaké kroky v Azure a v Teams aj s podrobnosťami na strane tenanta.

Zadanie prihlasovacích údajov

  1. Otvorte Nastavenia → Prístupy → Microsoft Teams.
  2. Zadajte Microsoft App ID, Tajný kľúč klienta a ID tenantu.
  3. Uložte. Bot sa nepripojí, kým nie sú nastavené všetky tri hodnoty.
Nastavenie Predvolené Čo robí
Microsoft App ID Nenastavené ID klienta aplikácie bota pre jedného tenanta.
Tajný kľúč klienta Nenastavené Tajný kľúč, ktorým sa bot overuje v Microsofte.
ID tenantu Nenastavené Tenant Entra, do ktorého aplikácia bota patrí.
Prihlásenie k Microsoftu v osobnom chate Vypnuté Umožní povoleným členom tenanta prihlásiť sa v osobnom chate a používať prístup svojho prepojeného účtu.
Názov pripojenia OAuth Nenastavené Zobrazí sa, keď je prihlásenie zapnuté. Presný názov pripojenia OAuth, ktoré pridáte k botovi Azure.

Tajný kľúč klienta je len na zápis: Chetty uchová zašifrovanú hodnotu a ukazuje iba to, či je nastavený.

Zapnutie nástrojov Microsoft 365

Nástroje Microsoft 365 potrebujú delegované prihlásenie k Microsoftu, ktoré je oddelené od prihlasovacích údajov bota.

  1. Vytvorte druhú registráciu aplikácie v Entra pre jedného tenanta a pridajte delegované rozsahy Microsoft 365, ktoré majú nástroje používať.
  2. K botovi Azure pridajte pripojenie OAuth s poskytovateľom Microsoft Entra ID v2 a touto registráciou aplikácie. Microsoft Teams uvádza praktickú sadu rozsahov.
  3. Skopírujte presný názov pripojenia do Názov pripojenia OAuth a zapnite Prihlásenie k Microsoftu v osobnom chate.
  4. Požiadajte administrátora tenanta o súhlas s delegovanými rozsahmi v Microsofte.

V nastaveniach pluginu sa potom objaví Prístup k Microsoft 365. Predvolene je Iba na čítanie; Čítanie a zápis každú zmenu rovnako najskôr zobrazí ako náhľad, kým agent túto konkrétnu operáciu nepotvrdí.

  1. Požiadajte osobu, aby bota otvorila v osobnom chate Teams a prihlásila sa cez Microsoft. Jej identita Teams sa tým prepojí s účtom Chettym.
  2. Alebo ako administrátor otvorte stránku MS Teams → Ľudia a prístup, vyberte osobu a zvoľte Prepojiť účet Chettyho.

Prepojenie používa nemenné Entra object ID, nikdy meno ani e-mailovú adresu. Prístup k Projektom a oprávnenia nástrojov vždy určuje prepojený účet Chettyho.

Keď sa bot nepripojí

  • V Teams nič neodpovedá. Skontrolujte, že sú nastavené všetky tri prihlasovacie údaje, a potom balíček aplikácie: bot musí byť pridaný v chate alebo tíme, kam píšete.
  • Bot sa načíta, ale nič neposiela. Po zmene Názov aplikácie v Teams, Názov vydavateľa v Teams, Ikona aplikácie v Teams alebo Čítať všetky správy v kanáli stiahnite balíček aplikácie znova a nahrajte ho.
  • Nástroje Microsoft 365 odmietajú každé volanie. Skontrolujte, že je zapnuté prihlásenie v osobnom chate, že názov pripojenia OAuth zodpovedá presne a že administrátor tenanta odsúhlasil delegované rozsahy.
  • Stiahnutie balíčka aplikácie zlyhá. Ikona aplikácie musí byť PNG 192 × 192 na ceste, ktorú ste nastavili; prázdne nastavenie ikony použije obyčajný farebný štvorec.