Skip to main content

Atera integrations

Send a Simplesat survey on every resolved Atera ticket and save each rating to the ticket and contact in Atera.

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

  1. In Atera, open the API page in the Admin settings, click the eye icon to show your API key, and copy it.

  2. In Simplesat, open Atera on the Integrations page.

  3. Click Authenticate.

  4. In API Key, paste the key and click Authenticate.

  5. 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:

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

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

  3. On Publish, click Generate embed code, choose HTML, and click Copy survey.

Then add the code to an Atera email template:

  1. In Atera, go to Admin → Support and ticketing → Email templates.

  2. Open the template that should carry the survey, or create a new one.

  3. Click the Code View icon in the email body's toolbar.

  4. Paste the code where the survey should appear, and click Save.

  5. 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 Number]}

Ticket subject

{[Ticket Title]}

Customer first name

{[Contact First Name]}

Customer last name

{[Contact Last Name]}

Customer email

{[Contact First Name]}{[Contact Last Name]}@email.com

Team member email

{[Technician First Name]}{[Technician Last Name]}@email.com

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, neutral or negative.

  • 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 CSAT

  • Latest NPS

  • Latest CES

  • Latest 5-star

  • Latest 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, source and impact

  • the 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.

  1. On the Atera page, note which integrations are on.

  2. Click Revoke access.

  3. Click Authenticate and paste the new key.

  4. 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 sentiment and Simplesat 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.

Did this answer your question?