Installationshandbuch

Voraussetzungen

Für die Installation von SmartSupport in einer Organisation gelten folgende Voraussetzungen:

  • Administrator mit Microsoft Teams Privilegien

  • REALTECH SmartSupport App (Zip-Datei, wird nicht entpackt)

  • Ein Benutzer auf dem SmartITSM SaaS Mandanten

  • Konfigurations-Keys (werden von REALTECH bereitgestellt)

Die Schritte der Installation bzw. des Updates werden in der beschriebenen Reihenfolge ausgeführt, um Fehler zu vermeiden.

Organisation

Die Installation beginnt im Microsoft Teams Admin Center (https://admin.teams.microsoft.com/). Dort sind alle Apps aufgeführt, die in der Teams-Anwendung der Organisation verfügbar sind.

Installation

Im Admin Center führt das linke Menü über "Teams apps" zu "Manage Apps".

../../_images/INSTALL_Admin_center_overview.png

Oben rechts öffnet "Actions" ein Popover mit dem Eintrag "+ Upload new App".

../../_images/INSTALL_Upload_button.png

Daraufhin öffnet sich ein Dialog zum Hochladen der SmartSupport App. Über die Schaltfläche "Upload" wird die Datei "appPackage.prod.zip" ausgewählt.

../../_images/INSTALL_Upload_Dialog.png

Ob das Hochladen erfolgreich war, zeigt die Tabelle: Erscheint die SmartSupport App bei der Suche in der Tabelle, ist die Installation abgeschlossen.

../../_images/INSTALL_FilterInTabelle.png

Update

Im Admin Center führt das linke Menü über "Teams apps" zu "Manage Apps". Dort wird die SmartSupport App in der Tabelle gesucht.

../../_images/UPDATE_AdminTeamsCenterTabelle.png

Ein Klick auf den Namen "SmartSupport" öffnet die Detailseite der App. Für ein Update wird dort über "Upload file" die von REALTECH bereitgestellte "appPackage.prod.zip" hochgeladen. Die Detailseite ist wie folgt dargestellt. Nach dem Hochladen zeigt "Published version" die neue Version.

../../_images/UPDATE_TeamsAdminCenterAPP.png

Zeigt die Seite weiterhin die alte Version, hilft ein Neuladen der Seite (STRG + R).

Teams

Nach dem Hochladen erscheint die SmartSupport App in der Teams-Anwendung unter "Apps" > "Für Ihre Organisation entwickelt". Ist sie dort noch nicht sichtbar, ist die Synchronisation noch nicht abgeschlossen; laut Microsoft kann sie bis zu 24 Stunden dauern.

../../_images/TEAMS_StoreTeams.png

Die weitere Installation und Konfiguration setzt voraus, dass die App dort verfügbar ist.

Installation von SmartSupport in Microsoft Teams

Dieser Abschnitt beschreibt die Installation der SmartSupport App als Anwender. Der installierende Administrator führt diesen Schritt ebenfalls aus, bevor die weitere Einrichtung folgt.

Die SmartSupport App steht unter "Apps" > "Für Ihre Organisation entwickelt" bereit. Die Schaltfläche "Hinzufügen" startet die Installation.

../../_images/INSTALL_Store.png

Ein Dialog zeigt weitere Informationen zur SmartSupport App. Ein erneutes "Hinzufügen" schließt die Installation ab.

../../_images/INSTALL_Store_Details.png

Nach der Installation öffnet sich automatisch der Bot.

Bei der ersten Installation fragt der Bot die gewünschte Sprache ab.

Anschließend zeigt der Bot die Willkommenskarte.

Neues Team erstellen

Dieser Schritt legt ein Team und dessen Kanäle an. In der Teams-Anwendung wird unter "Teams" über die Schaltfläche "+" die Funktion "Team erstellen" gewählt.

../../_images/TEAMS_New_Team.png

Im folgenden Dialog wird ein Name für das Support-Team vergeben. Der Name ist frei wählbar und lässt sich jederzeit ändern. Das Team wird als privat angelegt, da nicht jede Person Zugriff erhalten soll.

../../_images/TEAMS_NewTeamDialog.png

Nach der Erstellung fragt Teams, ob Mitglieder hinzugefügt werden sollen. Dieser Schritt wird übersprungen: Supporter werden erst in das Team aufgenommen, nachdem sie die App selbst installiert haben.

../../_images/TEAMS_Team_MemberX.png

Kanäle erstellen

Das Team erhält zwei Kanäle: einen für die "Störungen" und einen für die "Serviceanfragen". Die folgenden Schritte werden deshalb zweimal ausgeführt.

Über die drei Punkte des Teams wird die Funktion "Kanal hinzufügen" gewählt.

../../_images/TEAMS_Add_Channel.png

Im folgenden Dialog wird der Kanalname eingetragen (z. B. Störungen) und als Kanaltyp "Standard" gewählt.

../../_images/TEAMS_Channel.png

Damit ist der erste Kanal erstellt. Der Vorgang wiederholt sich für den Kanal "Serviceanfragen". Auch zu diesem Zeitpunkt werden noch keine Personen zum Team hinzugefügt.

Bot zum Team hinzufügen

Unter "Apps" > "Für Ihre Organisation entwickelt" öffnet ein Klick auf die Karte der SmartSupport App deren Details.

../../_images/TEAMS_StoreTeams.png

Die Details der SmartSupport App erscheinen in einem Dialog. Der nach unten zeigende Pfeil rechts neben der Schaltfläche "Öffnen" öffnet ein Popup mit der Option "Zu einem Team hinzufügen".

../../_images/TEAMS_Bot_to_Team.png

In einem weiteren Dialog wird das zuvor erstellte Team bzw. der Kanal gesucht und ausgewählt. Der nach unten zeigende Pfeil rechts neben der Schaltfläche "Einreichen" öffnet ein Popup mit der Option "Bot einrichten".

../../_images/TEAMS_Link_to_Team.png

Damit ist der Bot dem Supporter-Team hinzugefügt.

Kanal Konfiguration

Die Konfiguration erfolgt im Team mit den zwei Kanälen.

../../_images/TEAMS_Kanaele.png

Kanal Definition

In diesem Schritt erfährt der bereits hinzugefügte Bot, in welchem Kanal die Störungen erscheinen. Dazu wird im Kanal "Störungen" über die Schaltfläche "Einen Beitrag starten" folgender Beitrag verfasst:

../../_images/TEAMS_Setup_Channel.png

@SmartSupport channel --ticketType Incident --name Incidents --locale en-US

Der SmartSupport Bot zeigt damit alle Störungen in diesem Kanal an.

Anschließend folgt der zweite Kanal (Serviceanfragen).

Dort wird ebenfalls über "Einen Beitrag starten" ein Beitrag verfasst:

../../_images/TEAMS_Setup_Serviceanfragen.png

@SmartSupport channel --ticketType Incident --name Incidents --locale en-US

Der SmartSupport Bot zeigt damit alle Serviceanfragen in diesem Kanal an.

SmartITSM Anbindung

Im vorletzten Schritt wird das System mit SmartITSM verbunden. Den Zugangsschlüssel dafür stellt REALTECH vorab bereit. Im Kanal "Störungen" wird über die Schaltfläche "Einen Beitrag starten" ein Beitrag verfasst:

../../_images/TEAMS_ConnectSmartITSM.png

Der Beitrag enthält den Befehl in folgender Form:

⁠@SmartSupport dot4 --tenantId **************************** --tenantName ******** --defaultEmail ************** --domain ******** --incidentTypeId **** --apiKey *********************************************************

[!NOTE]

Dieser Schritt wird für den Kanal "Serviceanfragen" wiederholt.

Registrierkarte hinzufügen

Für die Supporter steht ein Frontend bereit, das alle Störungen in Listenform zeigt. Es wird im Kanal "Störungen" über das "+" im oberen Menü hinzugefügt.

../../_images/TEAMS_SupporterTicketList.png

Im folgenden Dialog wird die SmartSupport App ausgewählt.

../../_images/TEAMS_SupporterTicketTab.png

Anschließend enthält der Kanal eine neue Registerkarte mit dem Namen "Ticket List".

../../_images/TEAMS_TicketList.png

Damit ist die Einrichtung abgeschlossen.