Zoho Integration – Contacto

You can integrate Zoho Contacts with Contacto in six steps:

Integration Details
Add and Configure Lookups
Select Lookup Keys
Configure UI & Setup Permissions
Link Contacto Attributes to Lookup Response Keys
- This step is applicable only when you select a sync type in Step 1
Add and Configure Actions

To get started, from the Contacto Admin Profile, click Settings → Integrations → All, and under API Based Integrations click New API Integration

1. Integration Details

Integration Name - Provide a descriptive name for the integration like “Zoho Contacts”. Agents will see this name on the desktop.
Select Icon - Select a predefined icon that matches the platform you’re integrating or click “+” to import one that best represents your integration.
Authentication Details:
- Authentication Type - Zoho uses OAuth 2.0, so select OAuth 2.0 from the drop-down menu.
- Connected App - Select “Zoho desk” from the dropdown
Contact and Ticket sync:
Select “Import and synchronize contacts with this integration” to integrate with Zoho Contacts.

2. Add and Configure Lookups

System-defined lookups - are used by Contacto to show relevant information from your Zoho CRM in different sections of the Agent Desktop.
- "Get Contact by ID" lookup
  - “Get Contact by ID” system-defined lookup fetches the Contact details from Zoho using Contact ID. The lookup name can be modified.
  - The ’Request URL’ field is configured with the Zoho Get Contact API to fetch contact details using Contact ID.
  URL: https://desk.zoho.com/api/v1/contacts/{{system.conversation.associated-contact-id}}
User-defined lookups
- "Get Contact" lookup
  - “Get Contact” User-defined lookup is configured to get contact details based on a customer’s phone number.
  - The ’Request URL’ is configured with the Zoho Search Contacts API to fetch contact details by phone number.
    
    URL: https://desk.zoho.com/api/v1/contacts/search?_all={{system.customer.phone}}
Add new lookup
- Click “Add New API” to add additional Helper Lookups. An API, request parameters, and a friendly name can be configured for each lookup.

3. Select Lookup keys

Select Primary Object for Integration
Select the response key, from the responses of User-defined Lookups, as the primary object for the integration. All response keys nested under the selected key will be available to be shown & modified by users on the Agent Desktop.

The “Get-contact” lookup is selected as the primary object so that all the response keys from the “Get Contact” lookup will be available to be shown on the Agent Desktop.
Select Keys to Display on Agent Desktop

The below keys are selected to be shown on the Agent Desktop and their data-type is set as “String” (as shown in the reference screenshot).
- firstName
- lastName
- email
- secondaryEmail
- mobile
- phone
- street
- state
- city
- country
- ownerId
- zip
- type
- id
- createdTime
Click “Save and Proceed” to save any changes and proceed to the next step.

4. Configure UI and set up permissions

Configure the label, type, display format and permissions for each key that users interact with on the Agent Desktop. Keys selected in the previous step can configured in this step..

The keys (fields) will be shown in the order defined in this step, and they can be reordered using the drag icon to the left of each key.

Configure the UI labels, UI field type, display format, and permissions as shown in the screenshot.
Permissions

Configure the label, type, display format, and permissions for each key that users interact with on the Agent Desktop. Keys selected in the previous step can be configured in this step.

The keys (fields) will be shown in the order defined in this step, and they can be reordered using the drag icon to the left of each key.

Configure the UI labels, UI field type, display format and permissions as shown in the screenshot.

Click “Save and Proceed” to save any changes and proceed to the next step.

5. Link Contacto Attributes to Lookup Response Keys

Associate your lookup responses with Contacto attributes to show contextual information from your Zoho CRM in different sections of the Agent Desktop. The response keys from the “Get Contact” lookup are shown linked to Contacto’s Contact attributes ( as shown in the screenshot).

Modify the associations to the relevant response keys from your Zoho CRM instance. Click “Save and Proceed” to save any changes and proceed to the next step.

6. Add and Configure Actions

Actions allow users to modify data from the Agent Desktop. An API, request parameters, and a friendly name are required to configure an Action. There are two types of actions: Integration-level actions and Object-level actions

Integration-level actions
These actions work across all the objects returned in an integration, like searching for a Contact from a list of Contacts.
- Create Contact
  - Use Create Contact Zoho Desk API (renamed “Create Contact”).
  - Provide the body in the JSON format, as shown in the screenshot - parameter/key the API expects and the source from where the value should be derived. After filling the details, click on the “Test” button.
  - Then, in the Response Fields, select the primary object as “create-contact” and ID as “create-contact.id”
- Search Contact
  - Use Create Contact Zoho Desk API (renamed “Search Contact”).
  - As shown in the screenshot, provide the parameters in Key-Value format. After that, press the "Test" button.
  - Then, in the Response Fields, select the primary object as “search-contact.data” and ID as “search-contact.data.id”
Object-level actions
System-defined Lookups are used by Contacto to show relevant information from your Zoho CRM in different sections of the Agent Desktop.
- Edit Contact
  - Use Update a Contact Zoho Desk API (renamed as “Edit Contact”)
  - Provide the body in the JSON format as shown in the screenshot - parameter/key the API expects and the source from where the value should be derived. Next, click on “Text”
  - Then, in the Response Fields, select the primary object as “edit-contact” and ID as “edit-contact.id”