Navigace
ELOWEN · Dokumentace

Poslední aktualizace: 27. října 2026

Procházet dokumentaci · Připojení bota Microsoft Teams
Kanály a chatboti

Připojení bota Microsoft Teams

Vytvořte bota Azure, nainstalujte plugin, zadejte přihlašovací údaje bota a propojte identity Microsoft, které ho mají používat.

Než začnete

  • Chetty 0.30.47 nebo novější, se sdíleným API verze 16 a webovým API verze 73.
  • Tenant Microsoft Entra, ve kterém můžete registrovat aplikace, a předplatné Azure, ve kterém můžete vytvořit bota.
  • Veřejná adresa HTTPS pro Chettyho. Teams posílají zprávy bota tam a za adresou jen s HTTP nic nefunguje.
  • Administrátor tenanta pro kroky se souhlasy. Delegované rozsahy Microsoft 365 i aplikační oprávnění Graph potřebují jeho souhlas.

Instalace pluginu

  1. Otevřete Nastavení → Dostupné pluginy a nainstalujte Microsoft Teams.
  2. Zapněte ho. Chetty vyžádá oprávnění, které přežije jednu odpověď – zde měnění uživatelů – a detail pluginu vypisuje sdílená data a soubory Projektů, které čte.
  3. Potvrďte restart. Zapnutí, vypnutí nebo uložení nastavení ho vyžádá a restart může počkat na běžící kola. Změny se ukládají nejdřív; pokud restart nejde vyžádat, projeví se při příštím startu.

Vytvoření bota v Azure

  1. V centru pro správu Entra vytvořte registraci aplikace pro jednoho tenanta a zkopírujte její Application (client) ID a Directory (tenant) ID.
  2. V části Certificates & secrets vytvořte tajný klíč klienta a zkopírujte jeho hodnotu. Chetty tajný klíč ukáže jen jednou, stejně jako Microsoft.
  3. Na portálu Azure vytvořte Azure Bot typu Single Tenant s tímto ID aplikace a zapněte kanál Microsoft Teams.
  4. Nastavte Messaging endpoint bota na https://<your-domain>/hooks/msteams/messages, kde doména je veřejná adresa vaší instance Chettyho. Reverzní proxy musí směrovat /hooks/ do Chettyho.
  5. Na stránce MS Teams zvolte Stáhnout balíček aplikace, nahrajte soubor v Centru pro správu Teams → Spravovat aplikace a přidejte aplikaci do chatu nebo týmu.

Tip: Stránka Microsoft Teams prochází stejné kroky v Azure a v Teams i s podrobnostmi na straně tenanta.

Zadání přihlašovacích údajů

  1. Otevřete Nastavení → Přístupy → Microsoft Teams.
  2. Zadejte Microsoft App ID, Tajný klíč klienta a ID tenantu.
  3. Uložte. Bot se nepřipojí, dokud nejsou nastavené všechny tři hodnoty.
Nastavení Výchozí Co dělá
Microsoft App ID Nenastaveno ID klienta aplikace bota pro jednoho tenanta.
Tajný klíč klienta Nenastaveno Tajný klíč, kterým se bot ověřuje v Microsoftu.
ID tenantu Nenastaveno Tenant Entra, do kterého aplikace bota patří.
Přihlášení k Microsoftu v osobním chatu Vypnuto Umožní povoleným členům tenanta přihlásit se v osobním chatu a používat přístup svého propojeného účtu.
Název připojení OAuth Nenastaveno Zobrazí se, když je přihlášení zapnuté. Přesný název připojení OAuth, které přidáte k botovi Azure.

Tajný klíč klienta je jen pro zápis: Chetty uchová zašifrovanou hodnotu a ukazuje pouze to, zda je nastavený.

Zapnutí nástrojů Microsoft 365

Nástroje Microsoft 365 potřebují delegované přihlášení k Microsoftu, které je oddělené od přihlašovacích údajů bota.

  1. Vytvořte druhou registraci aplikace v Entra pro jednoho tenanta a přidejte delegované rozsahy Microsoft 365, které mají nástroje používat.
  2. K botovi Azure přidejte připojení OAuth s poskytovatelem Microsoft Entra ID v2 a touto registrací aplikace. Microsoft Teams uvádí praktickou sadu rozsahů.
  3. Zkopírujte přesný název připojení do Název připojení OAuth a zapněte Přihlášení k Microsoftu v osobním chatu.
  4. Požádejte administrátora tenanta o souhlas s delegovanými rozsahy v Microsoftu.

V nastavení pluginu se pak objeví Přístup k Microsoft 365. Ve výchozím nastavení je Pouze pro čtení; Čtení a zápis každou změnu stejně nejdřív zobrazí jako náhled, dokud agent tuto konkrétní operaci nepotvrdí.

  1. Požádejte osobu, aby bota otevřela v osobním chatu Teams a přihlásila se přes Microsoft. Její identita Teams se tím propojí s účtem Chettym.
  2. Nebo jako administrátor otevřete stránku MS Teams → Lidé a přístup, vyberte osobu a zvolte Propojit účet Chettyho.

Propojení používá neměnné Entra object ID, nikdy jméno ani e-mailovou adresu. Přístup k Projektům a oprávnění nástrojů vždy určuje propojený účet Chettyho.

Když se bot nepřipojí

  • V Teams nic neodpovídá. Zkontrolujte, že jsou nastavené všechny tři přihlašovací údaje, a pak balíček aplikace: bot musí být přidaný v chatu nebo týmu, kam píšete.
  • Bot se načte, ale nic neposílá. Po změně Název aplikace v Teams, Název vydavatele v Teams, Ikona aplikace v Teams nebo Číst všechny zprávy v kanálu stáhněte balíček aplikace znovu a nahrajte ho.
  • Nástroje Microsoft 365 odmítají každé volání. Zkontrolujte, že je zapnuté přihlášení v osobním chatu, že název připojení OAuth odpovídá přesně a že administrátor tenanta odsouhlasil delegované rozsahy.
  • Stažení balíčku aplikace selže. Ikona aplikace musí být PNG 192 × 192 na cestě, kterou jste nastavili; prázdné nastavení ikony použije obyčejný barevný čtverec.