This is available in UserVoice Discovery.
With service hooks, UserVoice can send events to any URL you choose. That makes it easy to connect your feedback to your own tools and workflows.
Have an idea for more functionality? Share it on our feedback forum!
Step 1: Create a Web Hook in UserVoice
- Sign in to your Admin Console.
- Click the icon in the bottom-left corner and select Integrations.
- Click Service hooks.
- Click the Web Hook icon or the Custom web hook link.
- Choose the events you want to send:
- New Forum
- New Idea
- New Comment
- Idea Internal Status Update
- New Idea Status Update
- Idea Votes Update
- (Optional) Check Choose Individual Forums to send events only from the forums you pick. If you leave it unchecked, events come from all forums.
- Pick a payload format: JSON or XML.
- Enter your Callback URL and save.
Step 2: Set Up Your Application
An engineer on your team will need to set up the receiving end. Our guidance on configuring your application is limited, but these tips will help:
-
Read the
dataparameter. It holds the event payload in the format you picked. -
Verify the
signatureparameter to confirm the request came from UserVoice. Compute an HMAC-SHA256 hash, using your SSO key as the key anddataas the message. Your SSO key is under Settings → Web Portal → UserVoice Authentication → Edit. - Browse our code examples in the uservoice-service-hooks repository on GitHub. Each hook is a simple Ruby class that defines its settings, formats the message for each event type, and sends the data to your app.
Common Questions
Can I send events from just one forum?
Yes! Check Choose Individual Forums when you set up the hook.
Are events bundled or rate-limited?
No. Each event is sent on its own.
Are failed deliveries retried?
No. Failed deliveries aren't retried automatically.