Teams Bot - Przewodnik Konfiguracji

Powiadamiaj użytkowników Teams o utworzeniu nowego zgłoszenia do ich grupy wsparcia w Efecte.

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.

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”

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.

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".

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

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ć

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"

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.

Postsave - Send to Teams Bot

Presave - Update Support Group

Microsoft Teams Configuration Template