Ihr nutzt Microsoft Teams und möchtet auch über Teams informiert bleiben? Kein Problem, ihr könnt über das App Studio in Teams eine App für euer COYO anlegen. Die neue App informiert die Nutzer, sobald in COYO ein Blog-Artikel auf einer Seite veröffentlicht wird, die die Nutzer abonniert haben.

 

Wir zeigen euch, wie es geht!

 

Schritt 1: „Developer Portal“ App in Teams herunterladen

Ihr geht in den Teams App-Store und sucht dort nach „Developer Portal“. Die App fügt ihr euren Teams Apps hinzu und wählt sie aus.

 

Schritt 2: Eine eigene Teams App erstellen

Mithilfe des Developer Portal könnt ihr eure eigene Teams App erstellen. Im Developer Portal geht ihr dafür oben auf den Reiter „Apps“ und wählt "+ Neue App" aus.

 

Schritt 3: Details hinterlegen

Ihr müsst der App einige Informationen wie u.a. Namen und eine Beschreibung mitgeben:

• App names:
  Hier gebt ihr der App einen kurzen Namen.
• Descriptions:
  Zur Orientierung gebt ihr der App eine Beschreibung mit. Im ersten Feld eine Kurzbeschreibung mit maximal 80 Zeichen und im zweiten Feld eine ausführlichere Beschreibung mit maximal 4000 Zeichen.
• Versions:
  
Im Feld "Version" können Sie selbständig eine Version für Ihre eigene Referenz notieren (wenn Sie die App z.B. zum ersten Mal erstellen, wird 1.0.0 empfohlen).
• Developer Information:
  Damit auch jeder weiß, wer die App entwickelt hat, hinterlegt ihr hier euren Unternehmensnamen und die URL eures Unternehmens.
• App URLs:
  Natürlich darf eine Datenschutzerklärung und Nutzungsbedingungen nicht fehlen. Hier verlinkt ihr auf die entsprechenden Datenschutzerklärungen und Nutzungsbedingungen eures Unternehmens.
• Application (client) ID:
  Dies ist die ID, die ihr in eurem Azure findet, wenn ihr die App-Registrierung für COYO erstellt.

Schritt 4: Branding

Ihr könnt eurer App ein entsprechendes Logo und eine Farbe geben - das springt den Nutzern direkt ins Auge und gibt Orientierung.

 

Schritt 5: Erstellt euren eigenen Bot

Damit eure Nutzer automatisch über eure Teams App benachrichtigt werden, wenn in COYO ein neuer Blog-Artikel veröffentlicht wurde, braucht ihr einen Bot.

 

In der linken Navigation des Developer Portal geht ihr auf "App features" und dann auf "Bot". Erstellt jetzt über "Create a new bot" einen Bot für eure Teams App.

 

Als Erstes gebt ihr eurem Bot einen Namen und dann definiert ihr die Bot Endpunkt Adresse. Der Anfang der Adresse des Endpunktes besteht aus der URL eurer COYO-Plattform gefolgt von "/web/teams/api/messages". Jetzt müsst ihr noch ein Passwort für den Bot erstellen.

 

Hinweis:
Notiert dieses Passwort unbedingt für die .env Datei, weil es nur beim Erstellen einmalig angezeigt wird!

 

Als letzten Schritt müsst ihr im Developer Portal unter "App features" den neu erstellten Bot auswählen. Anschließend wählt ihr als Scope "Personal" aus und gebt diese beiden Commands:

• Sign In
• Sign Out

 

Schritt 6: Domain und Berechtigungen hinterlegen

Damit hier für die Nutzer die richtigen Informationen angezeigt werden, braucht es eine gültige URL, auf die eure App in Teams zurückgreift. Hier fügt ihr die URL eurer COYO Instanz ein. Bitte beachtet, dass diese ohne "https://www." angegeben werden muss.

 

Schritt 7: Eure .env Datei anpassen

Auf eurem COYO Server befindet sich im COYO-data Verzeichnis eine .env Datei. In dieser müsst ihr die Werte für die folgenden Felder anpassen:

• COYO_TEAMS_BOT_ID (das ist die ID des Bots)
• COYO_TEAMS_BOT_SECRET (das ist das Passwort des Bots)
• COYO_TEAMS_TENANT_SUFFIX (das ist die Endung eurer COYO URL; z.B . .coyocloud.com/)
• COYO_TEAMS_TENANT_URL (das ist eure COYO URL; z. B. https://coyoapp.coyocloud.com)

Die restlichen Teams Felder in der .env Datei können bleiben wie sie sind.

Nach dieser Änderung müsst ihr euer COYO einmal neu starten, damit es wirksam wird.

Achtet darauf, dass die entsprechenden Docker Container neu gebaut werden. Dazu könnt ihr nach dem Stoppen die Container mit folgendem Befehl löschen:

docker container prune

 

Schritt 8: App zugänglich machen

Als letzten Schritt müsst ihr die eigene Teams App veröffentlichen. Bitte verwendet hierfür die offizielle Microsoft-Dokumentation.