Integration in Microsoft Teams

Der erste Schritt besteht im Erstellen einer App in Microsoft Teams.

So erstellen Sie die Teams-App:

1. Melden Sie sich als Administrator bei Microsoft Teams an.
2. Machen Sie auf der Registerkarte Apps den Eintrag App Studio ausfindig und fügen Sie ihn hinzu.
3. Wählen Sie auf der Registerkarte Manifest-Editor von App Studio die Option Neue App erstellen aus.
4. Geben Sie mindestens folgende Werte an:
• Kurzbezeichnung
• Vollständiger Name
• Kurzbeschreibung
• Vollständige Beschreibung
• Paketname (z. B. ihrfirmenname.isdteamsapp.com)
• Version (z. B. 1.0.0)
• Kurzbeschreibung
• Vollständige Beschreibung
• Entwicklerangaben (z. B. Ihr Name und die Adresse Ihrer Firmenwebsite)
• URL zur Website (erfordert https://)
• URL zur Datenschutzrichtlinie (erfordert https://)
• URL zu Nutzungsbedingungen (erfordert https://)
5. Klicken Sie auf Generieren.
   Die App-ID wird generiert.
6. Wählen Sie unter Fähigkeiten die Option Bots aus und klicken Sie anschließend auf Einrichten.
7. Geben Sie einen Namen ein, wählen Sie Mein Bot ist ein unidirektionaler Benachrichtigungsbot aus und legen Sie als Bereich den Wert Team fest.
8. Klicken Sie auf Bot erstellen.
   Der Bot wird erstellt und auf der Seite "Bots" angezeigt. Es wird die ID angezeigt, die bei den Service Desk-Systemeinstellungen als Bot-ID verwendet wird.
   
9. Klicken Sie auf Neues Kennwort generieren.
   Es wird ein Kennwort erstellt, das später bei den Service Desk-Systemeinstellungen als Bot-Kennwort verwendet wird.
10. Geben Sie eine Bot-Endpunktadresse in folgendem Format ein:
    https://[URL zu Server]/[Name der Frameworkinstanz]/api/messages?v=*
    Beispiel:
    https://mein.beispiel.org/servicedesk.framework.web/api/messages?v=*
11. Laden Sie die Teams-App von der Registerkarte Testen und verteilen als zip-Datei herunter.
    

Nachdem Sie die App erstellt haben, müssen Sie sie hochladen.

So laden Sie die Teams-App für Ihr Unternehmen hoch:

1. Melden Sie sich als Administrator bei Teams an.
2. Klicken Sie auf der Registerkarte Apps auf Benutzerdefinierte App hochladen und laden Sie die oben erwähnte zip-Datei hoch.
   Für die hochgeladene App wird eine Kachel angezeigt.
3. Klicken Sie auf die Kachel für die App und dann auf Einem Team hinzufügen.
4. Machen Sie das gewünschte Team ausfindig und klicken Sie auf Bot einrichten.
   Die Teams-App wird für das ausgewählte Team installiert.

Sie können jetzt Service Desk für die Verwendung der Teams-App konfigurieren. Anschließend können Sie in Teams Benutzer zum Team hinzufügen.

Nachdem Sie die Teams-App erstellt und hochgeladen haben, können Sie die Integration zwischen der App und Service Desk konfigurieren. Dieser Vorgang besteht aus folgenden Schritten: Hinzufügen einiger Service Desk-Systemeinstellungen über die Teams-App-Konfiguration, Hinzufügen eines Mitglieds zum jeweiligen Team und erneutes Aufrufen der Service Desk-Systemeinstellungen, um die Integration zu aktivieren und weiter zu konfigurieren.

So konfigurieren Sie die Integration zwischen Service Desk und der Teams-App:

1. Melden Sie sich als Administrator bei der Service Desk Console an.
2. Klicken Sie im Menü Einstellungen auf System.
   Die Seite "Systemeinstellungen" wird angezeigt.
3. Legen Sie unter Teams-Integration die folgenden Werte fest:
   Bot-ID – Die ID, die in Microsoft Teams generiert wurde, als Sie den Bot erstellt haben.
   Bot-Kennwort – Das Kennwort, das in Microsoft Teams generiert wurde, nachdem Sie den Bot erstellt haben.
   Link zum Team – Die URL, die erstellt wurde, als Sie im Kontextmenü des Teams Link zum Team abrufen ausgewählt haben.
   URL zum Benachrichtigungsbild – Die URL zum Bild, das auf der Teambenachrichtigung angezeigt werden soll.
4. Speichern Sie die Einstellungen.
   Die nächste Phase ist das Festlegen des schreibgeschützten Werts für die Service-URL. Dies wird für Sie erledigt, wenn nach dem Ausführen der folgenden Schritte die erste Nachricht an das Service Desk Framework gesendet wird.
5. Stellen Sie im Service Desk Configuration Center den Framework App Pool wieder her.
6. Fügen Sie in Microsoft Teams einen Benutzer zu dem Team hinzu, für das die Service Desk-Benachrichtigungs-App installiert ist.
   Dadurch wird eine Nachricht an das Service Desk Framework gesendet und die Systemeinstellung Service-URL automatisch eingetragen.
7. Legen Sie auf der Seite "Service Desk-Systemeinstellungen" unter Teamintegration für Teambenachrichtigungen aktivieren den Wert Wahr fest und prüfen Sie, ob der Einstellung Service-URL ein Wert zugewiesen wurde.