Przejdź do treści

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:

  1. 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.
  2. 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.
  3. 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/messages dla 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):

ZmiennaCo kontroluje
TEAMS_BOT_APP_IDMicrosoft 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_PASSWORDClient secret tej samej aplikacji, używany do wywołań Bot Framework Connector API (publikowanie i aktualizowanie kart).
TEAMS_BOT_TENANTOpcjonalna. 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

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.

Zacznij z DueReason

Załóż bezpłatne konto, wypróbuj na żywo albo porozmawiaj z nami o swoim procesie.

Otrzymuj nowości o produkcie