Skip to main content

Freshsales integrations

Send Simplesat surveys in your Freshsales emails and get each rating onto its deal and contact.

You can put a Simplesat survey in the emails you send from Freshsales by pasting it into a Freshsales email template. The survey works without connecting Freshsales.

When you connect Freshsales, you can switch on integrations that put each rating on its deal and contact in Freshsales, and add deal details to each response in Simplesat.

What the Freshsales integrations do

The Freshsales page lists its integrations under Account-wide integrations, Survey integrations and Ticket integrations. You switch each one on separately with Activate integration.

Integration

Listed under

What it does

Where it shows

Sync contacts from Freshsales to Simplesat

Account-wide integrations

Adds the contacts in one Freshsales contact view to Simplesat as customers, and updates them once a day

Customers, in Simplesat

Sync feedback to contact custom fields

Survey integrations

Saves the contact's latest rating, sentiment and comment in custom fields on their Freshsales contact

The contact in Freshsales

Create task after receiving feedback

Ticket integrations

Creates a task on the deal

The deal in Freshsales

Add note to deal after receiving feedback

Ticket integrations

Adds the response to the deal as a note

The deal in Freshsales

Sync deal details from Freshsales to Simplesat

Ticket integrations

Adds the deal, its contact and its owner to the response

The response, in Simplesat

The Ticket integrations work with the deal a response came from. In Simplesat, that deal is the response's ticket. These integrations run only on surveys connected to Freshsales, and only on responses whose survey link carried the deal's ID. A survey is connected to Freshsales when:

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

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

Before you start

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

In Freshsales, every API key belongs to one user, and the integrations act as the user whose key you enter. They see only the deals and contacts that user can see, and their notes and tasks come from that user. So use the key of someone who can see all the deals and contacts you survey and who will keep their Freshsales access.

You can check what a connected tool can read and write in Integration security, permissions and data flow.

Connect Freshsales

  1. In Freshsales, click your profile picture, choose Profile Settings, and open the API Settings tab.

  2. Copy the key in Your API key, and the bundle alias shown below it, such as acme.myfreshworks.com/crm/sales.

  3. In Simplesat, go to the Integrations page, open Freshsales and click Authenticate.

  4. In URL, enter the bundle alias without https://, such as acme.myfreshworks.com/crm/sales. In API Key, enter the API key. Click Authenticate.

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

Before you rely on an integration, test it on a real deal with the steps in Testing an integration end to end.

Send surveys from Freshsales

To put a survey in your Freshsales emails:

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

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

  3. On Publish, click Generate embed code.

  4. Choose Visual and click Copy survey.

  5. In Freshsales, open your email templates in Admin settings, create or open a template, paste the survey at the bottom of the message, and save it.

When Freshsales sends the email, it fills in these placeholders in the survey links:

What the link carries

Freshsales placeholder

Ticket ID (the deal's ID)

{{deal.id}}

Customer email

{{contact.email}}

Customer ID

{{contact.id}}

Customer first name

{{contact.first_name}}

Customer last name

{{contact.last_name}}

Company

{{contact.account_name}}

Team member first name

{{user.name}}

Team member email

{{user.email}}

Territory, source, type, value and campaign, saved as ticket fields on the response

{{deal.territory}}, {{deal.lead_source}}, {{deal.deal_type}}, {{deal.amount}}, {{deal.campaign}}

A placeholder whose field is empty goes out blank. The Ticket integrations work only on responses whose link carried the deal's ID from {{deal.id}}. So before you rely on them, send a test email the same way you'll email customers, answer the survey, and check that the integrations act on your response, for example that a note shows up on the deal.

To learn how placeholders work in every tool, see Placeholders and merge fields.

Feedback in Freshsales

Simplesat waits at least five minutes after a response arrives before it writes to Freshsales, and writes again whenever the response changes. Writing feedback back, and mapping the fields has the timing and settings for every tool.

Add note to deal after receiving feedback

Every response from a survey connected to Freshsales goes on its deal as a note, posted by the Freshsales user whose API key is connected. The note opens with who left what feedback on which survey, linked back to Simplesat. Every question and answer follows, with each rating next to its label and follow-up answers under their question.

If the response changes later, for example when the customer answers another question, a second note is added.

Sync feedback to contact custom fields

First, add these custom fields to contacts in Freshsales:

Field

Internal name

Type

Latest CSAT

cf_latest_csat

Number

Latest CES

cf_latest_ces

Number

Latest NPS

cf_latest_nps

Number

Latest 5-star

cf_latest_5star

Number

Latest sentiment

cf_latest_sentiment

Text field

Latest comment

cf_latest_comment

Text area

The integration has a setting for each field's internal name, such as Latest CSAT field internal name, and these settings already hold the names above. If your fields have different internal names in Freshsales, enter yours and click Save.

This integration runs on responses from every survey, including surveys that aren't connected to Freshsales. Simplesat writes to the Freshsales contact whose email matches the customer email on the response. If the response has no email, or no contact has that email, nothing is written.

Each response fills the field for its survey's metric, plus sentiment and comment. Fields for other metrics keep their values, and so does Latest comment when a response has no comment.

Deal, contact and owner details in Simplesat

To see how Simplesat connects a response to its deal, contact and sender, read Attribution: linking feedback to tickets, customers and agents.

Sync deal details from Freshsales to Simplesat

When a response with a deal ID comes in from a survey connected to Freshsales, Simplesat reads the deal right away and adds:

  • the deal's name as the response's ticket subject, and its source, type, value, campaign and territory as ticket fields

  • the deal's first contact as the customer, with their name, email and Freshsales ID, and their account as the company

  • the deal's owner as the team member, with their name, email, Freshsales ID and the role Owner

  • the people who created and last updated the deal, as other team members on the response

It runs again whenever the response changes.

Sync contacts from Freshsales to Simplesat

Choose which Freshsales contact view to bring in with Filter name, under the integration's Field mapping. It's set to All Contacts by default, and the name has to match a contact view in Freshsales exactly.

The sync runs once a day. Its first run adds every contact in the view to Simplesat as a customer, and each run after that brings in the contacts updated in the past day. Customers come in with their name, email and Freshsales contact ID, and nothing is written to Freshsales. Contact syncs in general are explained in Contact sync from a connected tool.

Tasks in Freshsales

Create task after receiving feedback puts a task on the deal when a response arrives, and another if the response changes later. The task goes to the deal's owner. It's due Due date in days after the response, which is 7 by default. Its title reads New sentiment feedback from customer name on survey survey name, for example "New negative feedback from Ana Lopez on survey Sales CSAT".

Heads up: Turn on Sync deal details from Freshsales to Simplesat too. Simplesat gets the deal's owner from it, and Freshsales won't create a task without an owner.

Until you change When should this integration run?, every response from Freshsales surveys creates a task, positive ones included. To create tasks for some sentiments only, choose Let me choose there, then turn on the switches for the surveys and sentiments you want, such as neutral and negative. All the switches are off until you turn them on.

One article covers follow-ups for every tool: Creating a follow-up ticket from feedback.

Change the Freshsales connection

To connect with another user's API key, or to a different Freshsales account:

  1. Note which integrations are on.

  2. Click Revoke access.

  3. Click Authenticate, enter the new API key and bundle alias, then click Authenticate.

  4. Click Activate integration on each integration you noted.

Your integrations keep their settings, but reconnecting doesn't switch any of them back on. Responses that arrive between Revoke access and turning the integrations back on aren't written to Freshsales, so do all four steps in one go. You don't need to touch your email templates, because the survey code in them keeps working.

If the connected user ever loses their Freshsales access, the integrations stop working while the page still shows Authenticated with Freshsales. Reconnect with the same steps.

Troubleshooting

I can't connect Freshsales

The key has to be the one in Your API key on that user's API Settings tab in Freshsales. The second value is the bundle alias shown below it, such as acme.myfreshworks.com/crm/sales, without https://. If it still fails, contact us.

Notes or tasks don't show up on my Freshsales deals

Check these:

  • The survey is connected to Freshsales, and the response carries the deal's ID. The link gets the ID when Freshsales fills in {{deal.id}}.

  • At least five minutes have passed since the response arrived.

  • The integration shows as active. After Revoke access and Authenticate, you have to click Activate integration again.

  • For tasks, Sync deal details from Freshsales to Simplesat is on, so the task has an owner.

  • For tasks set to Let me choose, the response's sentiment is switched on for its survey.

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

The custom fields on my Freshsales contacts aren't updated

Check these:

  • The response has a customer email, and that email belongs to a Freshsales contact.

  • Each of the six internal-name settings holds the internal name of a custom field that exists on contacts in Freshsales.

  • At least five minutes have passed since the response arrived.

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

No contacts came in from Freshsales

Filter name has to match the name of a contact view in Freshsales exactly. Unless you've changed it, it's All Contacts. The sync runs once a day: the first run brings in every contact in the view, and later runs bring in the contacts updated in the past day. Also check that the integration shows as active.

I see two notes or two tasks for one response

Add note to deal after receiving feedback and Create task after receiving feedback run when a response arrives and again when it changes, for example when the customer answers another question or changes their rating. Each run adds a note or creates a task.

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

Simplesat doesn't check the connection again after you connect. If the user whose API key is connected loses their Freshsales access, the integrations fail and the page still reads Authenticated with Freshsales. Click Revoke access, then Authenticate with the key of a user who has access, then click Activate integration on each integration you use.

FAQ

Do I need to connect Freshsales to send surveys?

No. The survey works in your Freshsales emails on its own. Connecting is what adds the notes, tasks, custom fields and deal details.

Who is the follow-up task assigned to?

The deal's owner. Simplesat gets the owner from Sync deal details from Freshsales to Simplesat, so keep that integration on.

Can tasks be created only for negative ratings?

Yes. In When should this integration run?, choose Let me choose and turn on only the negative switches for the surveys you want.

Which contacts does the contact sync bring in?

The contacts in the Freshsales contact view named in Filter name, which is All Contacts unless you change it. Each one comes in with their name, email and Freshsales contact ID.

Did this answer your question?