You can send a Simplesat survey inside a Zoho Desk email template, such as the one Zoho Desk sends when a ticket closes. The survey code works in the template without connecting Zoho Desk. Connect Zoho Desk if you also want each response written to its ticket and to the ticket's contact, and the ticket, contact and agent details brought into Simplesat.
What the Zoho Desk integrations do
The Zoho Desk page in Simplesat groups its integrations under Survey integrations and Ticket integrations. Each one is switched on separately with Activate integration.
Integration | Listed under | What it does | Where it shows |
Sync feedback to contact custom fields | Survey integrations | Writes the latest rating and sentiment to five contact fields | The contact in Zoho Desk |
Add feedback to contact as a comment | Survey integrations | Adds the response to the ticket's contact as a comment | The contact in Zoho Desk |
Add feedback to ticket private comment | Ticket integrations | Adds the response to the ticket as a private comment | The ticket |
Sync feedback to ticket custom fields | Ticket integrations | Writes the rating, sentiment and comment to three ticket fields | The ticket |
Add rating and sentiment to ticket tags | Ticket integrations | Tags the ticket with the rating and sentiment | The ticket |
Pull ticket details | Ticket integrations | Adds the ticket's details, contact and assigned agent to the response | The response, in Simplesat |
Each integration finds the ticket by its Zoho Desk ticket number, which the survey code carries as the ticket ID. The contact integrations then write to that ticket's contact. A response without a Zoho Desk ticket number is skipped.
Note: If we've changed one of your Zoho Desk integrations for you, it can work differently from what's described here. Contact us to check what yours does.
None of the integrations has a survey setting. The ticket integrations run on every response from a survey connected to Zoho Desk. A survey counts as connected if it's one of these:
an External email embed survey with the Zoho Desk option
an Event-based or Web-embed survey with Connected service set to Zoho Desk
The two contact integrations, under Survey integrations, run on every response from every survey in your workspace.
Heads up: The contact integrations look up the ticket by the ticket ID on the response, whichever survey it came from. If you also send surveys from another tool, a ticket ID from that tool can match a Zoho Desk ticket number, and the comment or fields go to that unrelated ticket's contact. Switch them on only if your surveys go out from Zoho Desk.
Before you start
The Zoho Desk integrations are available on every Simplesat plan. To connect Zoho Desk and switch integrations on, you need the Manage integrations permission in Simplesat. Owner and Admin have it by default.
You connect by signing in to Zoho and allowing Simplesat access. From then on, the integrations act as that Zoho user, so sign in as someone who will keep their Zoho Desk access.
Simplesat asks Zoho Desk for:
full access to tickets
read, create and update access to contacts
read access to settings, basic Zoho Desk details and search
What any connected tool can read and write is set out in Integration security, permissions and data flow.
Connect Zoho Desk
On the Integrations page, open Zoho Desk.
Click Authenticate.
In Domain, enter the Zoho Desk address from your browser, with
https://and no slash at the end, for examplehttps://desk.zoho.com. The address decides which Zoho data center you connect to:https://desk.zoho.euis Europe andhttps://desk.zoho.inis India.Click Authenticate, then sign in to Zoho and accept the access request.
When the page shows Authenticated with Zoho Desk, click Activate integration on each integration you want.
Before you rely on an integration, run a real ticket through it as Testing an integration end to end describes.
Send surveys from Zoho Desk
When customers get the survey depends on which template you add it to and what sends that template: a Zoho Desk notification, a workflow rule or a macro. If you're still deciding how to send surveys, Choosing a survey delivery method compares this with the other ways Simplesat sends them.
Create or open the survey and choose External email embed.
Under Choose where to add your survey, choose Zoho Desk.
On Publish, click Generate embed code.
Choose HTML and click Copy survey.
In Zoho Desk, go to Setup → Customization → Templates → Email Templates.
Open the template that should carry the survey and click Edit. To survey customers when a ticket closes, that's Contact Notification → Notify Contact On Ticket Closure.
In the editor's drop-down, choose Insert HTML, paste the survey code and click Insert.
Click Save.
To send the template from a workflow rule or a macro, choose it in the action under Alerts → Existing. You can also paste the survey code into a Zoho Desk signature with the same Insert HTML option.
Tip: To test, create a ticket with yourself as the contact, let Zoho Desk send the email, and click a rating in it.
The survey code carries these Zoho Desk placeholders, and Zoho Desk fills them in when it sends the email:
What the code carries | Zoho Desk placeholder |
Ticket ID (the ticket number) |
|
Ticket subject |
|
Customer email |
|
Customer first name |
|
Customer last name |
|
Company name |
|
Team member email |
|
Team member first name |
|
Team member last name |
|
They work like placeholders in any other tool, which Placeholders and merge fields explains.
Feedback in Zoho Desk
Simplesat waits at least five minutes after a response arrives before it writes to Zoho Desk, and writes again if the response changes. There's more on the timing in Writing feedback back, and mapping the fields.
Add feedback to ticket private comment
Your team sees the feedback on the ticket as a private comment. The comment names the customer, the sentiment and the survey, and links to the customer, the response and the survey in Simplesat. Then it lists every question and answer. The rating shows with an emoji.
If the customer answers another question later, the ticket gets a second comment.
Sync feedback to ticket custom fields
To get the rating, sentiment and comment into fields on the ticket, create three ticket fields in Zoho Desk before you switch this on. Add them under Setup → Layouts and Fields → Tickets, in the layout your tickets use. The integration finds them by their labels, so use exactly these:
Simplesat rating, a Single Line field
Simplesat sentiment, a Single Line field
Simplesat comment, a Multi Line field
Add rating and sentiment to ticket tags
The ticket's tags show the metric and rating, such as simplesat_CSAT_4 or simplesat_NPS_9, and the sentiment: simplesat_sentiment_positive, simplesat_sentiment_neutral or simplesat_sentiment_negative.
Add feedback to contact as a comment
The ticket's contact gets the same comment, so the feedback is there when you open the contact in Zoho Desk too.
Sync feedback to contact custom fields
Five fields on the ticket's contact hold their latest sentiment and ratings. Create them in Zoho Desk under Setup → Layouts and Fields → Contacts as Single Line fields. The integration finds them by their labels, so use exactly these:
Latest Simplesat sentiment
Latest Simplesat CSAT rating
Latest Simplesat NPS rating
Latest Simplesat CES rating
Latest Simplesat 5-star rating
Each response fills in the sentiment and the rating field for its own metric, so a CSAT response updates Latest Simplesat CSAT rating.
Ticket, contact and agent details in Simplesat
A response's ticket, contact and agent first come from the placeholders Zoho Desk fills into the survey code. Pull ticket details then fills them in from the ticket itself. How Simplesat makes these connections is in Attribution: linking feedback to tickets, customers and agents.
Pull ticket details runs as soon as a response arrives. It reads the ticket and adds to the response:
the ticket's subject and ticket number
the ticket's priority, channel and link, as ticket fields
the contact's name, email and Zoho Desk contact ID, their company, and their contact type
the ticket's assigned agent, as a team member with the role Assignee, with their name, email and Zoho Desk agent ID
What it adds replaces the ticket fields and team members the response came in with.
Change the Zoho Desk account or domain
To connect a different Zoho Desk account, move to another data center, or sign in as a different user:
Click Revoke access.
Click Authenticate, enter the domain, sign in to Zoho and accept the access request.
Any integration that was on before switches back on by itself. Check that each one you use shows Deactivate integration. If one is still off, click Activate integration.
Responses that arrive between Revoke access and Authenticate aren't written to Zoho Desk, so do the steps in one go. Survey code in your Zoho Desk templates keeps working throughout.
If the Zoho user who signed in loses access to Zoho Desk, the integrations stop while the page still shows Authenticated with Zoho Desk. Reconnect the same way.
Troubleshooting
Feedback doesn't show up on my Zoho Desk tickets
Check each of these:
The response has a ticket ID. The survey code fills it in from
${Cases.Request Id}, and without it nothing is written.The survey code came from the Zoho Desk option under Choose where to add your survey. Code from another option writes nothing.
For the ticket integrations, the survey is connected to Zoho Desk.
At least five minutes have passed since the response.
Each integration shows as active. After Revoke access and Authenticate, any integration that was on before switches back on by itself. Click Activate integration on any that's still off.
If none of this explains it, send us the response's link.
My Simplesat fields in Zoho Desk stay empty
Sync feedback to ticket custom fields and Sync feedback to contact custom fields find the fields by their labels. Check that each field exists with exactly the label listed in Feedback in Zoho Desk, in the layout your tickets or contacts use. The checks under Feedback doesn't show up on my Zoho Desk tickets apply too.
Zoho Desk won't authenticate
Enter the Domain with https:// and no slash at the end, as your browser shows it when you're signed in to Zoho Desk, for example https://desk.zoho.eu. Then sign in to Zoho as a user who has a Zoho Desk account in the data center that domain points to. A Zoho user without one can't accept the access request, so the connection doesn't go through.
I see two comments for one response
The comment integrations run when a response arrives and again when it changes, for example when the customer answers another question later or changes their rating. Each run adds a comment.
My Zoho Desk integrations stopped working, but the page still says Authenticated with Zoho Desk
Simplesat doesn't check the connection after you connect. If the Zoho user who signed in loses access, the integrations fail and the page still reads Authenticated with Zoho Desk. Click Revoke access, then Authenticate. Any integration that was on before switches back on by itself. Check that each one you use shows Deactivate integration, and click Activate integration on any that's still off. For the messages the page can show, see Integration error messages and what they mean.
FAQ
Can I choose which surveys the Zoho Desk integrations run on?
No. The Zoho Desk integrations have no survey setting. The ticket integrations act only on surveys connected to Zoho Desk, and the contact integrations act on every survey. To stop one, click Deactivate integration on it.
Do I need to connect Zoho Desk to send surveys?
No. Survey code in a Zoho Desk email template works without connecting. Connect when you want feedback on your tickets and contacts, and ticket details in Simplesat.
What do the simplesat_ tags on my tickets mean?
They come from Add rating and sentiment to ticket tags. simplesat_CSAT_4 means a CSAT rating of 4, simplesat_NPS_9 an NPS rating of 9, and simplesat_sentiment_positive a positive response.