Integration für Microsoft Teams

Haiilo Advocacy integriert sich mit Microsoft Teams, um Nutzern zu ermöglichen, Benachrichtigungen direkt in Teams über neue Beiträge in ihren abonnierten Kanälen zu erhalten. Der gesamte Inhalt des Beitrags—Titel, Text und Bild—wird innerhalb von Teams sichtbar sein. Nutzer können den Beitrag einfach auf der Plattform öffnen, um ihn in ihren sozialen Netzwerken zu teilen. Wenn Nutzer Teams auf ihren mobilen Endgeräten nutzen, wird das Öffnen eines Beitrags die Haiilo Amplify Mobile-App starten.

Damit die Integration funktioniert, müssen die Nutzer die gleiche E-Mail-Adresse bei Haiilo Advocacy und MS Teams haben.

Du kannst nicht auswählen, nur Beiträge aus bestimmten Kanälen zu senden. Benachrichtigungen werden immer für Beiträge aus allen Kanälen gesendet, die ein Nutzer abonniert hat. Die Benachrichtigungen werden auch aktualisiert, um Änderungen oder Löschungen auf der Plattform widerzuspiegeln. Wenn ein Beitrag bearbeitet oder von der Plattform entfernt wird, werden diese Änderungen in Teams sichtbar sein. Das Zurückziehen oder Archivieren eines Beitrags, ohne ihn von der Plattform zu löschen, wird den Beitrag nicht von Nutzern zurückziehen, die ihn bereits erhalten haben.

1. Registriere eine App in Microsoft

Du benötigst Administratorrechte in deinem Microsoft Entra ID-Konto, um eine App zu registrieren.

Erstelle eine App

  1. Melde dich bei der Microsoft Azure Plattform an.
  2. Gehe zu Microsoft Entra ID > App-Registrierungen > Neue Registrierung.
  3. Gib deiner App einen Namen, z.B. Haiilo.
  4. Wähle Jeder Microsoft Entra ID-Mandant - Multitenant als Kontotyp.
  5. Wähle Registrieren.
  6. Auf der Seite Überblick der App kopiere und speichere die Anwendungs- (Client-) ID und Verzeichnis- (Mandanten-) ID für späteren Gebrauch.
App-Registrierungsübersichtsseite in Microsoft Azure.png

Erstelle ein Client-Geheimnis und definiere API-Berechtigungen

  1. Client-Geheimnis erstellen:
    1. Gehe zu Zertifikate & Geheimnisse > Client-Geheimnisse.
    2. Wähle Neues Client-Geheimnis.
    3. Gib eine Beschreibung ein und wähle aus, wann das Geheimnis abläuft.
      • Nachdem ein Geheimnis abgelaufen ist, musst du ein neues Geheimnis generieren und es in Haiilo aktualisieren, damit die Verbindung gültig bleibt. Wir empfehlen, eine Erinnerung einzurichten, um das Geheimnis vor dem Ablauf zu erneuern.
    4. Wähle Hinzufügen.
    5. Kopiere den Geheimnis Wert für späteren Gebrauch.
  2. Definiere API-Berechtigungen:
    1. Gehe zu API-Berechtigungen.
    2. Wähle Berechtigung hinzufügen > Microsoft Graph > Anwendungsberechtigungen.
    3. Füge die folgenden API-Berechtigungen hinzu:
      • TeamsAppInstallation.ReadWriteSelfForUser.All
      • AppCatalog.Read.All
      • User.Read.All
    4. Wähle Admin-Zustimmung für app_name für die hinzugefügten Berechtigungen und stelle sicher, dass der Status für alle Berechtigungen als Gewährt für dein_mandant markiert ist.
API-Berechtigungen für Multichannel Teams in Entra ID.png

2. Richte eine Teams-App ein

Du benötigst Administratorrechte in deinem Microsoft Teams-Konto, um eine App zu erstellen.

  1. Melde dich im Entwicklerportal in Microsoft Teams an.
  2. Wähle Apps > Neue App.
  3. Gib einen Namen für die App ein.
  4. Wähle Hinzufügen.

Definiere grundlegende Informationen und Branding

  1. Definiere grundlegende Informationen:
    1. Gehe zu Grundlegende Informationen.

    2. Passe mindestens die folgenden Felder an:

      Kurze Beschreibung

      Gib eine Beschreibung der App und ihrer Funktionen an. Optional kannst du verwenden:

      "Diese App benachrichtigt dich über neue Haiilo Advocacy-Beiträge, die du ganz einfach teilen kannst."
      Langbeschreibung

      Gib eine Beschreibung der App und ihrer Funktionen an. Optional kannst du verwenden:

      "Diese App verbessert dein Microsoft Teams-Erlebnis, indem sie Echtzeitbenachrichtigungen für neue Beiträge in deinen abonnierten Kanälen auf Haiilo Advocacy liefert. Sie ermöglicht es dir, einfach über frische Inhalte informiert zu bleiben, Beiträge direkt aus Teams zu öffnen und sie in sozialen Netzwerken zu teilen. In der Mobile-App öffnet das Öffnen eines Beitrags automatisch die Haiilo Amplify-App, um ein reibungsloses und effizientes Teilen von Inhalten überall und jederzeit zu gewährleisten."
      Entwickler- oder Firmenname Gib Haiilo ein, da dies auf Haiilo als Entwickler verweisen sollte.
      Website Gib https://www.haiilo.com/ ein.
      Datenschutzrichtlinie Gib https://www.haiilo.com/legal ein.
      Nutzungsbedingungen Gib https://www.haiilo.com/legal ein.
      Anwendungs- (Client-) ID Gib die Anwendungs- (Client-) ID ein, die du zuvor von Microsoft Entra ID kopiert hast. Dies ist für die Authentifizierung auf der MS Teams-Seite erforderlich.
    3. Wähle Speichern.
  2. Definiere das Branding:
    1. Gehe zu Branding.
    2. Bearbeite das Farb-Icon, das Umriss-Icon und die Akzentfarbe, um sie an das Branding deiner Plattform anzupassen. Alternativ kannst du die Icons von Haiilo verwenden, indem du unsere Assets unten herunterlädst.

Aktiviere den Bot und füge die Domain hinzu

  1. Aktiviere die Bot-Funktion:
    1. Wähle App-Funktionen > Bot.
    2. Gib im Feld Gib eine Bot-ID ein die Bot ID ein, die du in Haiilos Administration > Einstellungen > Integrationen > MS Teams gefunden hast.
    3. Wähle Nur Benachrichtigungen senden (einseitige Gespräche).
    4. Wähle Persönlich als den Geltungsbereich.
    5. Wähle Speichern.
  2. Füge die Domain hinzu:
    1. Gehe zu Domains > Domain hinzufügen.
    2. Füge die Domain *.smarpshare.com hinzu > Bestätigen.
    3. Wähle Speichern.

Veröffentliche die App

Bevor du veröffentlichst, kannst du die Anwendung testen, indem du Vorschau in Teams auswählst. Wenn alles wie erwartet funktioniert, kannst du sie veröffentlichen, indem du Verteilen > Veröffentlichen in deiner Organisation > Loslegen / Veröffentliche deine App.

Deine App muss dann von einem IT-Admin genehmigt werden:

  1. Öffne das Microsoft Teams Admin Center.
  2. Gehe zu Teams-Apps > Apps verwalten.
  3. Suche nach der App anhand des Namens, den du ihr gegeben hast.
  4. Öffne die App und wähle Veröffentlichen > Veröffentlichen.
  5. Kopiere die App-ID für die App aus dem Admin Center. Achte darauf, dass du die App-ID verwendest, nicht die externe App-ID.

Sobald deine App veröffentlicht ist, stelle sicher, dass du die Teams-Einrichtung abschließt in deiner Haiilo Advocacy-Plattform, damit die Benachrichtigungen gesendet werden.

3. Richte Teams in Haiilo ein

Du musst ein Company Admin sein, um die MS Teams-Einstellungen in Haiilo zu konfigurieren.

  1. Gehe in Haiilo zu Verwaltung > Einstellungen > Integrationen > MS Teams.
  2. Aktiviere die Microsoft Teams-Integration.
  3. Gib die Anwendungs- (Client-) ID ein, die du von Microsoft Entra ID kopiert hast, in das Feld Client-ID ein.
  4. Gib den Client Secret Value ein, den du von Microsoft Entra ID kopiert hast, in das Feld Client Secret ein.
  5. Gib die Directory (Tenant) ID  ein, die du von Microsoft Entra ID kopiert hast, in das Feld Tenant-ID ein.
  6. Gib die App-ID, die du aus dem Microsoft Teams Admin Center kopiert hast, in das Feld App-ID ein.
  7. Wähle Änderungen speichern.

Deine MS Teams-Integration ist bereit zur Nutzung! Deine Benutzer werden beginnen, Benachrichtigungen von Haiilo zu erhalten.

Du kannst die Verbindung überprüfen, indem du auf den Verbindung testen Button klickst, um eine Testbenachrichtigung an dich selbst zu senden. Wenn deine Teams-App eine "Herzlichen Glückwunsch"-Nachricht anzeigt, ist die Verbindung erfolgreich. Beachte, dass nur der Benutzer, der auf den Test-Button klickt, diese Nachricht erhält.

FAQ

Kann die App auf bestimmte Benutzer oder Gruppen innerhalb unserer Organisation beschränkt werden?

Ja, dein IT-Team kann dies über das Teams-Admin-Center verwalten, wo sie den Zugriff auf die App für einzelne Benutzer, Gruppen oder die gesamte Organisation erlauben oder verweigern können. Das bestimmt, wer die Berechtigung hat, die App zu nutzen.

Wir empfehlen, die App nur den Benutzern oder Gruppen innerhalb deiner Organisation zuzuweisen, die Zugriff auf Haiilo Advocacy haben.

Wenn du die App nur wenigen Benutzern oder Gruppen zuweist, denke daran, dass du, wenn du weitere Benutzer zu deiner Haiilo Advocacy-Plattform hinzufügst, sicherstellen musst, dass die App auch ihnen zugewiesen wird. Andernfalls könnten sie keine Benachrichtigungen in MS Teams erhalten.

Müssen Benutzer die Haiilo Teams-App herunterladen, oder kann das für sie verwaltet werden? 

Dein IT-Team kann die App proaktiv über das Teams-Admin-Center installieren und anheften, sodass die zugewiesenen Benutzer keine Maßnahmen ergreifen müssen. Alternativ, wenn die App für einen Benutzer erlaubt ist, kann er sie selbst im Teams-App-Store suchen und installieren.

Müssen Benutzer sich in ihren Advocacy-Konten innerhalb von Teams anmelden, um Benachrichtigungen zu erhalten? 

Nein, solange der Benutzer ein aktives Haiilo Advocacy-Konto mit derselben E-Mail-Adresse wie sein Microsoft-Konto hat, erhält er Benachrichtigungen in Teams über neue Beiträge in seinen abonnierten Kanälen auf Haiilo Advocacy. Wenn ein Benutzer kein Advocacy-Konto hat, erhält er keine Benachrichtigungen in Teams.

Warum muss ich diese API-Berechtigungen erteilen?

Die Haiilo Microsoft Teams-Integration greift über Microsoft Entra ID auf Teams-Daten zu und nutzt dabei die Microsoft Graph API über OAuth 2.0-Authentifizierung. Die aufgeführten API-Berechtigungen sind nötig, um Beiträge von Haiilo Advocacy in Teams anzuzeigen.

Weitere Infos findest du in unserem Trust Center und in unserer Datenschutzrichtlinie.

Da du deine eigene Integration innerhalb deines Microsoft-Mandanten erstellen musst, unterliegen alle anderen Datenverarbeitungsvorgänge im Zusammenhang mit der Teams-Integration den Nutzungsbedingungen und der Datenverarbeitungsvereinbarung von Microsoft.

Herunterladbare Assets

Fühle dich frei, diese Assets für deine MS Teams-App zu verwenden – lade sie einfach herunter und lade sie direkt in Teams hoch.

War dieser Beitrag hilfreich?

0 von 0 fanden dies hilfreich