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

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Konfigurieren Sie einen Webhook zum Abonnieren von Box mit einer ServiceNow-Rückruf-URL.

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • Aktivieren Sie die Box-Spoke.
    • Erforderliche Rolle: admin.

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

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

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Melden Sie sich bei an Box-Entwicklerkonsole .
    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. In Meine Apps , Wählen Sie die Anwendung aus.
        Sie befinden sich in Ihrer Anwendung Allgemeine Einstellungen .
      2. Navigieren Sie zu Webhooks .
      3. Wählen Sie Aus Verwalten Sie Signaturschlüssel .
      4. Wählen Sie im Abschnitt Primärer Schlüssel die Option aus Schlüssel Generieren .
      5. Wählen Sie im Abschnitt Sekundärer Schlüssel die Option aus Schlüssel Generieren .
      6. Kopieren Sie beide Schlüsselwerte, und speichern Sie sie für später.
    4. Navigieren Sie zu Webhooks Abschnitt.
    5. Wählen Sie aus, um einen V1-Webhook zu erstellen Erstellen Sie Einen Webhook Und wählen Sie aus V1 .
      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 von ServiceNowInstanz 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 Aus Rückrufparameter hinzufügen Dient zum Konfigurieren von GET- oder POST-Methoden

      2. Wählen Sie Aus Webhoook Speichern .
    6. Wählen Sie aus, um einen V2-Webhook zu erstellen Erstellen Sie Einen Webhook Und wählen Sie aus V2 .
      Hinweis:
      Um einen V2-Webhook zu erstellen, müssen Sie aktivieren Verwalten Sie Webhooks In Konfiguration Einstellungen. Weitere Informationen finden Sie unter Erstellen Sie eine OAuth-Anwendung.
      1. Geben Sie für die URL-Adresse die Endpunkt-URL des ein ServiceNowInstanz im folgenden Format: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint .
      2. Wählen Sie für den Elementtyp aus, um einen Webhook auszulösen Wählen Sie ein Element aus .
      3. Wählen Sie die konfigurierte Webhook-Datei oder -Ordner aus.
      4. Wählen Sie zum Bestätigen aus Wählen Sie Aus .
        Eine Liste der konfigurierten Webhook-Auslöser wird in angezeigt Erstellen Sie einen Webhook Seite.
      5. Aktivieren Sie die entsprechenden GET- und POST-Methoden für jeden Auslöser.
      6. Wählen Sie zum Bestätigen aus Erstellen Sie Einen Webhook .

    Ergebnisse

    Die Endpunkt-URL wird Ihrem Box-Account 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-Account auftreten.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. In Ihrem ServiceNow, Navigieren Sie zu Alle > Kastendiagramm > Box-Webhook-Registrierungan.
    2. Wählen Sie Neu.
    3. Füllen Sie die Felder aus.

      Feld

      Wert

      Name

      Benennen Sie optional die Webhook-Registrierung

      Auslösername

      Wählen Sie den entsprechenden Ereignisauslöser aus

      Primärer Schlüssel

      Der primäre Schlüssel, den Sie in generiert haben Fügen Sie eine Endpunkt-URL in einem Box-Account 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ügen Sie eine Endpunkt-URL in einem Box-Account hinzu

      Beschreibung

      Beschreiben Sie optional den Zweck des Datensatzes

    4. Wählen Sie zum Bestätigen aus Übermitteln .

    Ergebnisse

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