Skip to main content

Syncro integrations

Send Simplesat surveys from Syncro and get ratings and comments back on your Syncro tickets and customers.

You can put a Simplesat survey in an email Syncro already sends, such as the Ticket Resolved email, without connecting Syncro to Simplesat. If you connect Syncro, Simplesat can also send its own survey email when a ticket is resolved, add each response to the rated ticket as a private comment, write ratings to Syncro custom fields, and open a follow-up ticket or reopen the rated one. It also pulls the ticket, customer and assigned tech into each response.

What the Syncro integrations do

You switch each one on separately with Activate integration.

Integration

Listed under

What it does

Where it shows

Send email survey after resolving a ticket

Survey integrations

Emails the survey to the ticket's contact when a Syncro ticket is resolved

The contact's inbox

Send email survey after resolving a ticket (older version, marked deprecated)

Survey integrations

Emails the survey to the Syncro customer's email address when a ticket is resolved

The customer's inbox

Update contact custom fields with rating details

Survey integrations

Writes the latest rating and comment to custom fields on the Syncro customer

The customer in Syncro

Create follow-up tickets from feedback

Survey integrations

Opens a new Syncro ticket from the response

A new ticket in Syncro

Pull ticket details

Ticket integrations

Adds the ticket, customer and assigned tech to the response

The response, in Simplesat

Add notes to rated tickets

Ticket integrations

Adds the response to the ticket as a private comment

The ticket

Update ticket custom fields with rating details

Ticket integrations

Writes the rating, sentiment and comment to ticket custom fields

The ticket

Reopen a ticket after receiving feedback

Ticket integrations

Sets the rated ticket's status back to New

The ticket

The ticket integrations run only on surveys connected to Syncro, and only for responses that came in with a Syncro ticket ID. A survey is connected to Syncro when:

  • its delivery method is External email embed with the Syncro option, or

  • it's an Event-based or Web-embed survey with Connected service set to Syncro.

Before you start

The Syncro integrations are available on every Simplesat plan. To connect Syncro and switch integrations on, you need the Manage integrations permission in Simplesat. Owner and Admin have it by default.

You also need a Syncro API token for Simplesat. To create one in Syncro:

  1. Go to Admin → API → API Tokens.

  2. Click New Token and choose Custom Permissions.

  3. Give the token these permissions:

    • Customers - List/Search

    • Customers - View Detail

    • Customers - Edit

    • Tickets - List/Search

    • Tickets - Create

    • Tickets - View Details

    • Tickets - Edit

If the token has an expiration date, the integrations stop working when it expires.

For what a connected tool can read and write, see Integration security, permissions and data flow.

Connect Syncro

Once you have the token:

  1. On the Integrations page in Simplesat, open Syncro.

  2. Click Authenticate.

  3. In Subdomain, enter the part of your Syncro address before .syncromsp.com. For acme.syncromsp.com, enter acme. In API key, paste the API token. Click Authenticate.

  4. When the page shows Authenticated with Syncro, click Activate integration on each integration you want, then fill in its settings.

Simplesat's Authenticate window for Syncro with Subdomain filled in as just the subdomain and the API key pasted, with Cancel and Authenticate

Tip: Before you rely on an integration, test it with a real Syncro ticket by following Testing an integration end to end.

Send surveys from Syncro

A survey in a Syncro email template goes out whenever Syncro sends that email. For example, the Ticket Resolved email goes out when a ticket moves to Resolved. The Simplesat email goes out once per ticket, after Simplesat finds that the ticket has been resolved.

To compare these routes with Simplesat's other delivery methods, see Choosing a survey delivery method.

Syncro email templates

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

  2. Under Choose where to add your survey, choose Syncro.

  3. On Publish, click Generate embed code.

  4. Choose HTML and click Copy survey.

  5. In Syncro, go to Admin → PDF/Email Templates and open the email template that should carry the survey, for example the Ticket Resolved email.

  6. Switch the template editor to its source view, paste the HTML, and save the template.

Syncro's More menu open with Admin at the bottom

Syncro's Administration menu with PDF/Email Templates under Syncro Administration

Syncro's Template Customization page with Email Templates at the top of the list

Syncro's list of email templates with Ticket Resolved Email and its Edit button

A Syncro email template in source view with the Simplesat survey HTML pasted in

The Ticket Resolved email template back in Syncro's visual editor, with How satisfied are you with our service? and the rating buttons under the Syncro placeholders

Note: Syncro sends the Ticket Resolved email only while Enable Ticket Resolved Emails is checked in Syncro.

Syncro's Tickets Settings with Enable Ticket Resolved Emails checked

When Syncro sends the email, it fills in these placeholders in the survey links with the ticket and customer details:

What the link carries

Syncro placeholder

Ticket ID (the ticket number)

{{ticket_number}}

Ticket subject

{{ticket_subject}}

Customer email

{{customer_email}}

Customer name

{{customer_full_name}}

Company

{{customer_business_name}}

Team member name and ID

{{tech_name}}

A link to the ticket

{{ticket_url}}

The link doesn't carry the team member's email. Pull ticket details adds it from the ticket's assigned tech.

For more on placeholders, see Placeholders and merge fields.

Simplesat email when a Syncro ticket is resolved

  1. Create the survey with Direct email delivery → Event-based.

  2. On its Delivery subtab, set Connected service to Syncro, so the Ticket integrations run on its responses.

  3. On the Syncro page, click Activate integration on Send email survey after resolving a ticket.

  4. In Survey, choose the survey and click Save.

The survey's Delivery subtab with Suppression, Delay and Connected service set to Syncro

The Field mapping of Send email survey after resolving a ticket with an event-based survey chosen in Survey and the Save button

Every hour, the integration checks Syncro for tickets resolved in the past hour, so it picks up a ticket within about an hour of the ticket being resolved. The survey's own Delay (in hours) and Suppression (in days per customer) then apply. A ticket resolved while the integration is off isn't surveyed later.

The email goes to the contact on the ticket. A ticket with no contact, or whose contact has no email address, gets no survey. Each ticket gets the survey once, even if it's resolved again.

Each response comes in with the ticket's contact, and with the ticket's assigned tech as the team member. Its ticket ID is Syncro's internal ID for the ticket, not the ticket number Syncro shows. On this route, Pull ticket details and Reopen a ticket after receiving feedback don't find the ticket. If you need either one, put the survey in a Syncro email template instead.

Heads up: If your Syncro Ticket Resolved email also carries a survey, the contact gets two. Use one route or the other.

Note: The older version, marked deprecated, emails the Syncro customer's email address instead of the ticket's contact. It takes the survey's Endpoint in its Field mapping instead of a Survey setting, and it doesn't check whether a ticket has already been surveyed. It's listed only on workspaces where it's on, and it leaves the page once it's turned off.

These emails show on the survey's Email activity. If one doesn't arrive, When a survey does not send lists what to check.

Feedback in Syncro

The integrations in this section run no sooner than five minutes after a response arrives, and again when the response changes. Out of the box, each one runs for every survey it applies to. To limit one to certain surveys, go to When should this integration run?, choose Let me choose, and pick the surveys. The details are in Writing feedback back, and mapping the fields.

Add notes to rated tickets

With this integration on, anyone who opens a rated ticket in Syncro sees the response on it, as a private comment that customers don't see. The comment has the subject Simplesat feedback, every question and answer, and the rating as an emoji.

If the response changes after the comment is added, for example when the customer answers another question, another comment is added.

Update ticket custom fields with rating details

Use this integration when you want the rating in a field on the ticket rather than in a comment. By default, its Field mapping writes the rating to a ticket custom field named Rating, the sentiment to Sentiment, and the answer to the follow-up question to Comment. The mapping lists standard Syncro ticket fields but none of your other custom fields, so your Syncro fields need exactly those names, with no extra spaces.

In Syncro, custom fields belong to a ticket type, under Admin → Ticket Custom Fields, and a ticket has only the fields of the type it uses. Add the three fields to each ticket type you survey.

A Syncro ticket's Custom Fields (Simplesat Feedback) panel with Rating 4, Sentiment positive and Comment filled in

Update contact custom fields with rating details

To show a customer's latest score on their record in Syncro, this integration writes the latest rating and comment to custom fields on the Syncro customer whose email matches the response's customer email. If no Syncro customer has that email, it writes nothing.

A Syncro customer's Custom Fields with Latest NPS 10 and Latest NPS comment

Its Field mapping has rows for customer custom fields named Latest CSAT, Latest NPS, Latest CES and Latest 5-Star, each with a matching Comment field, such as Latest NPS Comment. It also lists the standard Syncro customer fields. Your Syncro customer custom fields need those exact names.

Heads up: By default, it writes the rating to Latest NPS and the follow-up answer to Latest NPS Comment, whatever the survey's metric. For a CSAT survey, map the rating to Latest CSAT and the follow-up answer to Latest CSAT Comment instead. One mapping covers every survey the integration runs for. If your surveys use different metrics, use Let me choose under When should this integration run? to limit it to the surveys that match your mapping.

Ticket, customer and tech details in Simplesat

Each response starts with the details the survey brought in. For a survey in a Syncro email, they come from the placeholders in the link. On the Simplesat email route, they come from the ticket. As soon as the response arrives, Pull ticket details finds the ticket by its ticket number and fills in:

  • the ticket number and subject

  • the customer's name, email, Syncro ID and company

  • the ticket's assigned tech, as a team member with the role Assignee, with their name, email and Syncro user ID

On the Simplesat email route, Pull ticket details doesn't find the ticket. If you need it, put the survey in a Syncro email template instead.

Values from Syncro replace the ones that came from the survey link. Attribution: linking feedback to tickets, customers and agents covers how Simplesat uses these details.

Follow up on feedback in Syncro

Create follow-up tickets from feedback

When a response needs follow-up, this integration opens a new Syncro ticket for it. Out of the box, it opens one for every response from any survey. To open tickets only for some sentiments, go to When should this integration run?, choose Let me choose, then turn on the switches for the sentiments you want, for example neutral and negative.

The ticket is opened for the Syncro customer whose email matches the response's customer email. If none matches, no ticket opens.

The new ticket's subject is New sentiment feedback from customer name on ticket ticket ID, for example New negative feedback from Ana Lopez on ticket 10019. Its first comment is private and from Simplesat. It says who left what feedback on which survey, lists every answer, and links to the response in Simplesat.

Syncro's Tickets list with a new ticket titled New positive feedback from Josh Walker on ticket 49246681 in status New

In its Field mapping, you can set the new ticket's Status, Priority, Problem Type and Ticket Type ID.

It runs when a response arrives and again when the response changes, so a changed rating can open a second ticket.

Reopen a ticket after receiving feedback

To put a rated ticket in front of a tech again, this integration sets its status back to New. It finds the ticket by its ticket number. Out of the box, it does this for every rated ticket, positive ratings included. To reopen tickets only for some sentiments, go to When should this integration run?, choose Let me choose, then turn on the switches for the sentiments you want, for example neutral and negative.

When should this integration run? set to Let me choose, with the neutral and negative switches on and the positive ones off for one survey

On the Simplesat email route, this integration doesn't find the ticket. If you need it, put the survey in a Syncro email template instead.

Change the Syncro API token or subdomain

Reconnect to use a new API token or a different Syncro subdomain. You also need to reconnect if the token expires or is deleted in Syncro. The integrations stop, even though the page still shows Authenticated with Syncro. Reconnecting keeps each integration's settings and switches back on any that were on before.

  1. On the Syncro page, click Revoke access.

  2. Click Authenticate and enter the subdomain and the new API token.

  3. Check that each integration you use shows Deactivate integration, which means it's on. If one is still off, click Activate integration. Responses that arrive between Revoke access and Authenticate aren't written to Syncro, so do these steps in one go.

Survey code in your Syncro email templates keeps working.

Troubleshooting

My survey email doesn't go out when a Syncro ticket is resolved

Check these:

  • Send email survey after resolving a ticket is active and has a survey chosen in Survey.

  • Enough time has passed. The integration checks every hour for tickets resolved in the past hour, and then the survey's Delay applies.

  • The ticket wasn't resolved while the integration was off. Those tickets aren't surveyed.

  • The ticket has a contact, and the contact has an email address.

  • Suppression isn't holding the email back because the contact was surveyed recently.

Then look for the email on the survey's Email activity.

The survey goes to the customer's main email address, not the ticket's contact

That's how the older Send email survey after resolving a ticket, marked deprecated, works: it emails the Syncro customer's email address. The current version emails the contact on the ticket. Turn on the current version and choose the survey in Survey, then turn the older one off. Once it's off, the older one leaves the page.

Add notes to rated tickets doesn't add anything to my Syncro tickets

Check these:

  • The survey is connected to Syncro, and the response carries the Syncro ticket ID.

  • At least five minutes have passed since the response came in.

  • The integration shows as active. After Revoke access and Authenticate, it switches back on by itself if it was on. If it's still off, click Activate integration.

If none of these explains it, send us the response's link.

My Syncro ticket custom fields aren't updating

Check these:

  • The fields are named exactly Rating, Sentiment and Comment, with no extra spaces.

  • The rated ticket uses a ticket type that has those fields.

  • The survey is connected to Syncro, and the response carries the ticket ID.

  • At least five minutes have passed since the response came in.

My Syncro custom field isn't in the Field mapping

The Field mapping lists only custom fields with the names Simplesat expects. For Update ticket custom fields with rating details, those are Rating, Sentiment and Comment. For Update contact custom fields with rating details, they're Latest CSAT, Latest NPS, Latest CES and Latest 5-Star and their Comment fields. Syncro custom fields with other names don't appear, so name your Syncro fields to match. To get every answer onto the ticket, use Add notes to rated tickets.

The ticket ID on my response doesn't match the ticket number in Syncro

Responses from the Simplesat email carry Syncro's internal ID for the ticket, which isn't the ticket number Syncro shows. Responses from a survey in a Syncro email carry the ticket number.

I see two notes or two follow-up tickets for one response

Add notes to rated tickets and Create follow-up tickets from feedback run when a response arrives and again when it changes, for example when the customer later answers another question or changes their rating. Each run adds a comment or opens a ticket.

My Syncro integrations stopped working, but the page still says Authenticated with Syncro

Simplesat doesn't check the connection after you connect. If the API token expires, is deleted or loses permissions in Syncro, the integrations fail while the page still shows Authenticated with Syncro. To fix it:

  1. In Syncro, create a new token with the permissions in Before you start.

  2. On the Syncro page, click Revoke access.

  3. Click Authenticate and enter your subdomain and the new token.

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

FAQ

The HTML. Generate the code from a survey set to External email embed → Syncro, choose HTML, copy it, and paste it into the template's source view.

How long after a ticket is resolved does the email survey go out?

Within about an hour, plus the survey's Delay. The integration checks Syncro every hour for tickets resolved in the past hour.

Will a customer get another survey if their ticket is resolved again?

Not from the current Send email survey after resolving a ticket, which surveys each ticket once. The older version, and a survey in a Syncro email template, send again each time the ticket is resolved.

My Send email survey after resolving a ticket is marked deprecated. Do I need to change it?

The deprecated version keeps working while it's on. The current version emails the ticket's contact instead of the customer's main address, and it surveys each ticket once. To move, turn on the current version and choose the survey in Survey, then turn the older one off. Don't leave both on, or a ticket can get two emails. Once the older one is off, it leaves the page.

Which survey metrics does Update contact custom fields with rating details write?

Whichever you map. By default, it writes the rating to Latest NPS and the follow-up answer to Latest NPS Comment. For a CSAT, CES or 5-Star survey, map the rating and comment to that metric's fields in the Field mapping.

Did this answer your question?