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

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

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

    Vorbereitungen

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

    Fügt einem Box-Konto eine Endpunkt-URL 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 und einen sekundären Schlüssel für Ihre App, und zeichnen Sie die Werte auf.
      1. Wählen Sie unter „ 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.
      4. Wählen Sie im Abschnitt Primärschlü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

        Chatter-Feed aktualisieren

        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 Nutzlastdatenformat aus

        Rückrufparameter

        Wählen Sie „Rückrufparameter hinzufügen“ aus, um eine beliebige GET- oder POST-Methode zu konfigurieren
      2. Wählen Sie Webhook speichern.
    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 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 unter Typ des Elements zum Auslösen eines Webhooks die Option Elementauswählen aus.
      3. Wählen Sie die mit dem Webhook konfigurierte Datei oder den Ordner aus.
      4. Bestätigen Sie mit Auswählen.
        Auf der Seite Webhook erstellen wird eine Liste der konfigurierten Webhook-Auslöser 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 in Ihrem Box-Konto hinzugefügt. Sie können Webhook-Registrierungen und Subflows entsprechend 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 > Kastendiagramm > 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 Ereignisauslöser aus

      Primärer Schlüssel

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

      Flow-Name

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

      Sekundärer Schlüssel

      Der sekundäre Schlüssel, den Sie in generiert haben Fügt einem Box-Konto eine Endpunkt-URL 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.