All Collections
Publishing Surveys
👨‍💻 Embed
Including custom ticket and team member placeholder fields in a survey
Including custom ticket and team member placeholder fields in a survey

Add any variable/placeholder/merge tag in rating URLs

Cory Brown avatar
Written by Cory Brown
Updated over a week ago

By default, Simplesat embed codes contain top ticket and team member data, such as the ticket ID, team member email, or customer. 

It's possible to take advantage of additional fields you want to sync by inserting custom parameters in your rating URLs.

Here's how it works

You can see the fields your rating links are collecting in the parameters (stuff after the ? character in a URL).

For example, the rating link below contains the following parameters:

https://api.simplesat.io/api/rating/oWOpQtq9AfAZBvBtxX92HIrz-Ib3ivIIfSXK74CLkQg/1234/?source=generic_embed&[email protected] 


To add any custom fields, use the t_FIELD  prefix for fields that should be associated with the ticket, and tm_FIELD  prefix for fields that should be associated with the team member.

For example, let's say your helpdesk has a "Channel" field associated with tickets that could be values like phone, chat, email, or api. You could include a new parameter t_channel={{ticket.channel}} to send that information along to Simplesat. 

Working off the URL in above, the new link would look like this:

https://api.simplesat.io/api/rating/oWOpQtq9AfAZBvBtxX92HIrz-Ib3ivIIfSXK74CLkQg/1234/?source=generic_embed&[email protected]&t_channel={{ticket.channel}} 

You'll know it's working when responses include your custom fields in the popup details:

If you need any help with this at all, just start a chat with the Simplesat team and we'll be more than happy to help!


Did this answer your question?