Skip to main content
Using the Salesforce app in Intercom

The salesforce app lets your sales and support team see up to date SFDC data, create cases, send conversations as tasks and more.

Beth-Ann Sher avatar
Written by Beth-Ann Sher
Updated over 2 months ago

Our two way Salesforce app keeps your data in sync with regular updates in the direction you choose; Intercom to Salesforce, or Salesforce to Intercom.

With the Salesforce app installed you can:

This article is about using the Salesforce app. Read this article to learn how to install and configure the app from the app store.

View users and leads’ Salesforce data in your inbox

With the Salesforce app installed, you can also add the Inbox app so your team can view live Salesforce details as you chat.

The Inbox app shows you a live view of data as it exists in Salesforce, this is not the data mapped to or from your native Intercom attributes. The data synced by those mappings can be seen in the user details panel in the inbox, or on a user’s profile.

Just click "Edit apps":

Then, click the pin icon next to the Salesforce inbox app:

Now, if you’re chatting with a user or lead who exists in Salesforce, you’ll see the Salesforce contact and additional information displayed in the inbox app alongside the conversation:

Important: This app doesn’t show all of your mapped attributes, those are visible in the regular user details

You can also see their status, account owner and more. This will help you understand the stage your lead is at, so you can nurture and convert them to paying customers faster. To see their full Salesforce record, just click ‘Open in Salesforce’.

Pro tip: For a more comprehensive sync of your Salesforce data, configure two way attribute mapping in the salesforce app settings.

Note: The inbox app displays different data for contacts, accounts, and opportunities:

  • When it’s a contact, you’ll see the name, email address, and account owner.

  • If it’s an account, you’ll see the name, domain, account owner and country.

  • For opportunities, you’ll see the owner, stage, close date and amount.

Intercom records are matched in Salesforce like this:

  • Intercom lead — Salesforce lead

  • Intercom user — Salesforce contact

  • Intercom company — Salesforce account

Send leads from Intercom to Salesforce

When you’re chatting to a new lead in Intercom, who doesn’t exist in Salesforce, you can click ‘Create Lead’ to send them to Salesforce as a new lead:

The inbox app will then display the lead profile (as shown above 👆). If they are converted in Salesforce, you’ll see the contact or account details here too.

Important:

  • A lead must have an email address before they can be sent to Salesforce.

  • You can also create a Salesforce lead from a lead/user’s profile in Intercom.

  • When a new lead is created in Salesforce via the Intercom Inbox, the owner in Salesforce will default to the Intercom owner if one is set. (Enable this in the Salesforce app settings under "Maintain lead and account ownership").

Leads sent to Salesforce are created with the fields you configured when installing the Salesforce app:

Important:

  • You can edit a lead’s data in Intercom before sending to Salesforce.

  • If the lead is missing details, a placeholder is sent to Salesforce.

  • If you edit a lead’s data in Intercom after sending them to Salesforce, this data will also update in Salesforce.

Note: At the moment, the app only supports Salesforce Lead creation. Contact creation/conversion can only be done in Salesforce.

Auto Case Creation

Automatically create and update Salesforce cases where required with Auto Case Creation. Cases can be created and updated through a range of triggers such as Workflows, Custom Answers, and global triggers.

Requirements to use Auto Case Creation:

  • Check that the Salesforce integration app owner account has permission to create Cases in Salesforce.

  • Ensure that the current Intercom User is mapped as a Contact in Salesforce.

Configure cases

To enable Auto Case Creation, you will need to configure cases in the Salesforce app. Go to the Settings tab and open “Set up cases”.

Here you will find a section “Create cases automatically”. You can use Global triggers to choose when to create or update a Salesforce Case automatically by toggling these on.

Note: When a conversation is closed, the transcript in the case is updated but the case status won't be updated/closed.

Set a default Case Record Type

Control what Case Record Type is used when creating a case by setting a default.

Note: If “None” is selected, the default CRT will be used according to your Salesforce configuration. Under “Case record types” setting you can select the default CRT to automatically create cases with.

Set up Attribute Mappings

If you want to send conversation data from Intercom to populate Salesforce case fields, you can map Conversation Attributes. Some attributes have already been mapped to allow a case to be created in Salesforce. To choose which data is automatically sent to Salesforce from a conversation, click “Map new attribute”.

Under the Intercom attributes you will find Conversation Attributes that can be mapped to case fields in Salesforce.

You can map Conversation Attributes from:

  • Conversation data - Such as the Product Area that the conversation relates to which allows you to have specialist teams handle different features. Learn how to use Conversation Attributes for advanced Inbox workflows here.

  • Workflow responses - Such as a customer’s email address collected during a conversation with your Workflow.

Select the attributes you want to map from the dropdown menus and click “Add” to save the mapping to the list.

Important: Attribute Mappings will always apply when a case is automatically created in Salesforce.

To apply your changes, click “Save settings” in the bottom right corner.

Note: When a case is automatically created, mapped attributes will update every time the conversation is closed. For example, if a conversation is re-opened and conversation data attributes are updated in Intercom, the mapped attributes will also update in Salesforce when the conversation is closed again.

Automate with Workflows

Create and update Salesforce cases straight from customer conversations using Workflows.

To set this up, go to Workflows and open or create the Workflow where you want a Salesforce case to be created or updated. Click the + icon inside a path to add a new action, then select “Create case in Salesforce”.

Automate with Custom Answers

Custom Answers support Auto Case Creation in Salesforce by using a similar Workflow builder.

To define when a Salesforce case should be created or updated, simply navigate to Fin AI Agent > Custom Answers and open or create a new answer. From the New answer section, click + Add step inside a path, then select “Create case in Salesforce”.

Viewing errors

You will be able to see cases that have failed to create or update automatically by visiting the Salesforce app. Go to Sync Errors and click on “Cases” to find any that have failed. The reason will be given under the Description.

Send conversations from Intercom to Salesforce as tasks

Sending conversations automatically makes it easy to keep track of your customers' activity.

You can log conversations you have with leads, notes you’ve left teammates, and One-off messages as Salesforce tasks. This means you’ll have a complete interaction history with each lead or contact.

Note: If a conversation has multiple participants, the activity will only be recorded for the original participant.

Automatically send conversations to Salesforce as tasks

Every time a conversation is started, a task will be created in the Salesforce activities list for the lead or contact. The task is also updated when the conversation is closed.

This can be enabled or disabled from your Salesforce app settings. Learn more in this article.

Manually send conversations and notes to Salesforce as tasks

In the inbox, just hover over a note or message and click on the three dots that appear and select ‘New Salesforce task.’

The conversation will display on a lead/contact’s page as a completed task. You’ll see a snippet of the conversation/note and a link to the conversation in Intercom.

  • New leads are only automatically created in Salesforce when a task is manually created. For auto task creation, the lead needs to already exist in Salesforce.

  • The task in Salesforce is assigned to the teammate assigned to the conversation in Intercom.

  • If a lead's or user’s email in Intercom matches with multiple leads in Salesforce, a new task is created for them all.

  • If you have multiple tasks, the first task that's been changed to 'closed' is marked as completed.

Relate conversations to open opportunities

When a conversation is sent to Salesforce, relevant open opportunities are checked to see if the conversation can be related to them. All conversations associated with an opportunity will be automatically related and listed as an activity within the opportunity.

  • Activities for contacts are only related if they have a role set within the opportunity.

  • If there are multiple open opportunities they’ll be ignored.

Create cases in Salesforce from Intercom conversations

If an Intercom user or lead exists as a contact in Salesforce, you can see their number of open cases (if there are any) in the Contact details:

Click the count to see the cases in more detail (with case ID, status and priority):

Create a new case in Salesforce

To create a new case for a contact in Salesforce, click "New Case", then enter the case details, and click "Create Case":

Important: Any fields that are mandatory in Salesforce must be filled out in Intercom before creating a case.

After creating a case, a note is added to the conversation, with a link to view the case in Salesforce:

Note: A contact must exist in Salesforce before a case can be created, so the option to create a case will not be visible in Intercom for users or leads who aren't a contact in Salesforce.

When you create a new case with the Salesforce app in your inbox, you'll see how ownership is going to be assigned, based on your app configuration:

Known limitations or important to note

Limitation

Details

Default formulas within Cases are not supported

If the cases that we are trying to create has a default formula field in Salesforce we will not be able to create the case

Chat Transcript cannot be mapped and will always map to Case Description

Chat Transcript will be mapped to the Case Description, this mapping cannot be changed or turned off

There is currently no field validation when creating a case.

For example, if the Case field in Salesforce only accepts numbers and an attribute mapping has string values. Case creation will fail in this scenario.

If Case creation fails, user does not receive an error message

Having trouble with the Salesforce app?

If you encounter any problems while using the Salesforce app or want to learn more about how it works, check out this F.A.Q article.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?