Skip to main content

Zoho Desk integrations

Send Simplesat surveys from Zoho Desk email templates and put each response on its Zoho Desk ticket and contact.

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

  1. On the Integrations page, open Zoho Desk.

  2. Click Authenticate.

  3. In Domain, enter the Zoho Desk address from your browser, with https:// and no slash at the end, for example https://desk.zoho.com. The address decides which Zoho data center you connect to: https://desk.zoho.eu is Europe and https://desk.zoho.in is India.

  4. Click Authenticate, then sign in to Zoho and accept the access request.

  5. When the page shows Authenticated with Zoho Desk, click Activate integration on each integration you want.

The browser's address bar on a Zoho Desk page, starting <a href="https://desk.zoho.com" rel="nofollow noopener noreferrer" target="_blank">https://desk.zoho.com</a>

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.

  1. Create or open the survey and choose External email embed.

  2. Under Choose where to add your survey, choose Zoho Desk.

  3. On Publish, click Generate embed code.

  4. Choose HTML and click Copy survey.

  5. In Zoho Desk, go to Setup → Customization → Templates → Email Templates.

  6. 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.

  7. In the editor's drop-down, choose Insert HTML, paste the survey code and click Insert.

  8. Click Save.

Zoho Desk Setup with Templates under CUSTOMIZATION

Zoho Desk's Email Templates list with Notify Contact on Ticket closure under Contact Notification

The Zoho Desk template editor's toolbar drop-down open on Insert HTML

The Zoho Desk email template editor with the Insert HTML option and the pasted survey

The Edit Email Template page with the survey's How did we do? question and rating faces under the message

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.

A Zoho Desk workflow rule's Actions menu with Alerts and its New and Existing links

Zoho Desk's Associate Existing Alerts list with the alert that sends Notify contact on ticket closure checked

Zoho Desk Personal Settings, Preferences, with Signature and its View Signature link

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)

${Cases.Request Id}

Ticket subject

${Cases.Subject}

Customer email

${Cases.Email}

Customer first name

${Cases.First Name}

Customer last name

${Cases.Last Name}

Company name

${Cases.Account Name}

Team member email

${User.Email}

Team member first name

${User.First Name}

Team member last name

${User.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

Zoho Desk Setup with Layouts and Fields under CUSTOMIZATION

Zoho Desk's Layouts page with Tickets chosen and the department's Default layout listed

A Zoho Desk ticket layout with a Simplesat section holding the single-line Simplesat rating and Simplesat sentiment and the multi-line Simplesat comment

A Zoho Desk ticket with Simplesat rating 5, Simplesat sentiment positive and Simplesat comment filled in from a response

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.

A Zoho Desk contact with Latest Simplesat CSAT, NPS, CES and 5-star rating and Latest Simplesat sentiment filled in

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

A response's Ticket and Customer details in Simplesat after Pull ticket details, with Ticket ID, Ticket subject, Assignee, Channel, Number and Url

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:

  1. Click Revoke access.

  2. Click Authenticate, enter the domain, sign in to Zoho and accept the access request.

  3. 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.

Did this answer your question?