Zoho CRM Sync
Zoho CRM Sync connects your MonoChat workspace to your Zoho CRM, in any Zoho data centre. It:
- sends your customers' name, phone number, e-mail address and mapped profile fields to their Zoho lead or contact, and creates one when there is none,
- reads the leads and contacts changed in Zoho every 10 minutes and updates the matching customers in MonoChat,
- writes each closed conversation as a note on the customer's Zoho record,
- creates deals from your flows and your AI agent, and lets the AI agent read the customer's Zoho record.
Before you start
You need a Zoho CRM account and access to the Zoho API Console. The app connects through a Self Client, Zoho's connection for an app that runs on a server without a sign-in page:
- In the Zoho API Console, choose Self Client and create it.
- Copy the Client ID and the Client Secret.
Connect Zoho CRM
- Install the app from MonoStore.
- Open Settings › Zoho CRM.
- Choose your Zoho data centre: the domain you sign in to Zoho on (
zoho.com,zoho.eu,zoho.in,zoho.com.au,zoho.jp,zoho.sa,zohocloud.caorzoho.com.cn). - Paste the Client ID and the Client secret.
- In the Self Client's Generate Code tab, enter the scopes the settings screen lists, choose how long the code is valid, choose your organisation and create the code.
- Paste it as the Grant code and press Save before the code expires, then press Test connection.
The app keeps the token Zoho gives for the code, never your Zoho password. The client secret is never shown again; leave it empty to keep the saved one. Only the owner or a manager can change these settings.
What is synced
| Setting | What it does |
|---|---|
| New customers go to | The Zoho module a MonoChat customer is created in when Zoho has no record for them: Leads or Contacts. |
| Zoho field for the phone number | Mobile or Phone. |
| Add new Zoho records with a phone number as MonoChat customers | A lead or contact created in Zoho after you connect, with a phone number, becomes a MonoChat customer your team can message. |
| Write each closed conversation as a note on the Zoho record | When a conversation is closed, its messages since the last note (up to the last 100) are written as a note on the record. Internal notes are left out. |
| Field mapping | Up to five profile fields, each with the API name of a Zoho field and a direction: Both ways, To Zoho only or From Zoho only. Name, phone number and e-mail address are always synced. |
- From MonoChat to Zoho: when a customer's profile changes, the app finds their Zoho record by e-mail address or phone number, or creates one, and sends only the values that changed.
- From Zoho to MonoChat: every 10 minutes the app reads the leads and contacts changed in Zoho and updates the customers they are linked to, or the customer with the same phone number or e-mail address. A value that came from Zoho is not sent back.
- When a lead is converted into a contact in Zoho, the customer is linked to the contact.
- Settings › Zoho CRM shows when the last read ran and its error, if it failed.
Use it in your flows
Add a Function node to a flow under Settings › Automation › Flows and pick one of the app's nodes. See Flows.
| Node | What it does | Outputs |
|---|---|---|
| Zoho CRM · Update record | Sends the customer to Zoho now: updates their lead or contact, or creates one. | Updated, No contact |
| Zoho CRM · Create deal | Creates a deal with the name, stage, pipeline, amount and closing date you set. A contact gets the deal; a lead is converted into a contact with the deal, as Zoho's Convert does. | Created, No contact |
Write the stage and the pipeline exactly as Zoho names them. No contact means the customer's profile has neither a phone number nor an e-mail address. When Zoho refuses the request, the node takes its failed branch.
Use it with your AI agent
Add the app's tools to your AI agent:
- Zoho CRM · Read the customer's record gives the agent the customer's Zoho record: name, contact details, company, status, lead source, owner and your mapped fields.
- Zoho CRM · Create a deal records a deal when the customer agrees to buy or asks for an offer. It uses the Deal stage and Pipeline set under Deals from the AI agent in the settings, with a closing date 30 days ahead.
Good to know
- Zoho cannot notify MonoChat yet, so changes from Zoho reach MonoChat within 10 minutes.
- Records changed in Zoho before you connect are not read. A customer is linked to Zoho when their profile changes, a conversation closes or a flow node runs.
- Zoho's own workflow rules run on the records the app creates and updates.