Integrations troubleshooting

Try the following troubleshooting procedures to resolve the most common integration issues:

If Search does not return any results, it may be because you do not have access to several entities in Salesforce:

Entity: Contact

Fields: Phone, MobilePhone, HomePhone, AssistantPhone, OtherPhone, Fax

Entity: Account

Fields: Phone, Fax

Entity: Lead

Fields: Phone, MobilePhone, Fax

Note: If you are an agent, contact your administrator.

A screen pop failure is commonly attributed to browser caching issues, blocked pop-ups, and blocked websites.

Error: External username and password is empty or incorrect. The possible causes are:

  • The external password value in the 8x8 Agent Console profile contains special characters.
    1. Reset the NetSuite account password to exclude special characters.
    2. Enter the reset password as the external password in the 8x8 Agent Console profile.
  • The NetSuite user role is denied access to web services.
    1. Contact your NetSuite administrator to grant web services access to the role.
    2. Check the Appendix for details.
  • Check your agent status. Your status must be Available to receive calls.
  • Check phone number settings, and make sure you have set up a valid phone number or SIP URI.
  • Check if you are assigned to the correct queues.

Check if the external CRM credentials in the agent profile are valid.

Error: The screen pop searches the Account, Contact, and Lead objects before returning the records that have matched the phone number of inbound Caller ID. If an agent does not have the permission to access any of the objects, the search fails.

Possible fix: Either assign agents who have the permission to access Account, Contact, and Lead objects, or send your request to 8x8 Support to remove the search feature for objects that are not needed by that agent.

An agent receives the following error message when logging in to 8x8 Agent Console:

Error: An agent is logged in to 8x8 Contact Center multiple times, likely via mobile phone, console, or Classic modes.

Possible fix: Log out and close all browser windows to start a new login session in Salesforce to launch 8x8 Contact Center.

Error: The access is missing to Task type field.

Possible fix: You must set the field-level security and allow permission to Task type field.

To set the field-level security:

  1. Log in to Salesforce.
  2. Select App Setup from the left menu.
  3. Search and find Task Fields from the Quick Find/Search box. You can see all the task fields on the right side of the window.
  4. In the Task Fields page, click Type.
  5. Click Set Field-Level Security.
  6. Click Visible to allow users to use the field for auto call log.
  7. Check the appropriate profile, and click Save. The Type field is accessible the next time the agent logs in.

Error: 8x8 Configuration Manager does not have agent enabled for Salesforce.

Possible fix: The tenant administrator has to log in to 8x8 Configuration Manager and complete the integration configuration:

  1. Log in to 8x8 Configuration Manager.
  2. Go to Integration > Screen Pop.
  3. Select Salesforce under Target Attributes.
  4. Select the Select and assign all agents check box.
    For details, see our content on defining screen pop settings in the 8x8 Configuration Manager guide.

Error: The agent profile is disabled.

Possible fix: Verify that the agent profile is enabled in the 8x8 Configuration Manager

Error: The employee's email address used for Salesforce login does not match the agent's email address in 8x8 Configuration Manager.

Possible fix: Verify that the employee's email address used to log in to Salesforce matches with the 8x8 Contact Center agent profile email address. The email address is case-sensitive.

Error: The message indicates that the Salesforce Single Sign-On token is expired, and the 8x8 Contact Center is functioning without Salesforce integration. Therefore, the screen pop is not prompted.

Possible fix: Log out of both 8x8 Contact Center and Salesforce, and log back in to both accounts to synchronize the SSO token.

Error: The supplementary package is missing, causing the error in auto log after an interaction.

Possible fix: You need to install SF_Contactual_Setup application. For details, see our content on installing the supplementary package.

Known issues

Error: The agent converts a lead to an account during a call before saving the call log.

Solution: We do not currently have a solution. An enhancement will be implemented in the future release to address this issue.