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

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

Vorbereitungen

• Fordern Sie an IntegrationHub Abonnement.
• 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 entsprechend 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. 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ärschlü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. Um einen V1-Webhook zu erstellen, wählen Sie aus Erstellen Sie Einen Webhook Und wählen Sie aus V1 .
   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 des ServiceNow Instanz 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. Um einen V2-Webhook zu erstellen, wählen Sie aus 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 ServiceNow Instanz 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 Typ des Elements, das einen Webhook auslösen soll Wählen Sie ein Element aus .
   3. Wählen Sie die mit dem Webhook konfigurierte 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 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-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.