You can put a Simplesat survey in the emails LiveAgent sends your customers, so they can rate a ticket from an email like the one telling them it's resolved. The survey works without connecting LiveAgent.
Connecting LiveAgent lets you write each rating to ticket and contact fields in LiveAgent, open a follow-up ticket from a response, and bring ticket, customer and agent details into Simplesat.
What the LiveAgent integrations do
The LiveAgent page in Simplesat groups its integrations under Survey integrations and Ticket integrations. You switch each one on separately with Activate integration.
Integration | Listed under | What it does | Where it shows |
|---|---|---|---|
Update contacts with rating details | Survey integrations | Writes the rating and other response details to up to three custom fields on the customer's contact | The contact in LiveAgent |
Create follow-up tickets from feedback | Survey integrations | Opens a new LiveAgent ticket from a response | A new ticket in LiveAgent |
Pull ticket details | Ticket integrations | Adds the ticket's subject, customer and agent to the response | The response, in Simplesat |
Update ticket custom fields with rating details | Ticket integrations | Writes the rating and other response details to up to three custom fields on the rated ticket | The ticket in LiveAgent |
The Ticket integrations run only on surveys connected to LiveAgent, and only for responses that came in with a LiveAgent ticket ID. A survey is connected when its delivery method is External email embed with the LiveAgent option, as in the steps below. Event-based and Web-embed surveys are connected when Connected service is set to LiveAgent.
Before you start
The LiveAgent integrations come with every Simplesat plan. To connect LiveAgent and switch integrations on, you need the Manage integrations permission, which Owner and Admin have by default.
You'll also need a LiveAgent API key. A LiveAgent admin creates it under Configuration → System → API, in the API v3 section, and gives it these permissions while adding it:
Module | Access |
|---|---|
Agent | read |
User | read |
Tag | read, manage |
Ticket | create, read, operate |
Contact | create, read, edit |
If you'll write ratings to custom fields, create those fields in LiveAgent first. Go to Configuration → System → Ticket fields or Contact fields, then click Create. Each field has a code made of lowercase letters, numbers, hyphens or underscores.
For what a connected tool can read and write, see Integration security, permissions and data flow.
Connect LiveAgent
On the Integrations page, open LiveAgent.
Click Authenticate.
In Subdomain, enter the part of your LiveAgent address before
.ladesk.com. Foracme.ladesk.com, enteracme.In API Key, paste the API key, then click Authenticate.
When the page shows Authenticated with LiveAgent, click Activate integration on each integration you want, then fill in its settings.
If authenticating fails, check both values for spaces at the end.
Send surveys in LiveAgent emails
Create or open a survey and choose External email embed.
Under Choose where to add your survey, choose LiveAgent.
On Publish, click Generate embed code.
Choose HTML and click Copy survey.
In LiveAgent, go to Configuration → Email → Customer templates and open the template that should carry the survey, such as Ticket resolved, the email LiveAgent sends when a ticket is resolved.
Click where the survey should go, click the source icon, and paste the code.
Click the source icon again to preview the survey, then click Save.
The code carries LiveAgent placeholders for the ticket, the customer and the agent, and LiveAgent fills them in when it sends the email. The ticket ID comes from {$conversationId} and arrives with each response. The Ticket integrations use it to find the ticket. Placeholders and merge fields explains how placeholders get filled in across tools.
To test, create a ticket with yourself as the customer, resolve it, and click a rating in the email you get. Run a test like this before you rely on any of the integrations, as Testing an integration end to end describes.
Feedback in LiveAgent
Simplesat waits at least five minutes after a response arrives before it writes to LiveAgent, and writes again whenever the response changes. You'll find more on the timing and on Field mapping in Writing feedback back, and mapping the fields.
Update ticket custom fields with rating details
Its Field mapping has a pair of rows for each of the three fields, a code row and a value row. In Customfield1 Code, choose Type a value and type the LiveAgent field's code exactly as it appears in LiveAgent, because Simplesat doesn't check it. In Customfield1 Value, choose Use data from response and pick what Simplesat writes there, such as the rating, sentiment or comment. Fill in the second and third pairs the same way, or leave a pair as it is if you don't need it.
The Field mapping also lists other LiveAgent ticket fields. Leave those on Ignore.
You can narrow it to certain surveys under When should this integration run?.
Update contacts with rating details
Simplesat finds the contact by matching the customer email on the response to a LiveAgent contact's email. If no contact matches, nothing is written. Its Field mapping has the same six rows as the ticket integration, from Customfield1 Code to Customfield3 Value. You could use it to keep a contact field that holds the customer's latest rating.
The Field mapping also lists the contact's other LiveAgent fields, such as Firstname, Emails and Phones. Leave those on Ignore.
Heads up: Unlike the ticket integration, this one runs for responses from every survey, LiveAgent or not, until you narrow it the same way.
Ticket, customer and agent details in Simplesat
The placeholders in your survey code already give each response its ticket, customer and agent. How Simplesat makes those connections is the subject of Attribution: linking feedback to tickets, customers and agents.
Pull ticket details
Pull ticket details reads the ticket as soon as a response arrives, and again whenever the response changes. It replaces the response's details with:
the ticket's subject
the customer's name and LiveAgent contact ID, plus their company if the contact has one
the ticket's agent, as the team member with the role Agent, including their name, email and LiveAgent ID
Heads up: Currently, it takes the customer's email from the Description field of their LiveAgent contact, not from their email address, so the customer email on a response can end up wrong. If you need the email from the survey link, keep Pull ticket details off.
Follow-up tickets in LiveAgent
Create follow-up tickets from feedback opens a new LiveAgent ticket for each new response, for the surveys and sentiments you switch on under When should this integration run?.
In its Field mapping, enter the ID of the LiveAgent agent the tickets are created as in Useridentifier. LiveAgent needs every ticket to come from an agent. If you don't know the agent's ID, contact us with their name and we'll look it up.
Each new ticket:
is for the customer, using their email and name
has the subject New sentiment feedback from customer name, as in New negative feedback from Ana Lopez
shows the customer's name, the sentiment and the survey name, each linked to Simplesat, followed by every question and answer
has the status New and goes to your default department
LiveAgent doesn't email the customer about the new ticket. Only responses with a customer email get a follow-up ticket, and a response that changes later doesn't open a second one.
Follow-ups in general have their own article, Creating a follow-up ticket from feedback.
Change the LiveAgent account or API key
On the LiveAgent page, click Revoke access.
Click Authenticate and enter the subdomain and the new API key.
Any integration that was on before switches back on by itself, with its settings. 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 LiveAgent, so do the steps together. The survey code in your LiveAgent templates keeps working.
Follow the same steps if the API key is deleted or its permissions change in LiveAgent. The integrations stop, even though the page still shows Authenticated with LiveAgent.
Troubleshooting
Feedback doesn't show up in my LiveAgent ticket fields
Check that:
the survey is connected to LiveAgent, and the response came in with the LiveAgent ticket ID from
{$conversationId}at least five minutes have passed since the response arrived
each code in Customfield1 Code to Customfield3 Code matches the field's code in LiveAgent exactly
Update ticket custom fields with rating details shows as active
If none of these explains it, send us the response's link.
My LiveAgent contacts don't get the rating
Update contacts with rating details finds the contact by the customer email on the response. If the response has no email, or no LiveAgent contact has that email, nothing is written. Also check the codes in Customfield1 Code to Customfield3 Code, and that the integration shows as active.
No follow-up ticket is created in LiveAgent
Check that:
the agent ID is filled in Useridentifier, in the Field mapping of Create follow-up tickets from feedback
the response has a customer email
the response's survey and sentiment are switched on under When should this integration run?
Follow-up tickets open only for new responses.
The customer email on my LiveAgent responses changed
Pull ticket details currently takes the customer's email from the Description field of their LiveAgent contact. If that field doesn't hold the customer's email address, the email on the response can change. Keep Pull ticket details off if you need the email from the survey link.
My LiveAgent integrations stopped working, but the page still says Authenticated with LiveAgent
Simplesat doesn't recheck the connection once you've connected. If the API key was deleted or its permissions changed in LiveAgent, the integrations fail, but the page still reads Authenticated with LiveAgent. Click Revoke access, then Authenticate with a working key. 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. If the page shows a message you don't recognize, look it up in Integration error messages and what they mean.
FAQ
Where do I find a LiveAgent agent ID for follow-up tickets?
Contact us with the agent's name and we'll look up the ID for you.
Can the custom-field integrations show a list of my LiveAgent fields?
Not currently. Type each field's code instead. You'll find the codes in LiveAgent under Configuration → System → Ticket fields or Contact fields.
How many LiveAgent fields can one integration fill?
Up to three each: three ticket fields and three contact fields.
Does LiveAgent email my customer when a follow-up ticket is created?
No. The ticket is created without an email to the customer.