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

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

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

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

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

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.

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.

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.

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

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.

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.

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.

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.

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

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.

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

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

Damit ist der Bot dem Supporter-Team hinzugefügt.
Kanal Konfiguration
Die Konfiguration erfolgt im Team mit den zwei Kanälen.

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:

@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:

@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:

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.

Im folgenden Dialog wird die SmartSupport App ausgewählt.

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

Damit ist die Einrichtung abgeschlossen.