---
title: "Configure the email integration for Salesforce"
slug: "configure-the-email-integration-for-salesforce"
updated: 2026-10-26T10:33:18Z
published: 2026-10-26T10:33:18Z
canonical: "help.8x8.com/configure-the-email-integration-for-salesforce"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.8x8.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure the email integration for Salesforce

As a Salesforce administrator, you can enable communication via email channels for agents using 8x8 integration for Salesforce. This allows routing emails to agents, and to have these emails automatically stored as cases in Salesforce when an agent accepts and responds to the emails. The configuration involves:

- [Enabling email integration in 8x8 Configuration Manager](/documentation/docs/configure-the-email-integration-for-salesforce#enable-email-integration-in-configuration-manager)
- [Configuring email integration in Salesforce](/documentation/docs/configure-the-email-integration-for-salesforce#configure-the-email-integration-in-salesforce)
- [Selecting the Salesforce objects to search in Agent Workspace as an agent](/documentation/docs/configure-the-email-integration-for-salesforce#select-the-salesforce-objects-in-agent-workspace)

### Features

The support for email communication allows agents to:

- Accept emails with contextual screen pops of customer records
- Review the list of matching customer records before selecting the right one
- Stay in busy status while processing the email to avoid any distractions
- Create a case automatically for the accepted email and linked to the customer record
- Reply, forward, close, and transfer emails quickly and efficiently
- Send new and follow up emails
- Keep track of the email thread through the case history

### Limitations

- The email channel support is currently limited to 8x8 integration with Salesforce only.
- Ability to pull email is not yet available.
- Individual customer queued email is not supported.
- This functionality is not copied over to Local CRM yet.
- The email channel communication is supported on the updated integration only.

### Requirements

- Access to the updated integration. Contact 8x8 Support to request.
- Access to 8x8 Agent Workspace

## Enable email integration in Configuration Manager

This step requires you to have administrator privileges to access 8x8 Configuration Manager. In this step, you need to enable full email integration in Agent Workspace, which is controlled by a setting in the 8x8 Configuration Manager.

1. Log into Configuration Manager.
2. From the menu, go to **Home > Profile**.
3. Select **Enable full email integration in Agent Workspace**.
4. Click **Save**.

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)

## Configure the email integration in Salesforce

As a next step, you must configure the email integration in Salesforce which requires you to have necessary admin privileges in **Salesforce**. This process requires you to perform the following tasks:

**Enable email message**

To enable email messages in Salesforce, you need to switch to Classic Mode.

1. Log in into your Salesforce account.
2. Click on your profile image. From the options, select **Switch to Classic Mode**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_1.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)** The Salesforce Classic mode launches.
3. From the header menu, on the top right corner of the screen, click **Setup**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_2.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
4. In the Quick Find / Search box, search for the keyword <Enhanced> and from the results shown, click **Enhanced Email**.
5. Under **Enhanced Email**, click **Enable** to enable Email Message. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_3.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
6. Refresh the page and search for <Email Message> in the Quick Find / Search box. You can see **Email Message** listed under **Build > Customize > Email.** ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_4.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)

**Enable HTML Body**

The next step is to enable the HTML body in emails.

1. In the **Quick Find / Search** box, search for <Email-to-Case>, and click Email-to-Case from the results. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_5.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
2. In the following page for Introducing emails to cases, click **Continue**.
3. In the **Email-to-Case Settings** page, click **Edit** and select **Enable HTML Email** checkbox. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_6.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
4. Click Save.

**Create Custom fields in the Case object**

In the next step, create the following custom fields to support the email integration. You must create these custom fields to allow 8x8 to add emails to cases. This ensures that follow up emails are attached to a case as a thread rather than each email creating a new case.

| Field Name | API Name | Data Type |
| --- | --- | --- |
| MainNumber | MainNumber__c | Text (External ID) |
| Lead | Lead__c | Lookup(Lead) |

### Create MainNumber custom field in the Case object

1. In the **Quick Find / Search** box, search <case> and select **Fields**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_7.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
2. In the page list of existing case fields, under **Case Custom Fields & Relationships**, click **New**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_8.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
3. To specify the type of information that the custom field contains, select **Text** as the data type.
4. Click **Next**.
5. In the field details, enter the following values:
  1. Field Label: MainNumber
  2. Field Name: MainNumber
  3. Field Length:255
6. Also select the checkboxes for:
  1. Required: Always require a value in this field in order to save a record
  2. Unique: Do not allow duplicate values

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_9.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)
7. Click **Next** to go to the **Field Level Security** page. Click **Next**.
8. In this last step, select the page layouts that should include this field. The field will be added as the last field in the first 2-column section of these page layouts.
9. Click **Save & New** to save this new custom field along with the page layouts that it should appear on. You will now move on to creating another custom field. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_10.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**

### Create Lead custom field in the Case object

1. To specify the type of information that the custom field contains, select **Lookup Relationship** as the DataType and click **Next**.
2. From the **Relate To**dropdown list, select Lead as the other object to which this object is related. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_11.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
3. Click **Next**.
4. In the field details, enter the following values:
  1. Field Label: Lead
  2. Field Name: Lead
  3. **Child Relationship Name: Cases ![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_12.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
5. Click **Next**.
6. In the Establish field-level security for reference field page and Add reference field to Page Layouts page, save with default values. The field will be added as the last field in the first 2-column section of these page layouts.
7. Click Save to save this second custom field.
8. To view the custom fields you created, go to Cases > Fields from the Quick Search box.
9. Under Case Custom Fields and Relationships, locate the new fields.

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_13.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)

**Create Custom fields in the Email Message object**

As the final step in configuration, create the following custom fields in the Email Message object:

| Field Name | API Name | Data Type |
| --- | --- | --- |
| MainNumber | MainNumber__c | Text (Required) |
| ChildNumber | ChildNumber__c | Text |

### Create MainNumber custom field in Email Message

1. In the **Quick Find / Search** box, search <email message> and select **Fields**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_14.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
2. Under **Email Message Custom Fields & Relationships**, click **New**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_15.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
3. To specify the type of information that the custom field contains, select **Text** as the data type.
4. Click **Next**.
5. In the field details, enter the following values:
  1. Field Label: MainNumber
  2. Field Name: MainNumber
  3. Field Length:255
6. Also select the checkbox for:

Required: Always require a value in this field in order to save a record

> [!NOTE]
> Note:
> 
> Do not select the checkbox for **Unique - Do not allow duplicate values**

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_16.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)

1. Click **Next** to go to the **Field Level Security** page. Click **Next**.
2. Click **Save & New** to save this new custom field and create another custom field.Keep the default selection ofthe page layouts that should include this field. The field will be added as the last field in the first 2-column section of these page layouts.

### Create ChildNumber custom field in Email Message

1. Under **Email Message Custom Fields & Relationships**, click **New**. **![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_15.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**
2. To specify the type of information that the custom field contains, select **Text** as the data type.
3. Click **Next**.
4. In the field details, enter the following values:
  1. Field Label: ChildNumber
  2. Field Name: ChildNumber
  3. Field Length:255
5. Also, do not select the checkboxes for: **Required - Always require a value in this field in order to save a record Unique - Do not allow duplicate values**
6. Click **Next** to go to the **Field Level Security** page. Click **Next**.
7. Click Save to add this custom field to page layouts. Keep the default selection ofthe page layouts that should include this field. The field will be added as the last field in the first 2-column section of these page layouts.
8. To view the custom fields you created, go to Email Message > Fields from the Quick Search box.
9. Under the Email Message Custom Fields and Relationships, locate the new fields.

![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1_17.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)

With this step complete, you have successfully configured the email communication in 8x8 integration for **Salesforce**.

## Select the Salesforce objects in Agent Workspace

> [!NOTE]
> Note:
> 
> The following procedure must be performed by agents.

Upon receiving an interaction, the 8x8 integration searches for matching customer records and presents them to agents helping them associate the interaction with the right customer. The search can be broadened to all the supported Salesforce objects or narrowed down to the specific objects desired. To select the **Salesforce** objects to search for in email integration, log into 8x8 Agent Workspace and select the Salesforce objects to search.

1. Log into **Salesforce** and launch the 8x8 integration app.
2. Once the app launches 8x8 Agent Workspace, choose to **Work offline.**
3. Go to **My Profile** from the menu. It launches in a new window.
4. In the **Integrations** tab, under **Search Types**, select:
  - Account
  - Lead
  - Contact
  - Case

1. Click **Save**.

> [!NOTE]
> Note:
> 
> By default, Account and Contact objects are selected.

**![](https://cdn.us.document360.io/e3a59e39-abd3-4423-964c-0a4008dc5673/Images/Documentation/Configure%20the%20email%20integration_1.png?sv=2026-02-06&spr=https&st=2026-11-03T21%3A52%3A31Z&se=2026-11-03T22%3A52%3A31Z&sr=c&sp=r&sig=kW3eqJ6GkiTdSIGQea1QB5qE1Kl1yox354kySWO6NRM%3D)**