In this article:
- Introducing webhooks.
- Setting up webhooks.
- When are webhooks triggered?
- Testing webhooks.
- Technical documentation for webhooks.
Delighted’s webhooks will push information about responses being submitted or about unsubscribe events to the URL of your choice, allowing you to ping other platforms’ APIs and automate your workflows.
This is a great way to send customer feedback data each time a response is received, instead of constantly pinging our API to get response details, allowing you to act immediately on feedback and automate your follow-up.
Setting up webhooks
Prior to setting up Delighted webhooks, make sure you know where you want to send the data, whether an API endpoint from another software platform, a link to connect to your data warehouse, or some other URL.
To set up webhooks:
- From your Dashboard, click on the Integrations tab.
- Choose “Webhooks.”
- For response notifications: Set the specifications of the webhook rule (like “promoters only”).
- Type or paste in the URL you’ve set up to receive the Delighted response webhook payload.
- Set any additional rules needed by clicking “+ Add a new rule” and adding the appropriate URLs.
- For unsubscribe notifications: Select “Send unsubscribe notifications.”
- Type or paste in the URL you’ve set up to receive the Delighted unsubscribe webhook payload.
- For both response and unsubscribe notifications: Click “Save & turn on” to finish!
When are webhooks triggered?
The response webhook is triggered when a response is received or updated. This means that the response webhook is triggered both when a score is selected, when a comment is added, and when any Additional Questions are answered.
The unsubscribe webhook is triggered when someone clicks on the unsubscribe button within the survey email.
To test a webhook, click the “Send test” button on the webhooks page after you’ve set up the conditions and added the destination URL.
If you’d like to test the webhook before adding your production URL, we recommend using a site that can collect and inspect incoming HTTP requests like RequestBin. These sites will provide you with a temporary URL that you can send webhooks to, allowing you to view all of the request details from this test.
Technical documentation for webhooks
Our full webhooks documentation can be found in your account by heading to Integrations, choosing API, and then scrolling down in the documentation to "Webhooks." You can also follow this quick link!
If you need to whitelist the IP address associated with our webhooks, you can whitelist the following static IP address: