Service Desk widget configuration

Apart from the full Service Desk application, we offer a simplified widget that you can embed to your website or any other page. It can be useful if you do not need the full Service Desk application, or if you just need your users to submit issues, ideas, or questions without leaving your site.

The widget is configurable. Depending on what you need, it can as simple as just a single line with a subject:

Or, it can include additional fields such as description, request type selector, privacy selector, attachments, and even display a "Top x ideas", where you define the number of requests to display. You can also define whether requests will be private or public by default.

In order to embed the widget to your site or application, all you need is to provide a link to your Service Desk that will be displayed in a frame. Parameters are passed in the URL to the widget.

To let the widget work correctly, your service desk settings should allow registration of new requesters. Set New users can register on their own option to checked.

Supported options

So the full link with all the parameters may look something like

https://your_service_desk/widget?form_title=Help%20us%20improve&product_id=49105&email=feedback@example.com&show_top_requests=true&show_request_types=true&show_description=true&show_attachments=true&default_is_private=true&default_request_type=2&top_requests_count=6

Not very convenient to use, right? That's why we also added a compact way to pass the parameters. Instead of using the full parameter name, you can specify just the values in the same order as the parameters are listed in the table above.

https://your_service_desk/widget?product_id=123&email=feedback@example.com&options=123,1,1,0,0,1,2,5

This opens a widget for a product with id == 123, shows Top Requests and request types, hides description field and attachments panel, defines requests to be isPrivate = false by default, defines default request type with id == 2, and defines number of requests to show == 5.