Teams Bot - Przewodnik Konfiguracji
Narzędzie do Zarządzania Usługami Efecte
Spis Treści
- Krótki Opis
- Długi Opis
- Pobierz Konfigurację Microsoft Teams dla Platformy Zarządzania Usługami Efecte
- Konfiguracja Importowanego Szablonu
- Dodawanie Zaimportowanych Pól do Szablonów
- Importowanie Słuchaczy dla Teams Connector
- Dodaj URL Bota do Ustawień Platformy
- Dodaj Bota do Microsoft Teams
- Dodaj Identyfikator Kanału Microsoft Teams do Grupy Wsparcia
- Tworzenie Incydentu i Wysyłanie Powiadomień
- Wymagane Pliki
- Komendy Bota
- Wideo Konfiguracyjne
- Wsparcie Konsumenta
Krótki Opis
Powiadamiaj użytkowników Teams o utworzeniu nowego zgłoszenia do ich grupy wsparcia w Efecte.
Długi Opis
Aplikacja Efecte do Zarządzania Usługami (ESM) usprawnia współpracę zespołu w celu wspierania klientów i innych zespołów, powiadamiając użytkowników za każdym razem, gdy nowe zgłoszenie zostało przypisane do zespołu.
Dzięki aplikacji można płynnie zintegrować platformę Efecte do Zarządzania Usługami z Microsoft Teams i powiadamiać członków grupy wsparcia za każdym razem, gdy do grupy wsparcia w ESM zostanie utworzone nowe zgłoszenie. Zapewnia to personelowi pomocy technicznej lepszy wgląd w kolejkę zgłoszeń i umożliwia szybsze reagowanie na nowe zgłoszenia.
Aplikacja używa detektorów ESM do wysyłania powiadomień do Microsoft Teams. Należy pamiętać, że konfigurowanie słuchaczy w ESM wymaga uprawnień administratora, a nasłuchiwacze wysyłania powinny być skonfigurowane dla każdego szablonu, z którego mają być wysyłane powiadomienia do Microsoft Teams.
Konfiguracja
Pobierz konfigurację Microsoft Teams dla platformy Zarządzania Usługami Efecte
Konfiguracja Importowanego Szablonu
Uwaga! Konfiguracja ESM wymaga uprawnień administracyjnych
Zaloguj się do instancji ESM
Otwórz stronę "Administration" w prawym górnym rogu
Przejdź do "Templates"
Kliknij “Templates” i “Import”
Wybierz “Source: File” i kliknij “Choose file”
Znajdź poprzednio pobrany plik (MS_Teams_configuration_template.xml) i dodaj go.
Uwaga! Przed zaimportowaniem szablonów warto upewnić się, że nie istnieją szablony o tym samym kodzie (ms_teams_integration)! W przeciwnym razie istniejące dane mogą zostać usunięte.
Kliknij “Ok” w dolnym lewym rogu
Kliknij “Ok” w lewym dolnym rogu, by zatwierdzić import i kontynuować import Ms_Teams_configuration_template.xml do ESM
Teraz powinieneś zobaczyć szablon “MS Teams” pod “IT Service Management”
Dodawanie Zaimportowanych Pól do Szablonów
Na stronie "Administration" w sekcji "Templates" i "IT Service Management" otwórz szablon "Incident".
Kliknij "Select classes", znajdź "MS Teams Integration", zaznacz pole wyboru obok niego, a następnie kliknij "Save".
Ustaw "Order" klasy tak, aby była pierwszą klasą w szablonie, np. 0.
Otwórz moduł "Organization" i szablon "Support Group".
Kliknij "Select classes", znajdź "MS Teams channel information", zaznacz pole wyboru obok niego, a następnie kliknij "Save".
Ustaw "Order" klasy na np. 350.
Uwaga! Zaktualizuj adres URL instancji ESM do pola "Ticket link" -> Attribute metadata -> Adres URL aplikacji. Klasy te mogą być również importowane do innych szablonów.
Importowanie Słuchaczy dla Teams Connector
Na stronie "Administration" w sekcji "IT Service Management" otwórz szablon "Incident".
Znajdź "Data card Listeners" i kliknij "Import".
Wybierz "Source: File", znajdź wcześniej pobrany plik "Postsave - Send to Teams bot.xml" i dodaj go. Następnie kliknij "Ok", aby zaimportować słuchacza i "OK" na "Confirm import".
Wykonaj te same kroki dla słuchacza "Presave - Update Support Group.xml".
Kliknij "Back", aby otworzyć szablon "Incident" i upewnij się, że te dwa słuchacze znajdują się na liście "Data card Listeners" z nazwami
- “Postsave.TeamsConnector.Send to Teams bot”
- “Presave.TeamsConnector.Update Support group”.
Uwaga! Słuchacze mogą być również importowani do innych szablonów, jeśli wcześniej zaimportowali pola z klasy "MS Teams Integration".
Dodaj URL Bota do Ustawień Platformy
Na stronie “Administration”, w sekcji “Maintenance”, otwórz “System settings” i “Edit Platform settings”
Na dole strony znajdują się “Name” and “Value”
Dodaj następujące elementy i kliknij “Add new setting”
- Name: EIS.teamsbot.url
- Value: https://efecteservicemanagementappservice.azurewebsites.net/api/esmnotify
Dodaj Bota do Microsoft Teams
Aby dodać aplikację (lub bota) do zespołu, przejdź do zespołu, do którego chcesz dodać bota i wybierz ikonę "Apps" z lewego dolnego menu.
Wyszukaj Efecte Service Management i kliknij "Add to a team".
Użyj użytkownika Web API, aby się zalogować
Dodaj Identyfikator Kanału Microsoft Teams do Grupy Wsparcia
Po skonfigurowaniu bota w Microsoft Teams przejdź do kanału, na który mają być wysyłane powiadomienia.
Na kanale wpisz na czacie "@Efecte Service Management show channel id".
Skopiuj pogrubiony identyfikator kanału i otwórz ESM
Wybierz "New view", wpisz "Support group" i otwórz go.
Otwórz grupę wsparcia, która powinna otrzymywać powiadomienia
Kliknij "Edit all" w prawym górnym rogu.
Znajdź pole "Teams Channel Id" i wklej identyfikator kanału pokazany w Microsoft Teams.
Kliknij "Save"
Tworzenie Incydentu i Wysyłanie Powiadomień
Teraz, gdy grupa wsparcia ma identyfikator kanału Microsoft Teams, możemy przetestować tworzenie zgłoszeń
Otwórz ESM, wybierz "New view", wpisz "Incident" i otwórz go.
Kliknij "+ New", aby otworzyć okno tworzenia.
Wypełnij wszystkie obowiązkowe pola (pola z czerwoną ramką).
Pamiętaj, aby wybrać grupę wsparcia, do której dodałeś identyfikator kanału Microsoft Teams.
Kliknij "Save" i przejdź do Microsoft Teams, aby zobaczyć, że powiadomienie o incydencie zostało wysłane na dany kanał grupy wsparcia.
I gotowe!
Uwaga! Jeśli nic nie zostało wysłane do Microsoft Teams, sprawdź, czy grupa wsparcia, ustawiona na incydent, ma ustawiony Channel ID.
Komendy Bota
"reset esm" (ukryte) Resetuje adres URL, nazwę użytkownika i hasło Efecte ESM.
"delete esm" (ukryte) Usuwa adres URL, nazwę użytkownika i hasło Efecte ESM. Odłącza aplikację od instancji Efecte.
"show channel id" Pokazuje identyfikator kanału, na którym zainstalowany jest bot.
"show bot url" pokazuje adres URL bota "Esm Notify". Ten adres URL jest zapisywany w ustawieniach platformy ESM.
"create incident" tworzy incydent w ESM.