How do I import contacts, companies and opportunities from Zoho CRM?
You create a Self Client in the Zoho API console, paste the Client ID, the Client Secret and a code generated there into Clickmax, choose what to bring, and Clickmax copies the data. Clickmax only reads Zoho CRM: nothing changes there. The import does not trigger automations, broadcasts or webhooks, and you can repeat it later without duplicating records.
Before you start
- To import: workspace role Owner or Administrator, or a Member whose job title has the Importar de outro CRM (Import from another CRM) permission. To connect the account, the job title also needs access to Integrations. See roles and permissions.
- In Zoho CRM: generate the code with an administrator user. Notes come over only when the connecting user is an administrator, and the other data comes with what that user can see.
- Know your Zoho account's data center: it is the end of the Zoho address in your browser (zoho.com, zoho.eu, zoho.in and so on).
- Each workspace connects one Zoho CRM organization.
- Only one import can run at a time per workspace.
Create the Self Client and generate the code
Keep the Zoho CRM screen open in Clickmax (Integrações (Integrations) > Explorar integrações (Explore integrations) > Zoho CRM · import data card) and do this in Zoho, in another tab. The code works once and expires in a few minutes, so paste it and connect right after you generate it.
- Open api-console.zoho.com and sign in with the Zoho CRM user.
- Choose Self Client, click CREATE NOW and confirm.
- In the Client Secret tab, copy the Client ID and the Client Secret.
- In the Generate Code tab, paste in the Scope field the list shown under Scopes on the Clickmax screen (use Copy):
ZohoCRM.modules.READ,ZohoCRM.settings.READ,ZohoCRM.users.READ,ZohoCRM.org.READ - In Time Duration, pick the longest duration (for example, 10 minutes). Write any description and click CREATE.
- Choose Zoho CRM and the organization you want to import, then click CREATE.
- Copy the code that appears.
Connect in Clickmax
- Under Connect your account, choose the Account data center. The default is United States (zoho.com).
- Paste the Client ID, the Client Secret and, in Generated code, the code from the previous step.
- Click Connect account.
Clickmax exchanges the code right away and does not store it. Once connected, the screen shows the Connected badge, the organization name and the e-mail of the connecting user. If that user is not an administrator, the screen warns that notes are left out of the import.
To change the connection, generate a new code in the same Self Client, paste the three values and click Update connection. Disconnect removes the connection; what was already imported stays in Clickmax. The connection keeps working until you delete the Self Client in the Zoho API console or revoke its access.
Choose what to bring
Click Import data from Zoho CRM. You can also get here from the contacts list: in the arrow next to Add contact, choose Import contacts and, below the file area, click Zoho CRM (on a phone, tap +N more first if it is not shown). If the account is already connected, the chip shows Connected and the import opens right there, without leaving Contacts. The window has three steps: Map, Review and Import.
In the Map step:
- Owners: choose the Clickmax attendant for each Zoho CRM user. Users without a match come in with no owner, or with the Default owner if you pick one. The import does not create attendants or send invitations.
- Pipelines: each Zoho CRM deal pipeline can become a new pipeline with the same stages (Create a new pipeline) or be left out (Do not import).
- Fields, in the Contacts, Companies and Deals tabs:
- For contacts and opportunities, each Zoho CRM field, custom fields included, can become a new field (Create field "…"), go to a Field that already exists in Clickmax, or be left out (Do not import). The Contacts tab lists the fields of both Contacts and Leads. For opportunities, only custom fields are listed: name, value, stage, owner and status always come over.
- For companies, the field goes to a Clickmax field or is left out.
- What to bring: select Notes, Tasks and Calls, meetings and emails. Lists and Files are disabled, with the notice Zoho CRM does not provide this data through its API. If the connecting user is not an administrator, Notes is disabled with the notice The key has no access to this.
- When the contact already exists in Clickmax:
- Fill only what is empty (default).
- Replace with the Zoho CRM data.
- Leave the contact as it is.
Clickmax spots repeated contacts by e-mail, phone or CPF, with the same rules as the spreadsheet import. A Zoho lead and a Zoho contact with the same e-mail become one contact.
Click Continue. In the Review step, check how many users and pipelines the account has and how many contacts, fields and pipelines are new. Counting the other records would spend Zoho's daily credits, so those numbers show as —. Then click Import.
What comes over and how it looks in Clickmax
Records deleted in Zoho CRM do not come over.
What does not come over
- Attached files: Zoho charges one call per record to list them, which would spend the daily credits.
- Lists (custom views): in Zoho they are filters, not contact lists.
- Converted leads: in Zoho they become a contact, an account and a deal, so they come over through the contact.
- Notes, when the connecting user is not a Zoho CRM administrator.
- Deal products.
Limits
- Zoho CRM has daily API credits per organization, which depend on the edition and the number of licenses. One read page brings up to 200 records and spends one credit. When the credits run out or get close to the end, the import pauses and resumes on its own when Zoho frees credits. On the free edition, large accounts can take more than a day.
- Each module (Contacts, Leads, Accounts, Deals, Tasks, Calls, Meetings, Notes) has a limit of 100,000 records, the most the Zoho API lets an import read. If a module goes past it, the import stops with an error that names the module, instead of finishing without the remaining records.
Follow, stop and repeat
You can close the window: the import keeps running, and when you come back you see the progress per type (Read, Created, Already existed, Skipped, Failed).
- Stop: click Stop import. What already came in stays in Clickmax.
- Items that did not come in: click Download items not imported. The spreadsheet
importacao-zoho-pendencias.csvlists the type and the reason of each item, with the status falhou (failed), ignorado (skipped) or aviso (warning). aviso means the item came in, but an association (for example, a contact's company) was left out. - Repeat: importing again does not duplicate anything. Contacts and companies are updated according to the option you pick under When the contact already exists in Clickmax. Opportunities and history that already came in are not rewritten. Connect with the same Zoho CRM organization.
Common errors
Clickmax shows these messages in Portuguese. The English below is a translation.
If the import finished without notes, check that the connecting user is a Zoho CRM administrator.