To set up a webhook or event detection for when you request a signature via DocuSign on a Box file, you can follow these steps:
Create a DocuSign Connect Configuration:
Go to the DocuSign Admin Console.
Navigate to Settings > Integrations > Connect.
Click on Add Configuration and select Custom.
Configure the webhook settings, specifying the events you want to track (e.g., envelope sent, envelope completed) and the URL of your webhook listener1.
Set Up Your Webhook Listener:
Create a webhook listener on your server that can receive and process the events from DocuSign. This listener should be able to handle HTTP POST requests and parse the JSON or XML payloads sent by DocuSign2.
Integrate with Box:
Use the Box API to interact with your Box files. When your webhook listener receives an event from DocuSign, it can use the Box API to perform actions such as logging the event or updating file metadata.
Deploy the Script:
Deploy your webhook listener script on a server that is accessible via the internet. Ensure it uses HTTPS for secure communication.
Here is a basic example of a webhook listener in Node.js:
JavaScript
const express = require('express');
const bodyParser = require('body-parser');
const app = express();
app.use(bodyParser.json());
app.post('/webhook', (req, res) => {
const event = req.body;
console.log('Received event:', event);
// Process the event and interact with Box API as needed
// Example: Log the event or update Box file metadata
res.status(200).send('Event received');
});
app.listen(3000, () => {
console.log('Webhook listener running on port 3000');
});
Test the Configuration:
Trigger a test event from DocuSign to ensure your webhook listener is correctly receiving and processing events.
Best Regards,
Aarp Membership