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.

Set up email in external CRM: 8x8 integration for Microsoft Dynamics

Prev Next

Note:

Email in external CRM is only supported on the latest integration package (version 0.3.7).

8x8 Work for Microsoft Dynamics supports email routing. For agents to be able to use this feature, you must first configure it.

Important:

Prior to configuring email in external CRM, ensure that you have  added the users, configured queues, and set up email channels in Configuration Manager.

To set up email in external CRM:

Step 1: Create custom case fields

  1. Log in to your Microsoft Dynamics account.

  2. Go to Settings  > Advanced Settings > Settings > Customizations > Customize the System. The Default Solution window opens.

  3. From the side navigation menu, click the   arrow icon next to Entities to expand the list.

  4. Scroll down to Case and click the   arrow icon to expand the list.

  5. Select Fields.

  6. Click New from the top left corner of the window. A new window opens.

  7. In the Display Name field, type the name MainNumber .

  8. From the Field Requirement drop-down list, select Business Required

  9. From the Searchable drop-down list, select Yes.

  10. From the Data Type drop-down list, select Single Line of Text.

  11. In the Maximum Lenght field, type 255.

    Note:

    Keep the default settings for the other fields.

  12. Click Save and Close from the top left corner of the window.

  13. On the Default Solution window, under Entities > Case > Fields, click New from the top left corner. A new window opens.

  14. In the Display Name field, type the name Lead.

  15. From the Field Requirement drop-down list, select Optional.

  16. From the Data Type drop-down list, select Lookup.

  17. From the Target Record Type drop-down list, select Lead.

Note:

Keep the default settings for the other fields.

  1. Click Save and Close from the top left corner of the window.

Step 2: Create custom email fields

  1. On the Default Solution window, from the side navigation menu, click the   arrow icon next to Entities to expand the list.

  2. Scroll down to Email and click the   arrow icon to expand the list.

  3. Select Fields.

  4. Click New from the top left corner of the window. A new window opens.

  5. In the Display Name field, type the name MainNumber.

  6. From the Field Requirement drop-down list, select Business Required.

  7. From the Searchable drop-down list, select Yes.

  8. From the Data Type drop-down list, select Single Line of Text.

  9. In the Maximum Lenght field, type 255.

    Note:

    Keep the default settings for the other fields.

  10. Click Save and Close from the top left corner of the window.

  11. On the Default Solution window, under Entities > Email > Fields, click New from the top left corner. A new window opens.

  12. In the Display Name field, type the name ChildNumber.

  13. From the Field Requirement drop-down list, select Optional.

  14. From the Searchable drop-down list, select Yes.

  15. From the Data Type drop-down list, select Single Line of Text.

  16. In the Maximum Lenght field, type 255.

    Note:

    Keep the default settings for the other fields.

  17. Click Save and Close from the top left corner of the window.

Step 3: Increase character length for case fields description

  1. On the Default Solution window, under Entities, scroll up to Case and click the   arrow icon to expand the list.

  2. Select Fields.

  3. From the Name column, select the row titled description.

  4. Click Edit from the top of the window.

  5. In the Maximum Lenght field, type 32000.

    Note:

    Keep the default settings for the other fields.

  6. Click Save and Close from the top left corner of the window.

Step 4: Configure and publish the Case form

  1. On the Default Solution window, under Entities > Case, select Forms.

  2. From the Name column, select the row titled Case.

  3. In the window that opens, go to the Field Explorer section, and from the Filter drop-down list, select Custom Fields.

  4. Drag and drop Lead from the Field Explorer section to the Case Details section.

  5. Drag and drop MainNumber from the Field Explorer section to the Case Details section.

  6. Click Save.

  7. Click Publish.

Step 5: Configure and publish the Case Quick Create form

  1. On the Default Solution window, under Entities > Case, select Forms.

  2. From the Name column, select the row titled Case Quick Create .

  3. In the window that opens, go to the Field Explorer section, and from the Filter drop-down list, select Custom Fields.

  4. Drag and drop Lead from the Field Explorer section to the Case Details section.

  5. Drag and drop MainNumber from the Field Explorer section to the Case Details section.

  6. Click Save.

  7. Click Publish.

Step 6: Configure and publish the Email form

  1. On the Default Solution window, under Entities > Email, select Forms.

  2. From the Name column, select the row titled Email.

  3. In the window that opens, go to the Field Explorer section, and from the Filter drop-down list, select Custom Fields.

  4. Drag and drop MainNumber from the Field Explorer section to the Case Details section.

  5. Drag and drop ChildNumber from the Field Explorer section to the Case Details section.

  6. Click Save.

  7. Click Publish.

Step 7: Verify the settings

  1. Go to the home page of your Microsoft Dynamics account.

  2. Open the desired app.

  3. Click   from the top right side of the page.

  4. Select Case from the drop-down list.

  5. In the Quick Create: Case panel that displays, verify that the MainNumber field is available.

  6. Open a Case in Microsoft Dynamics.

  7. Verify that MainNumber and Lead are available in the details section.

  8. Select Activities from the side navigation menu in Microsoft Dynamics.

  9. Click Email.

  10. Verify that ChildNumber and MainNumber are available in the new email window.

Step 8: Configure ghost contact first and last name

Note:

This step ensures that a case  is assigned to a ghost contact if an agent doesn't create and save the new contact  before ending an interaction with zero matches.

  1. Click from the top right side of the  home page of your Microsoft Dynamics account.

  2. Select Contact. The Quick Create: Contact panel displays.

  3. In the First Name field, type ghost_8x8.

  4. In the Last Name field, type contact_8x8.

  5. Click Save and Close.

Step 9: Enable the email integration from 8x8 Configuration Manager

  1. Log in to your 8x8 Configuration Manager account.

  2. Go to Home > Profile.

  3. Select the check box for Enable full email integration in Agent Workspace (External CRM only).

  4. Click Save.