Unity CRM Integration – Sugar CRM

Unity CRM Integration – Sugar CRM

Introduction

This functionality relies on a CRM Integration license being assigned to the user, as shown below.

Note: This license is required in addition to the base license for Unity Desktop, Agent, or Supervisor. All versions of Sugar CRM are supported.

Once this license is assigned and Unity is restarted, the CRM panel will become available in Settings, as shown below.

To configure Unity to integrate with Sugar CRM, simply select the CRM platform from the dropdown list and complete the required fields, as outlined in sections below.

This image represent Unity’s Service and Settings menu with CRM highlighted. - Image opens in full resolution in a new tab

Configuring the Sugar CRM Portal

In order for Unity to integrate with Sugar CRM, an API Platform must be created in the Sugar CRM instance. Unity uses this to consume the Sugar API so it must be done before configuring Unity clients, but it only needs to be done once per Sugar CRM instance (which will then apply to all users).

When logged in as an administrator:

  1. Click Admin from the context menu. If you don’t see this menu option, then you are not logged in as an administrator.
  2. This image represents Sugar’s interface with the profile menu expanded and admin highlighted. - Image opens in full resolution in a new tab
  3. Under Developer Tools, click Configure API Platforms
  4. This image represents Sugar’s developers’ tools with Configure API Platforms highlighted. - Image opens in full resolution in a new tab
  5. Add an API platform called “unity”

    Note: This is all lower case.

  6. This image represents Sugar’s API Platform with Unity highlighted. - Image opens in full resolution in a new tab
  7. Click Add to add the API to the list, then click Save to update.

Configuring Sugar CRM Integration

  1. Go to Unity Setting.
  2. Click the Settings tab.
  3. Then choose CRM.
  4. Select Sugar from the dropdown list of CRM platforms.
  5. This image represent Unity’s Service and Settings menu with CRM highlighted as well as Sugar CRM within the CRM Platform Field. - Image opens in full resolution in a new tab
  6. Enter your login ID, password and URL. The URL will be the same that is used to log into the Sugar CRM portal, it must start with https://
  7. Click Test. If the details are correct, then you will see the below pop up:
  8. This image represents Unity’s CRM Confirmation success. - Image opens in full resolution in a new tab
  9. If the details are incorrect then you will see this pop up and will need to enter the correct details to integrate Sugar CRM:
  10. This image represents Unity’s ability to not connect to the CRM server. - Image opens in full resolution in a new tab

Once the Test has been successfully completed you can choose whether to include contacts, leads and/or accounts from Sugar by selecting the boxes shown below:

This image represents Unity’s CRM settings window with the following highlighted: Include Contacts, Include Leads, Include Accounts, and Automatically add Call Log entry. - Image opens in full resolution in a new tab

Unity can also include the record type when showing a contact from Sugar, making is easy to identify if a call is from a Contact or Lead.

If the account doesn’t have access to search contacts, leads or accounts (depending on the license type of the user in Sugar CRM) then Unity will automatically uncheck the related setting to ensure it doesn’t continue to search for that entity type.

Unity allows the user to add a call log entry into Sugar for any call, assuming the remote party was found in Sugar. This feature is outlined further below, but you can also configure Unity to automatically add a call log entry if one hasn’t been added manually. This includes both inbound and outbound calls and even calls that were unanswered.

You can also configure Unity to automatically pop the CRM contact when the phone is answered, as shown below.

This image represents Unity’s CRM settings window with Automatic Contact Pop highlighted. - Image opens in full resolution in a new tab

You will be able to test the integration by performing a search for a contact within Unity, you should see Sugar records appear in the list as well as from all other directories. If in doubt you may want to activate the “Show record type when searching” setting in order to distinguish between Sugar records in the search results.

This image represents Unity’s contact window with the contacts information expanded. Show CRM Contact is highlighted. - Image opens in full resolution in a new tab

Unity CRM Functionality

Contact Pop

Unity will use Sugar to identify inbound and outbound calls and conversations, including queued call center calls.

At any time, you can search for CRM contacts from within Unity and perform click to dial to make an outbound call to the contact, or display the contact in the CRM platform (this is referred to as “popping” a contact) as shown below.

This image represents Unity’s contact window with the contacts information expanded. Show CRM Contact is highlighted. - Image opens in full resolution in a new tab

You can also right-click a call to pop the record in Sugar using the default browser, as shown below. This assumes the contact was found in the CRM platform rather than another directory (for example an Outlook contacts folder).

This image represents Unity’s contact window with the contacts information expanded. Show CRM Contact is highlighted. - Image opens in full resolution in a new tab

You can also click on the call details “toast” notification popup to pop the contact, as below. Again, this assumes the contact was found in the CRM platform.

This image represents contact window within the Unity application. - Image opens in full resolution in a new tab

This feature depends on the appropriate Call Notification setting being activated, as shown below.

This image represents Unity’s settings window with Call Notification Highlighted. - Image opens in full resolution in a new tab

Unity can also be configured to automatically pop the CRM contact when the call is answered, which depends on the Automatic Contact Pop tab settings as shown below.

This image represents Unity’s settings window with CRM Highlighted. - Image opens in full resolution in a new tab

Contact Search

When you perform a contact search, Unity will check all directories such as the group/enterprise phone list, personal directory and Outlook etc, but it will also search Sugar CRM and return the results. You can search on contact name or company name, simply double click an entry to call that number.

Please note that you will need to type in a minimum of three letters to search for a CRM contact.

This image represents Unity’s contact window with the contact name highlighted in three distinctive areas. - Image opens in full resolution in a new tab

You can also right-click entries to send an email using the default mail program (if there is an email address set for that Contact or Lead in Sugar).

This image represents Unity’s contact window with the contacts information expanded. Send email is highlighted. - Image opens in full resolution in a new tab

Call Log Entry

When integrated with Sugar, Unity can add call log entries on behalf of the user, as outlined below.

Manual Call Log Entry

Right-click on a call and select to add a call log entry, as shown below.

This image represents Unity’s contact window with the contacts information expanded. Add CRM Call Log Entry is highlighted. - Image opens in full resolution in a new tab

Unity will enter basic details of the call depending on if the call is inbound or outbound.

Remember this call log will be stored in Sugar so an outbound call in Unity is an inbound call in Sugar, because we have called the contact.

You can also add further notes manually, then click OK to save the call log entry.

The call note will be saved against that contact in Sugar, please note that you can specify whether to close the status of the call log task/activity in Sugar or keep it open by ticking the box.

This image represents Unity’s settings window with Close call log entry immediately Highlighted. - Image opens in full resolution in a new tab
This image represents Unity’s Add Activity log window with Close Log Entry immediately highlighted. - Image opens in full resolution in a new tab

If you click Show CRM Contact or Cancel the call log will not be saved.

You will now see this call log entry in Sugar, as shown below.

This image represents Unity’s Calls. - Image opens in full resolution in a new tab

Automatic Call Log Entry

Unity can be configured to automatically add a call log entry for any calls where a call log hasn’t been manually created using the steps above. This feature is activated as shown below.

This image represents Unity’s Settings window with the Configuration panel showing. - Image opens in full resolution in a new tab

Unity will automatically add call log entries when the call is released (the same time it is removed from the Active Call List in Unity). Only basic information on the call is presented, based on the direction of the call and the Unity user that made or received the call. Sugar will timestamp the call internally.

This shows an unanswered call from the Sugar contact to the Unity user.

This image represents Unity’s Tasks window with Call From Jenna highlighted. - Image opens in full resolution in a new tab

This shows an answered call from the Unity client to the Sugar contact.

This image represents Unity’s Call From Jenna window. - Image opens in full resolution in a new tab