Odpowiadanie na zatwierdzenia w Microsoft Teams: konfiguracja bota DueReason
Zarejestruj Azure Bot, wgraj aplikację DueReason do Teams i pozwól zatwierdzającym klikać Zatwierdź/Odrzuć wprost w wiadomości Teams, bez otwierania linku.
Aktualizacja · 7 min czytania
W skrócie
- Kanał Teams już dziś dostaje powiadomienia przez webhook przychodzący; aplikacja DueReason do Teams dodaje przyciski Zatwierdź/Odrzuć, które uprawniony zatwierdzający kliknie wprost w wiadomości, z wpisanym powodem, gdy krok tego wymaga.
- Konfiguracja to trzy jednorazowe kroki: zarejestruj Azure Bot (multi-tenant), wgraj paczkę aplikacji DueReason do Teams, a potem dodaj aplikację do zespołu, kanału lub czatu i wklej w Ustawieniach > Powiadomienia kod parowania, który bot tam wyśle.
- Samodzielny hosting potrzebuje trzech zmiennych środowiskowych na serwerze - bez nich punkt końcowy bota odpowiada 404, a każdy kanał Teams działa dokładnie tak jak dziś, przez zwykły webhook.
- To opcja włączana per kanał: kanał połączony webhookiem, który nigdy nie zainstaluje aplikacji, działa bez zmian, a instalacja aplikacji nie zabiera możliwości dalszego korzystania z samego webhooka.
Kanał Teams już dziś słyszy o prośbach o zatwierdzenie przez webhook przychodzący, tak samo jak kanał Slacka: DueReason publikuje wiadomość, a zatwierdzający otwiera link, żeby odpowiedzieć w konsoli. Aplikacja DueReason do Teams dodaje drugi, opcjonalny sposób połączenia kanału - taki, w którym uprawniony zatwierdzający klika Zatwierdź albo Odrzuć wprost w wiadomości Teams, wpisując powód, gdy krok tego wymaga, bez otwierania linku i bez osobnego logowania. Nic w ścieżce webhooka się nie zmienia: kanał, który nigdy nie zainstaluje aplikacji, działa dokładnie tak jak teraz. Dobrze to pasuje do każdej akceptacji, którą już kierujesz przez Teams - na przykład do akceptacji wniosku o dostęp odpowiadanej wprost w karcie Teams zamiast przez DM.
Co konfigurujesz
Trzy rzeczy, każda jednorazowo:
- Zasób Azure Bot (multi-tenant), z którego DueReason bierze identyfikator aplikacji i hasło potrzebne do wywoływania Bot Framework Connector API oraz weryfikacji aktywności wysyłanych przez Teams.
- Paczkę aplikacji DueReason do Teams, wgraną albo dla całej organizacji (administrator Teams instaluje ją dla wszystkich), albo przez sideload do jednego zespołu przy mniejszym wdrożeniu.
- Aplikację dodaną do zespołu, kanału lub czatu, który chcesz połączyć, sparowaną jednorazowo w Ustawieniach DueReason > Powiadomienia krótkim kodem, który bot tam opublikuje.
Rejestracja Azure Bota
W Azure Portal utwórz zasób Azure Bot:
- Type of App: Multi Tenant - dzięki temu jedna rejestracja bota obsługuje tenant Teams każdej organizacji, a nie tylko Twój.
- Messaging endpoint:
https://twoj-host/api/teams/messages(https://duereason.com/api/teams/messagesdla wersji hostowanej). - Dodaj do bota kanał Microsoft Teams (Channels, Microsoft Teams, Save) - bez tego Teams nigdy nie dostarczy aktywności do Twojego punktu końcowego, nawet jeśli aplikacja jest zainstalowana.
Po utworzeniu strona Configuration zasobu pokazuje Microsoft App ID - to staje się zarówno TEAMS_BOT_APP_ID, jak i identyfikatorem (id/botId) w paczce aplikacji (Teams wymaga, żeby identyfikator aplikacji z jednym botem zgadzał się z identyfikatorem bota). Wygeneruj client secret w Certificates & secrets - to staje się TEAMS_BOT_APP_PASSWORD. Traktuj go jak każdy inny sekret: nigdy nie trafia do repozytorium, a w infrastrukturze DueReason istnieje wyłącznie zapieczętowany, wewnątrz klastra.
Budowa i wgranie paczki aplikacji
Repozytorium DueReason zawiera szablon manifestu i dwie wymagane ikony w duereason/teams-app/; mały skrypt wstawia identyfikator Twojego bota i pakuje paczkę do zipa:
``bash node duereason/teams-app/scripts/build-package.mjs --app-id 11111111-2222-3333-4444-555555555555 --out teams-app.zip ``
Wgraj teams-app.zip na jeden z dwóch sposobów:
- Dla całej organizacji: Teams admin center > Teams apps > Manage apps > Upload new app. Każdy w organizacji może potem dodać aplikację z katalogu aplikacji Teams.
- Sideload do jednego zespołu: w Teams otwórz Apps > Manage your apps > Upload an app > Upload a custom app i wybierz zespół, do którego ją dodajesz. Dobre, żeby wypróbować aplikację przed wdrożeniem dla całej organizacji.
Połączenie zespołu, kanału lub czatu
Dodaj aplikację DueReason do zespołu, kanału albo czatu 1:1/grupowego, do którego mają trafiać zatwierdzenia - tak samo jak dodaje się każdą aplikację Teams. Bot odpowie tam krótkim kodem parowania, ważnym 30 minut i jednorazowym.
W DueReason wejdź w Ustawienia > Powiadomienia, dodaj kanał, wybierz Microsoft Teams jako miejsce i Połącz z aplikacją DueReason do Teams jako sposób dostarczania, i wklej ten kod. Kanał jest teraz dostarczany przez bota: karty publikują się z przyciskami Zatwierdź/Odrzuć zamiast zwykłej wiadomości.
Pojedynczy zatwierdzający, który chce klikać te przyciski (zamiast zawsze otwierać prośbę), też łączy swoje konto raz: Ustawienia > Powiadomienia > Microsoft Teams, wklejając swój identyfikator obiektu Azure AD (Centrum administracyjne Microsoft Entra > Users > jego konto > Object ID). Bez tego powiązania DueReason nie wie, który członek kliknął, i karta poprosi go najpierw o połączenie konta.
Samodzielny hosting
Trzy zmienne środowiskowe, które działają razem - nie ustawiając żadnej z nich, punkt końcowy odpowiada 404, a każdy kanał Teams zachowuje się dokładnie tak jak dziś (tylko webhook):
| Zmienna | Co kontroluje |
|---|---|
TEAMS_BOT_APP_ID | Microsoft App ID zasobu Azure Bot; także identyfikator w manifeście aplikacji Teams i wartość aud w JWT każdej przychodzącej aktywności. |
TEAMS_BOT_APP_PASSWORD | Client secret tej samej aplikacji, używany do wywołań Bot Framework Connector API (publikowanie i aktualizowanie kart). |
TEAMS_BOT_TENANT | Opcjonalna. Identyfikator Twojego tenanta Entra, dla wdrożenia single-tenant. Bez niej bot akceptuje połączenie od członka z dowolnego tenanta i dopasowuje wyłącznie po jego identyfikatorze użytkownika Teams - w porządku dla samodzielnego hostingu jednej organizacji, warto ustawić, gdy z tym samym botem rozmawia więcej niż jeden tenant Entra. |
Co się nie zmienia
Nic w dzisiejszych kanałach połączonych webhookiem się nie zmienia. Kanał Teams połączony przez Workflows > "Send webhook alerts to a channel" dalej publikuje wiadomości i działa bez bota, bez rejestracji w Azure i bez instalowania aplikacji - bot to dodatkowy, opcjonalny sposób dostarczania dla kanałów, które chcą przycisków wprost w wiadomości, a nie zamiennik tego, co już działa.
Pytania
- Musimy zainstalować aplikację Teams, czy możemy zostać przy webhooku?
- Webhook pozostaje domyślny i działa bez zmian. Instalacja aplikacji DueReason do Teams jest opcjonalna, per kanał - kanał może zostać przy webhooku, przejść na aplikację albo (dla różnych kanałów) korzystać z obu naraz.
- Czy jedna rejestracja Azure Bot może obsłużyć więcej niż jeden tenant Teams?
- Tak, jeśli zarejestrujesz ją jako Multi Tenant (tak jak w tym przewodniku): każda organizacja może dodać aplikację i sparować kanał, a połączenia kont Teams członków są dopasowywane bez sprawdzania tenanta, chyba że ustawisz TEAMS_BOT_TENANT.
- Co się stanie, jeśli brakuje TEAMS_BOT_APP_ID albo TEAMS_BOT_APP_PASSWORD?
- Punkt końcowy (/api/teams/messages) odpowiada 404 na każde żądanie, a opcja dostarczania przez aplikację Teams w Ustawieniach > Powiadomienia pozostaje zablokowana. Kanały Teams połączone webhookiem działają bez zmian w obu przypadkach.
- Czy zatwierdzający musi coś sam zainstalować, żeby kliknąć Zatwierdź/Odrzuć?
- Nic nowego do instalacji - gdy kanał organizacji jest już połączony, zatwierdzający musi tylko raz wkleić swój identyfikator obiektu Azure AD w Ustawieniach > Powiadomienia > Microsoft Teams, żeby DueReason mogło powiązać jego kliknięcie z jego kontem DueReason.
Połącz Teams z własnej konsoli
Zaloguj się, otwórz Ustawienia > Powiadomienia i dodaj kanał Microsoft Teams - zacznij dziś od webhooka, dodaj bota, gdy będziesz gotowy na przyciski Zatwierdź/Odrzuć wprost w wiadomości.
Otwórz UstawieniaŹródła
- Microsoft Learn: Create a bot for Microsoft Teams
- Microsoft Learn: Teams app manifest schema
- Microsoft Learn: Upload your app in Teams
Poradnik wyjaśnia przepisy tak, jak je rozumiemy; nie jest poradą prawną. Sprawdź tekst urzędowy i prawo krajowe, które może dodać obowiązki.