Richten Sie einen bidirektionalen Webhook für eine Box-Spoke ein

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

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

    Vorbereitungen

    • Fordern Sie ein IntegrationHub Professional-Abonnement an
    • Aktivieren Sie die Box-Spoke
    • Erforderliche Rolle: admin

    Fügen Sie eine Endpunkt-URL in einem Box-Konto hinzu

    Geben Sie eine Endpunkt-URL in Ihrem Box-Konto an, um einen Webhook für die Box-Spoke zu erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei der Box-Entwicklerkonsole an.
    2. Erstellen Sie eine App gemäß Ihren Anforderungen.

      Weitere Informationen zur App-Erstellung finden Sie unter Erstellen Sie eine OAuth-Anwendung.

    3. Generieren Sie einen primären Schlüssel und einen sekundären Schlüssel für Ihre App, und zeichnen Sie die Werte auf.
      1. Wählen Sie in „ Meine Apps“ die Anwendung aus.
        Sie befinden sich in den allgemeinen EinstellungenIhrer Anwendung.
      2. Navigieren Sie zu Webhooks.
      3. Wählen Sie Signaturschlüssel verwalten aus.
      4. Wählen Sie im Abschnitt „Primärer Schlüssel“ die Option Schlüssel generierenaus.
      5. Wählen Sie im Abschnitt „Sekundärer Schlüssel“ die Option Schlüssel generierenaus.
      6. Kopieren Sie beide Schlüsselwerte, und speichern Sie sie für später.
    4. Navigieren Sie zum Abschnitt Webhooks.
    5. Um einen V1-Webhook zu erstellen, wählen Sie Webhook erstellen und dann V1aus.
      1. Füllen Sie die Felder aus.

        Feld

        Wert

        Name

        Aktualisieren Sie den Chatter-Feed

        Beschreibung

        Aktualisiert Ihren Chatter-Feed automatisch, wenn eine Änderung auftritt

        Ereignistyp

        		 Aktivieren Sie mindestens eine Option

        Endpunkt-URL

        Die Endpunkt-URL der Instanz ServiceNow im folgenden Format: https://<instance-name> .service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint

        Nutzlastformat

        Wählen Sie das entsprechende Nutzlast-Datenformat aus

        Rückrufparameter

        Wählen Sie Rückrufparameter hinzufügen aus, um beliebige GET- oder POST-Methoden zu konfigurieren
      2. Wählen Sie Webhook speichern aus.
    6. Um einen V2-Webhook zu erstellen, wählen Sie Webhook erstellen und dann V2aus.
      Hinweis:
      Um einen V2-Webhook zu erstellen, müssen Sie Webhooks verwalten in den Konfigurationseinstellungen aktivieren. Weitere Informationen finden Sie unter Erstellen Sie eine OAuth-Anwendung.
      1. Geben Sie für die URL-Adresse die Endpunkt-URL der Instanz ServiceNow im folgenden Format ein: https://<instance-name> .service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint .
      2. Wählen Sie für The type of item to trigger a webhook (Typ des Elements zum Auslösen eines Webhooks) die Option Choose an item (Elementwählen) aus.
      3. Wählen Sie die für den Webhook konfigurierte Datei oder die konfigurierten Ordner aus.
      4. Zum Bestätigen wählen SieAuswählen.
        Eine Liste der konfigurierten Webhook-Auslöser wird auf der Seite Webhook erstellen angezeigt.
      5. Aktivieren Sie die entsprechenden GET- und POST-Methoden für jeden Auslöser.
      6. Wählen Sie zum Bestätigen Webhook erstellen aus.

    Ergebnisse

    Die Endpunkt-URL wird Ihrem Box-Konto hinzugefügt. Sie können Webhook-Registrierungen und -Subflows gemäß Ihren Anforderungen erstellen.

    Registrieren Sie einen Box-Webhook in ServiceNow

    Erstellen Sie eine Box-Webhook-Registrierung in ServiceNow, um die ServiceNow-App zu benachrichtigen, wenn bestimmte Ereignisse in Ihrem Box-Konto auftreten.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren Sie in ServiceNowzu Alle > Box > Box-Webhook-Registrierung.
    2. Wählen Sie Neu.
    3. Füllen Sie die Felder aus.

      Feld

      Wert

      Name

      Benennen Sie die Webhook-Registrierung optional

      Auslösername

      Wählen Sie den entsprechenden Event-Auslöser aus

      Primärer Schlüssel

      Der Primärschlüssel, den Sie in generiert haben Fügen Sie eine Endpunkt-URL in einem Box-Konto hinzu

      Flow-Name

      Der Flow, der auftritt, wenn das Event ausgelöst wird

      Sekundärer Schlüssel

      Der sekundäre Schlüssel, den Sie in generiert haben Fügen Sie eine Endpunkt-URL in einem Box-Konto hinzu

      Beschreibung

      Beschreiben Sie optional den Zweck des Datensatzes
    4. Wählen Sie zum Bestätigen Absendenaus.

    Ergebnisse

    Der Box-Webhook ist in Ihrer ServiceNow-Instanz registriert.