integracja z Teams

Integracja z Teams umożliwia przekazywanie powiadomień i dokumentów do tej platformy współpracy zespołowej.

Zakres integracji z Microsoft Teams

Integracja z Teams oznacza połączenie aplikacji, systemu obsługi zgłoszeń albo narzędzia do pracy z platformą Microsoft Teams w celu automatycznego przekazywania informacji. Powiadomienie może pojawić się w rozmowie indywidualnej, czacie grupowym, kanale zespołu lub jako aktywność przypisana do konkretnego użytkownika. Treść komunikatu zwykle zawiera tytuł zdarzenia, opis, czas wystąpienia, identyfikator zgłoszenia oraz odnośnik do rekordu w systemie źródłowym. Dzięki temu odbiorca nie musi ręcznie sprawdzać kilku niezależnych aplikacji.

Przekazywanie dokumentów może polegać na wysłaniu pliku do rozmowy, udostępnieniu odnośnika albo umieszczeniu dokumentu w lokalizacji powiązanej z zespołem. Pliki przechowywane w kanale Teams są technicznie związane z biblioteką dokumentów witryny SharePoint, natomiast pliki udostępniane w prywatnych czatach mogą korzystać z przestrzeni OneDrive użytkownika. Z tego powodu poprawna integracja powinna rozróżniać typ konwersacji, miejsce docelowe oraz sposób nadawania uprawnień do dokumentu.

Mechanizmy wysyłania komunikatów

Jednym ze sposobów integracji jest użycie Microsoft Graph, czyli interfejsu API obsługującego między innymi zespoły, kanały, czaty, wiadomości i pliki powiązane z usługami Microsoft 365. Aplikacja wywołująca API musi uzyskać token dostępu za pośrednictwem platformy tożsamości Microsoft i otrzymać odpowiednie uprawnienia. Zakres wymaganych uprawnień zależy od operacji: innego dostępu wymaga odczyt zespołów, innego wysłanie wiadomości, a jeszcze innego zapis lub udostępnienie pliku. Należy również uwzględnić, czy zgoda jest nadawana przez użytkownika, czy przez administratora dzierżawy.

W prostszych scenariuszach powiadomienie może być przekazywane przez adres URL webhooka albo przez przepływ w Power Automate. Rozwiązanie tego typu przyjmuje żądanie HTTP zawierające dane zdarzenia i tworzy komunikat w skonfigurowanej lokalizacji Teams. Format danych musi odpowiadać wymaganiom wybranego mechanizmu, ponieważ klasyczne konektory, przepływy oraz nowsze rozwiązania oparte na aplikacjach Teams nie zawsze obsługują identyczne karty i pola. Przy projektowaniu należy sprawdzić rozmiar wiadomości, obsługiwane załączniki, limity wywołań oraz sposób sygnalizowania błędów przez usługę.

Dokumenty, linki i obsługa błędów

Wiadomość zawierająca dokument nie powinna być traktowana jako zwykły tekst z nazwą pliku. System musi ustalić, czy przekazuje rzeczywiste dane binarne, czy tylko adres do pliku znajdującego się w SharePoint albo OneDrive. W drugim przypadku odbiorca potrzebuje dostępu do lokalizacji źródłowej, a sam link powinien prowadzić do konkretnego zasobu, a nie do ogólnej strony zespołu. Warto zachować nazwę pliku, rozszerzenie, rozmiar, identyfikator dokumentu i datę utworzenia, ponieważ te informacje ułatwiają późniejsze sprawdzenie, czy przekazanie zakończyło się prawidłowo.

Integracja powinna rejestrować wynik każdej próby wysyłki. Kod odpowiedzi HTTP, identyfikator wiadomości, identyfikator pliku oraz komunikat zwrócony przez API pozwalają odróżnić błąd uwierzytelnienia od braku uprawnień, nieistniejącego kanału, przekroczenia limitu lub chwilowej niedostępności usługi. Przy odpowiedzi informującej o ograniczeniu liczby żądań aplikacja powinna zastosować ponowienie zgodne z informacją o czasie oczekiwania, zamiast wysyłać kolejne żądania w niekontrolowanej pętli. Dobrą praktyką jest także nadawanie zdarzeniom unikalnych identyfikatorów i sprawdzanie ich przed ponowną wysyłką, aby awaria sieci nie spowodowała wielokrotnego opublikowania tego samego powiadomienia.

Sprawdzenie integracji Teams na komputerze firmowym

Podczas diagnostyki na laptopie lub komputerze PC należy najpierw ustalić, jaki wariant integracji został wdrożony: Microsoft Graph, webhook, Power Automate czy aplikacja Teams. Następnie można porównać czas utworzenia zdarzenia w systemie źródłowym z czasem pojawienia się wiadomości w Teams. Trzeba sprawdzić, czy komunikat trafia do właściwego zespołu, kanału lub czatu, czy odnośnik otwiera się w przeglądarce albo aplikacji Teams oraz czy użytkownik ma uprawnienia do odczytu wskazanego dokumentu. Jeżeli powiadomienia nie docierają, przydatne są logi aplikacji, historia uruchomień przepływu oraz odpowiedzi API.

Problemy mogą wynikać również z konfiguracji komputera: zablokowanych żądań HTTPS, nieaktualnej aplikacji Teams, błędnej sesji konta Microsoft, rozszerzeń przeglądarki albo filtracji ruchu przez lokalny program bezpieczeństwa. Samo ponowne uruchomienie Teams nie naprawi wygasłego tokenu, odebranej zgody administracyjnej ani usuniętego kanału docelowego. Warszawskie Pogotowie Komputerowe zajmuje się profesjonalną naprawą laptopów, komputerów PC oraz ich podzespołów, a w ramach diagnostyki może sprawdzić lokalne przyczyny problemów z aplikacją Teams i połączeniem z usługami Microsoft 365.