How it works

   Zoho CRM integration is used to open a task automatically for every call according to the conditions (Queue, Call status or Outbound Route) set in a trigger.

The task will be populated with information about the call and displayed to the agent in the Zoho CRM environment.

The following are list of things you have to do to make the integration work:

1. Create the Zoho Administrator Account (on zoho.com or zoho.eu), if you don't have one already

2. Create the ClientID and get the Client Secret key

3. Create a temporary Developer Console Code (you will use it when you create the Zoho Account on XCALLY Motion to generate the Token for establishing a certified interaction with Zoho)
   
   

4. Create the Zoho Account on XCALLY Motion and test it

5. Create Zoho Configuration in XCALLY Motion for the account created 

6. Create the Zoho Users with the same e-mail address as the Agent in XCALLY Motion

7. Create a Trigger (Tools → Triggers), set the triggering conditions for this integration and add integrations action

8. Download the XCALLY Motion Phonebar Windows App* and login the Agent on Zoho and on XCALLY Motion (both on the Phonebar and on Omnidesktop interface) and start!

*alternatively, the Agents can use WebRTC or external Phones (of course, they must be logged on XCALLY Motion Omnidesktop)

What to do on Zoho

The following are the configuration steps to do on Zoho to make the integration work:

Open

Create the Administrator account, by signing in on zoho.com or zoho.eu.

You can skip the registration if you already have one.

Go to Zoho Developer Console: here you can create a Self Client for XCALLY Motion. 

Create New Client choosing Self Client as type

Click on Create and take note of Client ID and Client Secret.

To create the Oauth2 token needed by XCALLY Motion API, we need also a temporary code, called Developer Console Code. To obtain it, click on Self Client → Generate Code section

In the field Scope insert the following value:

ZohoCRM.users.all,ZohoCRM.modules.all,ZohoCRM.settings.all,ZohoSearch.securesearch.read

to obtain a valid Developer Console Code.

Choose the validity of the Console Code (from 3 to 10 minutes). 

Take note of the generated Developer Console Code, which will be used, together with ClientId and ClientSecret obtained before, on XCALLY Motion.

• Name: chose the name you want to assign to the Account

• Host: the choice is between zoho.com and zoho.eu

• Zone: insert here your specific region (refer to the table here: https://www.zoho.com/crm/developer/docs/api/refresh.html )

• Client ID (see above)

• Client Secret (see above)

• Developer Console Code (see above. Warning: it will expire if not used within the previously set time window!)

• proxy IP address (the URL of your XCALLY Motion application)

At the end click ADD ZOHO ACCOUNT. 

During the Account creation a Refresh Token will be automatically generated (it will be the Oauth2 token used by XCALLY Motion to authenticate API requests). 

You can see this value editing the Zoho Account (Tab General).

Remember to Test Zoho Account configuration to check if the credentials are accepted by the system:

or if you made some mistakes:

Click on Add Configuration

Now insert the Configuration parameters:

• Name: any name you prefer

• Channel: the channel you want the integration to be active (e.g. Voice)

• Type: select one of the proposed values (e.g. Inbound in Queue or Outbound Calls)

At the end click on Add Zoho Configuration

The Configuration added is immediately active and the default values (Subjects, Descriptions, Fields and Advanced) are configured by the system.

You can add more than one Field.

In the drop-down list you can find the complete list of fields available in your Zoho account: Standard and Custom Ticket fields.

Choose the field from the list (Standard or Custom):

and define the Type:

• String: static string (you must insert it)

• Variable: a System Variable (choose it from the list: e.g. Queue, uniqueid, calleridnum, etc.)

• Custom Variable: one of the dynamic variables (created under Tools > Variables)

• Picklist: choose among the list of the integrated Application Fields. You can only select one of the predefined values available for that field (if any).

In the Configurations ADVANCED tab (available in XCALLY Motion starting from version 2.4.19**) you can set:

• how to Search the Module: as Contact, as Lead or as both of them

• what to do if the Module is not found in the system: nothing or Create the Module as Contact or as Lead

Now you have to add agents (the so called Users) in Zoho, having the same e-mail address as on XCALLY Motion: 

1. Click 

    (the Settings icon) > Setup > Users > + Add New User

2. Select a Standard profile

3. Be sure to use the same email as the agent that use the Zoho integration on XCALLY Motion 

4. confirm the registration

To manage default permissions: 

1. Click Settings > Setup > Users & Control > Security Control > Data Sharing Settings.

2. In the Data Sharing Settings page, click Edit All Default Permissions.

3. In the Edit Default Organization Permissions page, update the Access Privilege for Contacts and Leads modules from Private to Public Read/Write/Delete