Looking to automate Zoho CRM ↔ WhatsApp?

You have several options, listed from most-recommended to most-flexible:

Workflow Builder (recommended — included in your TimelinesAI plan, no separate subscription, more generous credit allowance than standalone Zapier). See Zoho CRM Integration in Workflow Builder.
Zoho CRM's native workflow engine (if you prefer to drive automations from Zoho CRM). See Zoho Workflows: Send a WhatsApp Message.

Not sure which to pick? See Which Automation Tool to Use: Workflow Builder vs. Make, Zapier, and N8N.

With TimelinesAI's Zoho CRM integration, you can:

Auto-create a record and auto-assign it in Zoho CRM when a new WhatsApp chat appears.
Sync WhatsApp messages as notes to a Zoho record.
Start, read and continue WhatsApp chats via the Live WhatsApp Chat View on the lead/contact details page in Zoho.

This guide will walk you through the steps to use all the features of the TimelinesAI and Zoho CRM integration.

✅ Prerequisites

✅ Connecting TimelinesAI to Zoho

✅ How the Integration Works

✅ How Live WhatsApp Chat Extension Works

✅ How WhatsApp To Zoho Sync Works

Let's get started 🚀

Prerequisites

To access TimelinesAI's Zoho integration features, the following is required:

An active TimelinesAI workspace.
An established connection between your Zoho Organization and TimelinesAI workspace — required for any integration feature.
An established connection between Personal (individual) Zoho account(s) and the TimelinesAI workspace — required for Live WhatsApp Chat.
At least one WhatsApp number connected to the TimelinesAI workspace.

Connecting TimelinesAI to Zoho

To begin with the TimelinesAI and Zoho CRM integration, you must establish a connection between Zoho and TimelinesAI. The integration has two kinds of connections:

The Organization (Master) Connection — required for any Zoho Integration feature.
The Personal (Individual) Connection — required only for the Live WhatsApp Chat feature.

To connect:

Log in to TimelinesAI as a workspace owner or administrator and open https://app.timelines.ai/integrations/zoho_crm/.
Click Connect Zoho Organization (or Connect My Zoho, depending on connection type).
Follow the on-screen authorization process.

Learn more about managing connections in this article.

How the Integration Works

Once the Zoho Organization and Individual Zoho accounts are connected, the following features become available. You can use either one or both — it's entirely up to you:

WhatsApp To Zoho Synchronization: syncs WhatsApp contacts and messages with your selected Zoho CRM module, matching records by phone number and creating new records when no match is found.
Live WhatsApp Chat Extension: adds a button or a widget on the Zoho record details page and opens the WhatsApp Chat View, automatically matching chats by the record's phone numbers. If no chats are found, a new conversation can be started.

How Live WhatsApp Chat Extension Works

The TimelinesAI Live WhatsApp Chat View integration lets you manage WhatsApp chats directly from the Lead/Contact details page in Zoho. On Live WhatsApp chat or Open WhatsApp Chat/s button clicks, the system looks for the lead's phone number(s) and finds the WhatsApp chats that match those numbers in TimelinesAI.

The chats are shown directly inside the view. You can read WhatsApp messages within Zoho CRM. You can also reply to messages, including using message templates, adding attachments, and sending emojis. If no matching chats are found, you can start a new chat.

All messages are sent and received in real-time, so the conversation stays up-to-date and you never have to leave Zoho CRM to manage the chat.

Live WhatsApp Chat View requires the TimelinesAI Extension to be installed within Zoho CRM. Learn more about WhatsApp Live Chat in this article.

How WhatsApp To Zoho Sync Works

Note: WhatsApp Group Chats are not supported.

WhatsApp To Zoho Synchronization:

Auto-creates a chat as a new Zoho record (e.g., a Lead) if no matching record is found by phone number.
Auto-assigns newly created records to a matching Zoho CRM user.
Logs WhatsApp messages as notes on the record details page in Zoho.
Takes converted records into account before auto-creating new records and logging WhatsApp messages.

To activate Sync, you must configure it first:

Open https://app.timelines.ai/integrations/zoho_crm/ as the TimelinesAI user who connected the Zoho organization to TimelinesAI.
Click Configure and Activate.
Select your desired sync settings.
Click Activate Integration.

Auto-Creating a Chat as a new Zoho record

Within the Sync settings you select the desired:

Sync destination.
Field to sync the contact's WhatsApp number.
Fields to sync the contact's name, chat link and lead source.
Sync destination (for converted records).
Field to sync the contact's WhatsApp number (for converted records).

Zoho CRM Custom Fields

If you have created custom fields on Zoho, then you can use them to configure your Integration Settings on TimelinesAI.

Here are some important details to be aware of:

Make sure to use single-value fields (such as Phone, Mobile, text, email, integer) and avoid multi-value fields (such as Multi-select Picklist, Multi-select Lookup, Multi-user Lookup, Image Upload) — those are not supported.
In order to enable the selection of new custom fields, fully disconnect and reconnect the integration. Disabling and editing the integration is not enough.

Record auto-creation operates based on the selected settings.

When a new WhatsApp message is received, the system retrieves the contact's phone number and checks for an existing record with that number in the Zoho CRM modules defined in the Sync Destination and (optionally) Sync Destination (for converted records) settings. The system searches for matching records based on the field selected as Field to sync the contact's WhatsApp number in the sync settings.

> Example: Sync destination is set to Leads, converted records destination is set to Contacts, the field to sync the WhatsApp number is Mobile and the field to sync the WhatsApp number for converted records is Office. The system will first search for matching mobile phone numbers in the Leads module, followed by office phone numbers in the Contacts module.

If a match is found in either module, the message is logged as a note under the existing record.
If no match is found, a new record is automatically created in the module defined as Sync Destination. The contact's name, phone number, chat link and lead source values are auto-added to the selected fields and the message is then logged as a note on the newly created record.

Phone-number formatting tip: TimelinesAI matches Zoho records by the WhatsApp number in international (E.164) format — e.g. +447700900123. Records that store the number without a country code (e.g. 07700 900123) won't match and will result in a new record being created. If you have legacy records, normalize the phone field to include the country code so existing contacts get matched instead of duplicated.

Auto-Assigning newly created records

When a new record is auto-created, the system matches the TimelinesAI chat owner (responsible) with Zoho Organization users by email address. If the TimelinesAI chat doesn't have an owner, the system matches the owner of the WhatsApp number in TimelinesAI that the chat comes from.

If a match is found, the matching user is assigned as the owner of the newly created record.
If no match is found, the Zoho CRM user who established the Organization connection with TimelinesAI is assigned as the owner.

> Suppose two WhatsApp numbers are connected in TimelinesAI: +XXX, connected by James ([email protected]), and +YYY, connected by Linda ([email protected]). When a new message is received on James's number (+XXX), the system checks whether the chat is already assigned to a user in TimelinesAI. If the chat is unassigned, the system uses the email address of the WhatsApp number's owner — [email protected] — to check for a matching user in your Zoho organization. If [email protected] exists in Zoho, the new record is auto-assigned to them.

Logging WhatsApp messages as notes

TimelinesAI synchronizes WhatsApp messages as notes on the matching record:

All WhatsApp chat messages from a given date are grouped into a single Note. If the conversation continues on another date, the system creates a new Note and appends messages from that date to that note.
The Note's title is set as WhatsApp Chat with [Contact Name] (DD/MM/YYYY).
The Note includes attachments (if any) and a link to the chat in TimelinesAI.

Available Sync Settings

Sync destination: pick a module in Zoho CRM to automatically sync new incoming chats. Only modules with at least one phone-type field (e.g., Phone, Mobile) will be available for selection. If you don't see a module that you'd like to use to sync contacts into, double-check it has at least one phone-type field available.
Sync destination (for converted records): supports conversion of Leads to Contacts. When the initial Sync Destination is Leads, you can also specify how TimelinesAI sync should work in case a lead is converted. Available options: when the lead is converted, either stop message sync or continue sync to a Contact.
Field to sync the contact's WhatsApp number: when a WhatsApp message is sent or received, TimelinesAI searches for the WhatsApp contact's phone number in the selected Zoho field. If a matching record is found, the message is synced to that record. If no match is found, a new record is created in Zoho.
Field to sync the contact's WhatsApp number (for converted records): when a record is converted and the conversion traceback no longer exists in Zoho, TimelinesAI searches for the WhatsApp contact's phone number in the selected Zoho field. If a matching record is found, the message is synced to that Contact.
Field to sync the contact's name: lets you pick the field where your contact's name will sync to.
Field to sync the chat link: lets you pick which Zoho field should hold the URL of the chat thread on TimelinesAI. Useful, as it allows you to access the chat thread when clicked. We suggest creating a custom field that's easy to identify when reviewing your contact's information.
Field to sync the lead source: we add TimelinesAI to the selected field so you can filter contacts or leads created by our integration. Useful when you want to filter contacts via Zoho workflows.