You can put a Simplesat survey in the emails Atera sends your customers, such as the one that goes out when a ticket is resolved. Survey code pasted into an Atera email template works on its own, without connecting Atera.
Connect Atera as well, and each rating is saved on its ticket and on the customer's contact in Atera. Responses in Simplesat pick up the ticket's details too, along with the customer's email from the ticket.
What the Atera integrations do
The Atera page in Simplesat lists its integrations under Survey integrations and Ticket integrations. You switch each one on separately with Activate integration, and none of them has settings.
Integration | Listed under | What it does | Where it shows |
Sync feedback to user custom fields | Survey integrations | Saves the customer's latest rating and sentiment in custom fields on their Atera contact | The contact in Atera |
Pull ticket details | Ticket integrations | Adds the ticket's details and the customer to the response | The response, in Simplesat |
Sync feedback to ticket custom fields | Ticket integrations | Saves the rating, sentiment and comment in custom fields on the ticket | The ticket in Atera |
The integrations under Ticket integrations run only on surveys connected to Atera. A survey is connected when its delivery method is External email embed with the Atera option, or when it's an Event-based or Web-embed survey with Connected service set to Atera. They find the ticket by the response's ticket ID, which the survey code fills in from Atera's {[Ticket Number]}.
Before you start
The Atera integrations are available on every Simplesat plan.
In Simplesat, connecting Atera and switching integrations on needs the Manage integrations permission. Owner and Admin have it by default.
In Atera, you'll need an admin to get the API key. Atera offers API keys on paid subscriptions, not during its free trial.
Integration security, permissions and data flow covers what a connected tool can read and write.
Connect Atera
In Atera, open the API page in the Admin settings, click the eye icon to show your API key, and copy it.
In Simplesat, open Atera on the Integrations page.
Click Authenticate.
In API Key, paste the key and click Authenticate.
When the page shows Authenticated with Atera, click Activate integration on each integration you want.
Before you rely on an integration, test it with a real ticket, as Testing an integration end to end describes.
Send surveys in Atera emails
First, copy the survey code in Simplesat:
Create or open the survey and choose External email embed.
Under Choose where to add your survey, choose Atera.
On Publish, click Generate embed code, choose HTML, and click Copy survey.
Then add the code to an Atera email template:
In Atera, go to Admin → Support and ticketing → Email templates.
Open the template that should carry the survey, or create a new one.
Click the Code View icon in the email body's toolbar.
Paste the code where the survey should appear, and click Save.
Create a ticket automation rule with the condition Status Equals Resolved and the action Send an Email to Contact, using your template. Atera then sends it whenever a ticket is resolved.
Because the survey goes out in the email for each resolved ticket, every ticket gets its own survey.
To test it, create a ticket with yourself as the contact, resolve it, and click a rating in the email.
The survey code carries Atera placeholders, and Atera fills them in when it sends the email:
What the code carries | Atera placeholder |
Ticket ID |
|
Ticket subject |
|
Customer first name |
|
Customer last name |
|
Customer email |
|
Team member email |
|
Atera's templates have no placeholder for the contact's or the technician's email address. Instead, the survey code builds both emails from names. A response from Jane Smith's ticket, handled by Sam Lee, arrives with the customer email [email protected] and the team member email [email protected]. Pull ticket details replaces the customer with their real Atera contact. Nothing replaces the team member, so each technician stays under the made-up email built from their name.
See Placeholders and merge fields for how placeholders work in other tools.
Feedback in Atera
Simplesat waits at least five minutes after a response arrives before it writes to Atera, and writes again whenever the response changes. Writing feedback back, and mapping the fields has the details.
Both integrations write to Atera custom fields by name. Create those fields in Atera first, with exactly the names below. You'll find custom fields in Atera's Admin settings.
Sync feedback to ticket custom fields
This integration writes to custom fields on the response's ticket. Create these as ticket fields:
Simplesat rating, type Number: the rating.Simplesat sentiment, type Text:positive,neutralornegative.Simplesat comment, type Text: the answer to the follow-up question after the rating.
Sync feedback to user custom fields
This integration keeps the customer's latest rating and sentiment on their Atera contact. Create these custom fields for contacts, all type Text:
Latest CSATLatest NPSLatest CESLatest 5-starLatest sentiment
Each response writes its rating to the field for its metric, and its sentiment to Latest sentiment.
It finds the contact through the response's ticket. If a response has no ticket ID, or no Atera ticket matches it, nothing is written.
Heads up: Unlike the ticket integrations, this one runs on responses from every survey in your workspace, and you can't choose which surveys it uses. If you also send surveys from another tool, a response from that tool whose ticket ID matches an Atera ticket can update an unrelated Atera contact. Switch it on only if your surveys go out from Atera.
Ticket and customer details in Simplesat
A response's ticket and customer details start out as whatever Atera fills into the survey code's placeholders. Pull ticket details can then replace them with what's on the ticket. For the bigger picture, read Attribution: linking feedback to tickets, customers and agents.
Pull ticket details
This integration looks up the response's ticket in Atera and updates the response with:
the ticket's subject (its title in Atera)
the ticket fields
number,priority,type,sourceandimpactthe customer: the ticket's contact, with their real email, name and Atera ID
It runs at least five minutes after a response arrives, and again whenever the response changes.
Change the Atera API key
Reconnect when your Atera API key is reset, or to connect a different Atera account. Atera stops accepting the old key as soon as it's reset. Simplesat doesn't recheck the key after you connect, and the page keeps showing Authenticated with Atera even while the integrations fail.
On the Atera page, note which integrations are on.
Click Revoke access.
Click Authenticate and paste the new key.
Click Activate integration on each integration you noted. Responses that arrive between Revoke access and this step aren't written to Atera.
Survey code already in your Atera templates keeps working.
Troubleshooting
My responses show team members with emails like [email protected]
Atera's email templates have no email placeholder for technicians. The survey code builds the team member's email from the technician's first and last name plus @email.com instead. Each technician keeps the same made-up email as long as their name in Atera doesn't change. Pull ticket details replaces the customer with the real contact, but it doesn't change the team member.
Feedback doesn't show up in my Atera ticket fields
Check that:
The ticket fields exist, named exactly
Simplesat rating,Simplesat sentimentandSimplesat comment.The survey is connected to Atera, and the response came in with the ticket ID from
{[Ticket Number]}.At least five minutes have passed since the response arrived.
Sync feedback to ticket custom fields shows as active on the Atera page. After Revoke access and Authenticate, you need to click Activate integration again.
If none of these explains it, send us the response's link.
Pull ticket details doesn't add anything to my responses
It needs the ticket ID, which the survey code fills in from {[Ticket Number]}, and it runs only on surveys connected to Atera. Give it at least five minutes after the response arrives.
My Atera integrations stopped working, but the page still says Authenticated with Atera
The usual cause is a reset Atera API key. Reconnect with the new key and switch your integrations back on, as described in Change the Atera API key. If the page shows an error, look it up in Integration error messages and what they mean.
FAQ
Can I send a survey for every ticket, not just once per customer?
Yes. Put the survey in the email Atera sends when a ticket is resolved. Each email carries that ticket's number, which gives every resolved ticket its own survey. The steps are in Send surveys in Atera emails.
Do I need to connect Atera to send surveys?
No. Survey code in an Atera email works without connecting. Connect Atera if you want ratings written into Atera and ticket details pulled into Simplesat.
Why do my Simplesat customers have email addresses ending in @email.com?
The survey code builds each customer's email from their first and last name, because Atera's templates have no email placeholder. Switch on Pull ticket details, and each response's customer becomes the ticket's contact, with their real email.