Configure the email integration for Salesforce

As a Salesforce administrator, you can enable communication via email channels for agents using 8x8 integration for Salesforce. The configuration involves:

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.

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:

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.

    The Salesforce Classic mode launches.

  3. From the header menu, on the top right corner of the screen, click Setup.

  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.

  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.

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.

  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.

  4. Click Save.

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(255) (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.

  2. In the page list of existing case fields, under Case Custom Fields & Relationships, click New.

  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

  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.

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 Todropdown list, select Lead as the other object to which this object is related.

  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

  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.

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(255) (Required)

ChildNumber

ChildNumber__c

Text(255)

Create MainNumber custom field in Email Message

  1. In the Quick Find / Search box, search <email message> and select Fields.

  2. Under Email Message Custom Fields & Relationships, click New.

  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: Do not select the checkbox for Unique - Do not allow duplicate values

  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.

  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.

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

Select the Salesforce objects in Agent Workspace

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 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: By default, Account and Contact objects are selected.