Set up a bi-directional webhook for the Box spoke

Configure a webhook to subscribe to Box with a ServiceNow callback URL.

Avant de commencer

• Request an Integration Hub subscription.
• Activate the Box spoke.
• Role required: admin.

Add an endpoint URL in a Box account

Specify an endpoint URL in your Box account to create a webhook for Box spoke.

Avant de commencer

Role required: admin

Procédure

1. Log in to the Box developer's console.
2. Create an app according to your requirements.

   For more information about app creation, see Create an OAuth application.

3. Generate a primary Key and secondary Key for your app and record the values.
   1. In My Apps, select the application.
      You are in your application's General Settings.
   2. Navigate to Webhooks.
   3. Select Manage Signature Keys.
   4. In the Primary Key section, select Generate Key.
   5. In the Secondary Key section, select Generate Key.
   6. Copy and save both key values for later.
4. Navigate to the Webhooks section.
5. To create a V1 webhook, select Create Webhook and select V1.
   1. Complete the fields.

      Field	Value
      Name	Update Chatter feed
      Description	Automatically updates your Chatter feed when a change occurs
      Event Type	Enable at least one option
      Endpoint URL	The endpoint URL of the ServiceNow instance in the following format: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint
      Payload format	Select the appropriate payload data format
      Callback Parameters	Select add callback parameter to configure any GET or POST methods

   2. Select Save Webhoook.
6. To create a V2 webhook, select Create Webhook and select V2.
   Remarque :

   To create a V2 webhook, you must enable Manage webhooks in the Configuration settings. For more information, see Create an OAuth application.
   1. For the URL Address, enter the endpoint URL of the ServiceNow instance in the following format: https://<instance-name>.service-now.com/api/sn_box_spoke/box_spoke_webhook_endpoints/webhook_endpoint.
   2. For The type of item to trigger a webhook, select Choose an item.
   3. Select the webhook configured file or folders.
   4. To confirm select Choose.
      A list of configured webhook triggers display in the Create a Webhook page.
   5. Enable the appropriate GET and POST methods for each trigger.
   6. To confirm, select Create Webhook.

Résultats

The endpoint URL is added in your Box account. You can create webhook registries and subflows according to your requirements.

Register a Box webhook in ServiceNow

Create a Box webhook registry in ServiceNow to notify the ServiceNow app when certain events occur in your Box account.

Avant de commencer

Role required: admin.

Procédure

1. In your ServiceNow, navigate to All > Box > Box Webhook Registry.
2. Select New.
3. Fill in the fields.

   Field	Value
   Name	Optionally, name the webhook registry
   Trigger Name	Select the appropriate event trigger
   Primary Key	The primary key that you generated in Add an endpoint URL in a Box account
   Flow Name	The flow that occurs when the event triggers
   Secondary Key	The secondary key that you generated in Add an endpoint URL in a Box account
   Description	Optionally, describe the purpose of the record

4. To confirm, select Submit.

Résultats

The Box webhook is registered in your ServiceNow instance.