Opanowanie kart, botów i rozszerzeń w Microsoft Teams
By Mirko Peters ·
Witamy ponownie w podcaście! Jeśli kiedykolwiek zastanawiałeś się, jak zamienić codzienną platformę do współpracy w potężne narzędzie zwiększające produktywność, trafiłeś we właściwe miejsce. Dziś rozwijamy nasz ostatni odcinek i zagłębiamy się w podstawy tworzenia aplikacji dla Microsoft Teams. Łącząc podstawowe filary architektury, czyli karty, boty i rozszerzenia wiadomości, możesz usprawnić pr
Automatically translated with AI from the original post. Read the English original
Witamy ponownie w podcaście! Jeśli kiedykolwiek zastanawiałeś się, jak zamienić codzienną platformę do współpracy w potężne narzędzie zwiększające produktywność, trafiłeś we właściwe miejsce. Dziś rozwijamy nasz ostatni odcinek i zagłębiamy się w podstawy tworzenia aplikacji dla Microsoft Teams. Łącząc podstawowe filary architektury, czyli karty, boty i rozszerzenia wiadomości, możesz usprawnić przepływ pracy zespołu i wyeliminować tarcie wynikające z przełączania kontekstu.
Jeśli nie słuchałeś jeszcze powiązanego odcinka audio, koniecznie sprawdź odcinek Build Microsoft Teams Apps with Bots, Tabs, and Extensions. W tej rozmowie omawiamy rzeczywiste scenariusze wykorzystania ekosystemu Microsoft 365. W tym wpisie na blogu rozłożymy te koncepcje na czynniki pierwsze, przeanalizujemy krok po kroku proces tworzenia i przyjrzymy się najlepszym praktykom dotyczącym bezpieczeństwa, wdrażania oraz projektowania UI/UX.
Niezależnie od tego, czy jesteś doświadczonym deweloperem enterprise, czy entuzjastą low-code, który chce automatyzować procesy zespołowe, opanowanie tych podstawowych komponentów zmieni sposób, w jaki Twoja organizacja wykonuje pracę.
Wprowadzenie do tworzenia aplikacji dla Microsoft Teams
Microsoft Teams wyszedł daleko poza prostego klienta do czatu i spotkań. Obecnie to kompleksowa platforma dla nowoczesnej pracy. Tworzenie aplikacji niestandardowych pozwala organizacjom połączyć wewnętrzne narzędzia z codzienną komunikacją. Zamiast zmuszać pracowników do przeskakiwania między dziesiątkami różnych aplikacji webowych, możesz przenieść dane, pulpity i zautomatyzowane działania bezpośrednio w przepływ rozmowy.
Tworzenie aplikacji dla Teams oznacza korzystanie z bogatego ekosystemu. Możesz udostępniać strony internetowe jako trwałe karty, wdrażać konwersacyjne agenty AI do obsługi rutynowych zapytań i budować rozbudowane rozszerzenia wiadomości, które pozwalają użytkownikom przeszukiwać zewnętrzne bazy danych bez opuszczania okna tworzenia wiadomości. Nowoczesny zestaw narzędzi dla deweloperów sprawia, że ta droga jest łatwiejsza niż kiedykolwiek, zapewniając szkielety projektów, lokalne debugowanie i usprawnione wdrażanie w chmurze.
Wymagania wstępne dla tworzenia aplikacji niestandardowych
Zanim napiszesz pierwszy wiersz kodu, musisz skonfigurować środowisko deweloperskie i uzyskać odpowiednie uprawnienia administracyjne. Tworzenie aplikacji niestandardowych wymaga uporządkowanego podejścia, które zapewni zgodność z przepisami i sprawne testowanie.
Konto Microsoft 365 i konfiguracja administracyjna
Do uzyskania dostępu do platformy deweloperskiej Microsoft Teams potrzebujesz służbowego lub szkolnego konta Microsoft 365. Ponadto administratorzy IT Twojej organizacji muszą włączyć zasady zezwalające na przesyłanie aplikacji niestandardowych. Wykonaj poniższe kroki, aby sprawdzić lub zmienić ustawienia dzierżawy:
- Zaloguj się do centrum administracyjnego Teams.
- Przejdź do pozycji Aplikacje Teams i wybierz pozycję Zasady konfiguracji.
- Dodaj nową zasadę lub edytuj istniejącą.
- Ustaw opcję Przekaż aplikacje niestandardowe na włączoną.
- Zapisz zasadę i przypisz ją do docelowej grupy użytkowników.
Wskazówka: Zawsze koordynuj działania z administratorem IT na wczesnym etapie projektu, aby upewnić się, że Twoje konto ma odpowiednie uprawnienia do sideloadingu i testowania pakietów niestandardowych.
Wymagane narzędzia i oprogramowanie
Lokalny komputer potrzebuje określonego zestawu narzędzi do kompilowania, pakowania i debugowania aplikacji Teams. Poniższa tabela przedstawia podstawowy zestaw oprogramowania:
| Narzędzie | Przeznaczenie |
|---|---|
| Visual Studio Code | Podstawowy edytor kodu do tworzenia w JavaScript, TypeScript lub w frameworkach webowych. |
| Microsoft Teams Toolkit | Upraszcza tworzenie szkieletu projektu, lokalne debugowanie i udostępnianie zasobów w chmurze. |
| Node.js | Środowisko uruchomieniowe JavaScript po stronie serwera, niezbędne do uruchamiania lokalnych usług aplikacji. |
| ngrok (lub podobne narzędzie tunelujące) | Bezpiecznie udostępnia lokalny serwer deweloperski w publicznym internecie na potrzeby integracji webhooków Teams. |
Zrozumienie podstawowych możliwości aplikacji Teams
Każde niestandardowe rozwiązanie opiera się na jednej lub większej liczbie podstawowych możliwości udostępnianych przez platformę. Wybór właściwej możliwości zapewnia, że aplikacja będzie odpowiadać wymaganiom biznesowym.
- Karty: Widoki webowe osadzone bezpośrednio w kanale zespołu, czacie lub zakresie osobistym aplikacji. Idealne do hostowania pulpitów, narzędzi do śledzenia projektów i wewnętrznych portali webowych.
- Boty: Interfejsy konwersacyjne, które odpowiadają na zapytania użytkowników, wykonują zautomatyzowane zadania i wysyłają proaktywne powiadomienia.
- Rozszerzenia wiadomości: Skróty zintegrowane z polem tworzenia wiadomości, które pozwalają użytkownikom przeszukiwać systemy zewnętrzne, wypełniać interaktywne formularze lub rozwijać udostępnione linki.
Łącząc te możliwości w jednym pakiecie aplikacji, możesz stworzyć spójne doświadczenie użytkownika, które obsługuje jednocześnie wiele scenariuszy.
Opanowanie rozszerzeń wiadomości w Teams
Rozszerzenia wiadomości wzbogacają standardowe interakcje w czacie, łącząc rozmowy z zewnętrznymi źródłami danych. Możesz wdrożyć trzy główne typy rozszerzeń:
- Polecenia wyszukiwania: Odpytują systemy zewnętrzne, takie jak CRM czy baza danych magazynowych, i umieszczają ustrukturyzowane wyniki bezpośrednio w wiadomości czatu.
- Polecenia akcji: Wywołują modalne okno formularza, które zbiera dane wejściowe od użytkownika, przesyła dane lub generuje dynamiczną zawartość.
- Rozwijanie linków: Automatycznie zamienia zwykłe adresy URL udostępnione w czacie w bogate, interaktywne karty z rozbudowanym podglądem.
Rozwiązania takie jak rozszerzenia wiadomości w usłudze Microsoft Teams pokazują, jak asynchroniczne rozwijanie linków i polecenia wyszukiwania mogą znacznie skrócić czas poszukiwania informacji w rozproszonych systemach przedsiębiorstwa.
Proces tworzenia krok po kroku
Tworzenie pierwszej aplikacji Teams przebiega według przewidywalnego cyklu życia: od inicjalizacji, przez pakowanie, po testowanie.
- Utwórz strukturę projektu: Użyj rozszerzenia Teams Toolkit w programie Visual Studio Code, aby wygenerować szablon projektu startowego.
- Skonfiguruj manifest: Zdefiniuj tożsamość aplikacji, ikony i możliwości w pliku manifestu JSON.
- Zbuduj główne funkcje: Twórz karty frontendu przy użyciu React lub standardowych technologii webowych i zaimplementuj logikę bota za pomocą zestawu SDK Bot Framework.
- Testuj lokalnie: Uruchom lokalny serwer, utwórz tunel ngrok i załaduj pakiet aplikacji bocznym wczytaniem do osobistego klienta Teams.
- Przygotuj pakiet do dystrybucji: Spakuj manifest i ikony do pliku .zip, aby wdrożyć go w całej dzierżawie lub przesłać do sklepu z aplikacjami.
Integracja Microsoft Graph i interfejsów API
Aby Twoja własna aplikacja była naprawdę inteligentna, połącz ją z Microsoft Graph. Graph udostępnia jeden punkt końcowy do dostępu do danych organizacji w usługach Microsoft 365, w tym profili użytkowników, wydarzeń kalendarza, plików i historii czatów.
Dzięki punktom końcowym Graph API Twoja aplikacja może automatycznie tworzyć nowe kanały, publikować alerty systemowe w wątkach czatu i egzekwować zasady bezpieczeństwa klasy enterprise za pomocą uwierzytelniania Azure AD. Zewnętrzne interfejsy REST API można także powiązać z przepływami pracy bota, dzięki czemu Teams stanie się jednym punktem dostępu do całego oprogramowania przedsiębiorstwa.
Testowanie lokalne i debugowanie
Testowanie lokalne jest kluczowe przed wdrożeniem jakiegokolwiek kodu na środowisko produkcyjne. Ponieważ Teams działa w chmurze i komunikuje się z aplikacją za pomocą webhooków, musisz użyć bezpiecznych narzędzi tunelowania, takich jak ngrok, aby zmapować lokalne środowisko na publiczny adres URL HTTPS.
Podczas testów każdy deweloper powinien wczytywać własną instancję pakietu aplikacji, aby uniknąć kolizji konfiguracji. Skorzystaj z narzędzi deweloperskich przeglądarki w Microsoft Edge lub Google Chrome, aby analizować ruch sieciowy, debugować skrypty po stronie klienta i dopracowywać responsywne układy.
Strategie wdrażania i dystrybucji
Gdy aplikacja zostanie gruntownie przetestowana, musisz zdecydować, w jaki sposób udostępnić ją użytkownikom:
- Wczytywanie boczne: Najlepsze do wstępnych testów i małych zespołów deweloperskich.
- Katalog aplikacji organizacji: Prześlij pakiet aplikacji do prywatnego sklepu z aplikacjami dzierżawy w celu wewnętrznego zarządzania i szerokiego wdrożenia w firmie.
- Sklep Microsoft Teams: Prześlij rozwiązanie do Partner Center, aby było publicznie widoczne i dostępne dla przedsiębiorstw na całym świecie.
Przed przesłaniem aplikacji do formalnego przeglądu upewnij się, że wszystkie wymagane zasady prywatności, warunki korzystania oraz linki do pomocy technicznej są aktywne i publicznie dostępne.
Najlepsze praktyki UI i UX
Wyjątkowy interfejs użytkownika zapewnia wysoki poziom adopcji w całej organizacji. Stosuj poniższe wytyczne projektowe, aby Twoja aplikacja wyglądała jak natywna część Teams:
- Trzymaj się standardów projektowych Microsoft, używając typografii Segoe UI i obsługując motywy jasny, ciemny oraz wysokiego kontrastu.
- Wykorzystuj komponenty Fluent UI React w kartach i modułach zadań, aby zachować spójność wizualną z resztą Teams.
- Używaj Adaptive Cards w wiadomościach i powiadomieniach, aby interfejs poprawnie wyświetlał się w klientach desktopowych, webowych i mobilnych.
- Uwzględnij funkcje dostępności, takie jak zgodność z czytnikami ekranu, nawigacja klawiaturą oraz odpowiednie teksty alternatywne dla obrazów.
Zabezpieczenia, zgodność i uwierzytelnianie
Aplikacje dla przedsiębiorstw muszą spełniać rygorystyczne wymagania bezpieczeństwa. Zawsze zabezpieczaj swoją aplikację za pomocą Microsoft Entra ID (dawniej Azure AD) i wdrażaj protokół OAuth 2.0 do uwierzytelniania opartego na tokenach.
Stosuj zasadę najmniejszych uprawnień, żądając wyłącznie tych uprawnień Graph, których aplikacja faktycznie wymaga. Upewnij się, że wszystkie dane są szyfrowane zarówno podczas transmisji, jak i w spoczynku, oraz zapoznaj się z normami zgodności obowiązującymi w Twojej organizacji, takimi jak RODO, HIPAA i standardy ISO.
Utrzymanie i aktualizacja aplikacji Teams
Tworzenie aplikacji nie kończy się na wdrożeniu. Długoterminowy sukces wymaga aktywnego utrzymania, monitorowania wydajności i ciągłego doskonalenia na podstawie opinii użytkowników.
Ustal jasną strategię wersjonowania w manifeście aplikacji za każdym razem, gdy wprowadzasz nowe funkcje lub poprawki błędów. Wykorzystaj Azure Application Insights do śledzenia danych telemetrycznych, monitorowania wskaźników błędów i mierzenia adopcji funkcji. Na koniec zapewnij łatwo dostępny mechanizm wsparcia — na przykład dedykowany kanał opinii w usłudze Teams — aby użytkownicy mogli bez trudu zgłaszać sugestie i problemy.
Podsumowanie
Opanowanie kart, botów i rozszerzeń wiadomości otwiera wiele możliwości w zakresie usprawnienia współpracy w Twojej organizacji. Stosując uporządkowane praktyki tworzenia, stawiając na bezpieczeństwo i projektując intuicyjne interfejsy użytkownika, możesz budować niestandardowe rozwiązania, które naprawdę usprawniają codzienną pracę.
Aby zgłębić praktyczne wdrożenia, koniecznie posłuchaj towarzyszącego odcinka podcastu: Build Microsoft Teams Apps with Bots, Tabs, and Extensions. Poznaj zasoby dla deweloperów Microsoft 365, przygotuj swój zestaw narzędzi i zacznij już dziś budować pierwszą niestandardową aplikację Teams!