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 Haiilo anlegen. Die neue App informiert die Nutzer, sobald in Haiilo 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 Haiilo 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 Haiilo 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 Haiilo-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 Haiilo Instanz ein. Bitte beachtet, dass diese ohne "https://www." angegeben werden muss.
Schritt 7: Eure .env Datei anpassen
Hinweis:
Falls ihr in der Private Cloud seid, übernehmen wir diesen Schritt für euch. Gebt dann einfach über ein Ticket Bescheid.
Auf eurem Haiilo Server befindet sich im Haiilo-data Verzeichnis eine .env Datei. In dieser müsst ihr die Werte für die folgenden Felder anpassen:
- HAIILO_TEAMS_BOT_ID (das ist die ID des Bots)
- HAIILO_TEAMS_BOT_SECRET (das ist das Passwort des Bots)
- HAIILO_TEAMS_TENANT_SUFFIX (das ist die Endung eurer Haiilo URL; z.B . .coyocloud.com/)
- HAIILO_TEAMS_TENANT_URL (das ist eure Haiilo 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 Haiilo 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.