Guide · Zoho CRM
Zoho CRM integration: chat leads and transcripts
Connect Zoho CRM to Chaterimo with OAuth: every new lead from the chat becomes a Zoho CRM lead, with the conversation attached as a note.
In short
- 01The Zoho CRM integration creates a lead in Zoho CRM for every new lead in Chaterimo, with name, e-mail, phone, message and the Lead Source “Chaterimo Chat”.
- 02The conversation up to that moment is attached to the Zoho lead as a note.
- 03You connect with OAuth: you log in at Zoho and accept the access, so Chaterimo never sees your Zoho password and cannot read your other CRM records.
- 04Choose the Zoho data center of your account before you connect; a wrong data center makes the connection fail.
- 05Only leads created after the connection go to Zoho CRM; older leads stay in Chat Leads.
What you need
- A Chaterimo account. Zoho CRM is on the Integrations page of every account; the app does not limit it to a plan.
- A Zoho CRM account (any edition, including Free) whose user may create leads and notes.
- A lead form in the chat window, so visitors can leave their contact details.
The Zoho CRM integration sends every new lead from your Chaterimo chat window to Zoho CRM and attaches the conversation to it as a note. You connect it on the Integrations page: choose your Zoho data center, select Connect Zoho CRM, log in at Zoho and accept the access. This guide is for stores that already use Zoho CRM for sales and want the contacts from the chat there, without copying them by hand.
Steps
1Turn on the lead form in the chat window
Chaterimo creates a lead when a visitor sends the lead form in the chat window. Open Chat Settings & Embed, go to Lead generation form and set Lead generation form mode:
- Inquiry tab
- The chat stays open and the chat window gets a separate tab where visitors can leave their contact details.
- Introduce yourself (gate)
- The chat window shows the contact form first and opens the conversation only after the visitor sends it. The e-mail address is always required.
Choose which fields the form shows and which are required, then select Save changes.
If you use Tickets, Chaterimo also creates a lead when it files a ticket from a conversation in which the customer gave an e-mail address. These leads go to Zoho CRM too, with the ticket summary as their description.
2Choose your Zoho data center
Zoho keeps each account in one data center, and Chaterimo must talk to the right one.1 Open Integrations in the menu and find the Zoho CRM card in the CRM section. In Select your Zoho data center:, choose the one that matches the address of your Zoho account when you are logged in:
| Your Zoho address ends with | Choose in Chaterimo |
|---|---|
| zoho.eu | Europe (EU) |
| zoho.com | United States (US) |
| zoho.in | India |
| zoho.com.au | Australia |
| zoho.jp | Japan |
| zoho.uk | United Kingdom |
| zohocloud.ca | Canada |
| zoho.sa | Saudi Arabia |
For Canada, Chaterimo signs you in at accounts.zohocloud.ca, the login address Zoho lists for its Canadian data center.2
Zoho's data center in China (zoho.com.cn) is not in the list, so Chaterimo cannot connect to it.
3Connect Zoho CRM
Select Connect Zoho CRM. Chaterimo opens the Zoho login page of the data center you chose. Log in with the Zoho user whose name the leads should be created under. Every Zoho CRM edition, including Free, can use the API that Chaterimo needs; each edition has its own daily limit of API calls.5
If your Zoho CRM has more than one environment, Zoho first asks which organisation the app may use, for example Production or Sandbox.3 Choose Production for real customer leads. Zoho then shows the access Chaterimo asks for: to create and update leads, to create notes, and to read your Zoho user and organisation details. Chaterimo cannot read your leads, contacts or deals. Select Accept.
Zoho sends you back to Chaterimo, which shows “Successfully connected to Zoho CRM!”. The card now says Connected and shows the e-mail address of the Zoho user. Chaterimo stores the Zoho access tokens encrypted and never sees your Zoho password.
4Check the sync settings
After the connection, the card shows three switches. The first two are on.
- Sync Leads
- Create a lead in Zoho CRM when a visitor sends the lead form.
- Sync Transcripts
- Attach the chat transcript as a note when the lead is created in Zoho CRM.
- Pause Integration
- Stop sending leads to Zoho CRM without disconnecting. Leads created during the pause are not sent later.
Change a switch and select Save.
How to check it works
- Open your store, open the chat window and send the lead form with your own e-mail address.
- In Chaterimo, open Chat Leads. The new lead is there.
- In Zoho CRM, open Leads. After a short moment the same lead appears.
- Open the lead. Under Notes you find a note “Chat Transcript” with the date, followed by the conversation, each message marked Visitor or Chatbot.
Chaterimo fills in these fields of the Zoho lead:
| Zoho CRM field | What Chaterimo fills in |
|---|---|
| First Name, Last Name | The name from the form, split at the first space. Without a name, “Unknown”. |
| The e-mail address from the form. | |
| Phone | The phone number, if the form asks for it. |
| Description | The message from the form, or the ticket summary for a lead from a ticket. |
| Lead Source | The value “Chaterimo Chat”, sent with every lead. |
Note
The note is created right after the lead, so it holds the conversation up to that moment. Messages written later are not added. With Introduce yourself (gate), the form comes before the conversation, so the note holds no messages.
Troubleshooting
- “Zoho CRM integration is not configured. Please contact support.”
- The Zoho connection is not set up on Chaterimo's side. Write to info@chaterimo.com.
- “Zoho authorization failed: …”
- You selected Reject at Zoho, or the Zoho user has no Zoho CRM account. Zoho then shows only a Back to app button instead of Accept.4 Log in with a user who has Zoho CRM and select Connect Zoho CRM again.
- “Failed to connect to Zoho CRM. Please try again.”
- Zoho did not confirm the connection. One cause is a data center that does not match your Zoho account. Check the address of your Zoho account (step 2), choose the matching data center and connect again.
- “Invalid request. Please try again.”
- Chaterimo could not match Zoho's answer to your session, for example after you logged in again in the meantime. Select Connect Zoho CRM again in the same browser.
- A lead is in Chat Leads but not in Zoho CRM
- Check that Sync Leads is on and Pause Integration is off. Leads created before the connection or during a pause are never sent. If the Zoho user lost the right to create leads, or the access was revoked in Zoho, the card still says Connected: select Disconnect, then connect again. Zoho also refuses a lead that breaks one of its own rules, for example a second lead with the same e-mail address when Email is a unique field.
- You want another Zoho user or another data center
- Select Disconnect on the card and confirm. Then choose the data center and connect with the other user.
Next step
Make sure the chatbot answers well before it asks for contact details. Our guide How to choose an LLM for customer support shows how to compare models on your own questions, and the research State of AI customer support in e-commerce shows when shoppers ask and how much the AI handles.
-
Zoho, “Data center for Zoho Account”, accessed 19 October 2026, https://help.zoho.com/portal/en/kb/accounts/manage-your-zoho-account/articles/data-center-for-zoho-account ↑
-
Zoho CRM, “Multi DC Support”, accessed 20 October 2026, https://www.zoho.com/crm/developer/docs/api/v8/multi-dc.html ↑
-
Zoho CRM, “Org-specific OAuth2.0 Tokens in Zoho CRM”, accessed 19 October 2026, https://help.zoho.com/portal/fr/community/topic/org-specific-oauth2-0-tokens-in-zoho-crm ↑
-
Zoho, “Announcement: Upcoming changes to the permission grant flow for OAuth apps”, accessed 19 October 2026, https://help.zoho.com/portal/fr/community/topic/announcement-upcoming-changes-to-the-permission-grant-flow-for-oauth-apps ↑
-
Zoho CRM, “API Limits”, accessed 19 October 2026, https://www.zoho.com/crm/developer/docs/api/v8/api-limits.html ↑
Frequently asked questions
Does Chaterimo send my existing leads to Zoho CRM?
No. Only leads created after you connect Zoho CRM are sent, one by one as they come in. Older leads stay in Chat Leads in Chaterimo.
Can Chaterimo read my Zoho CRM data?
No. Chaterimo asks Zoho only for the right to create and update leads, to create notes and to read your Zoho user and organisation details. It cannot read your leads, contacts or deals.
Does the integration create contacts or deals?
No. It creates a lead with a note. You convert the lead to a contact or deal in Zoho CRM as usual.
Can I connect another CRM?
Yes. The CRM section of the Integrations page also has HubSpot and Pipedrive.
Changelog
- Rewritten for the current Integrations page, with what Chaterimo sends to Zoho and troubleshooting.
- Published.