Richten Sie einen bidirektionalen Webhook für ein Microsoft Teams Graph-Spoke

  • Freigeben Version: Xanadu
  • Aktualisiert 6. September 2024
  • 2 Minuten Lesedauer

    • Konfigurieren Sie einen Webhook, um Microsoft Teams mit einer ServiceNow-Rückruf-URL zu abonnieren.

    Vorbereitungen

    • Fordern Sie das erforderliche IntegrationHub-Abonnement an
    • Microsoft Teams Graph-Spoke aktivieren
    • Erforderliche Rolle: admin

    Registrieren Sie einen Microsoft Teams Graph-Webhook in der ServiceNow-Instanz

    Registrieren Sie Microsoft Teams in Ihrer ServiceNow-Instanz, um die ServiceNow-App zu benachrichtigen, wenn bestimmte Ereignisse in Microsoft Teams auftreten.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Microsoft Teams Graph-Spoke > Webhook-Registrierung.
    2. Klicken Sie auf Neu.
    3. Füllen Sie diese Felder des Formulars aus:
      Name Name zur Identifizierung der Webhook-Registrierung. Beispiel: MS Teams Graph-Webhook-Registrierung.
      Clientstatus Clientstatus
      Pfad Microsoft Teams Graph-Webhook-Pfad Dieses Feld wird automatisch mit api/sn_msteams_ahv2/ms_teams_webhook ausgefüllt.
      Beschreibung Beschreibung der Webhook-Registrierung.
    4. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
    5. Klicken Sie auf Callback URL.
      Die Webhook-Callback-URL wird vom System automatisch ausgefüllt.

    Erstellen Sie ein Webhook-Abonnement für einen Kanal

    Erstellen Sie ein Webhook-Abonnement für den erforderlichen Kanal in einem -Team, indem Sie den Subflow Webhook abonnieren testen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Prozessautomatisierung > Workflow-Studio.
    2. Klicken Sie auf Subflows.
    3. Öffnen Sie den Subflow Webhook abonnieren.
    4. Klicken Sie auf Testen.
    5. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Webhook-Registrierung – Datensatzname Name des Webhook-Datensatzes, den Sie bei der Registrierung des Webhooks in der ServiceNow-Instanz angegeben haben. Beispiel: MS Teams Graph-Webhook-Registrierung.
      Change-Typ Typ des Changes in der abonnierten Ressource, von dem eine Change-Benachrichtigung gesendet werden soll. Die unterstützten Werte sind erstellt, aktualisiert, und gelöscht. Sie können mehrere durch Kommas getrennte Werte angeben.
      Team-ID Eindeutiger Bezeichner des Teams.
      Kanal-ID Eindeutiger Bezeichner des Kanals
      Abbildung : 1. Testen Sie den Subflow Webhook abonnieren
      Testen Sie den Subflow Webhook abonnieren für die erforderlichen Change-Typen.
    6. Klicken Sie auf Test ausführen.
      Abonnement für den erforderlichen Kanal wird erstellt.

      Weitere Informationen zum Testen von Subflows finden Sie unter Subflows erstellen.

    Passen Sie einen Spoke-Subflow an

    Passen Sie den erforderlichen Subflow an, der zusammen mit der Spoke bereitgestellt wird, indem Sie eine Kopie davon erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Prozessautomatisierung > Workflow-Studio.
    2. Klicken Sie auf Subflows.
    3. Öffnen Sie den erforderlichen Subflow, der im Lieferumfang der Microsoft Teams Graph-Spoke enthalten ist.
      Beispiel: Subflow Eingehende Benachrichtigungen verarbeiten.
    4. Klicken Sie auf das Symbol „ Weitere Aktionen“ (Menü Weitere Aktionen), und wählen Sie Subflow kopieren aus.
    5. Geben Sie unter Neuer Flow-Nameeinen eindeutigen Namen für den kopierten Subflow ein.
      Beispiel: Kopie des Subflows „Eingehende Benachrichtigungen verarbeiten“.
    6. Klicken Sie auf Kopieren.
      Eine Kopie des Subflows wird erstellt.
    7. Passen Sie den Subflow an Ihre Anforderungen an, und veröffentlichen Sie ihn.
      Weitere Informationen zum Erstellen und Verwenden von Subflows finden Sie unter Subflows erstellen.

    Konfigurieren Sie die Webhook-Entscheidungsrichtlinie für Microsoft Teams Graph

    Erstellen Sie eine Webhook-Weiterleitungsrichtlinie und einen Subflow gemäß Ihren Anforderungen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Microsoft Teams Graph-Spoke > Webhook-Entscheidungsrichtlinie
    2. Klicken Sie auf Neu.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Entscheidung“
      Feld Beschreibung
      Bezeichnung Eindeutige Bezeichnung zur Identifizierung der Weiterleitungsrichtlinie.
      Antwort

      Subflow, der ausgelöst werden soll, wenn die Bedingungen erfüllt sind.

      1. Klicken Sie auf das Suchsymbol .
      2. Wählen Sie den gewünschten Subflow aus der Liste Dokument: aus. Beispiel: Kopie von Eingehende Benachrichtigungen verarbeiten.
      Standardantwort Option zum Angeben, ob diese Antwort die Standardantwort ist. Die Standardantwort ist anwendbar, wenn die Bedingungen nicht erfüllt sind.
      Bedingung Bedingungen, die erfüllt werden müssen, wenn der eingehende Webhook Daten aus Microsoft Teams liefert.
    4. Klicken Sie auf Absenden.
      Hinweis:
      Diese Weiterleitungsrichtlinien werden in den Entscheidungstabellen gespeichert. Benutzer werden davor gewarnt, Daten in diesen Tabellen direkt zu aktualisieren oder zu ändern.