For AI agents: the complete documentation index is available at https://docs.clickmax.io/en/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/en/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/en/features/integrations/import-from-zoho.md.
  • English
  • 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.

    1. Open api-console.zoho.com and sign in with the Zoho CRM user.
    2. Choose Self Client, click CREATE NOW and confirm.
    3. In the Client Secret tab, copy the Client ID and the Client Secret.
    4. 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
    5. In Time Duration, pick the longest duration (for example, 10 minutes). Write any description and click CREATE.
    6. Choose Zoho CRM and the organization you want to import, then click CREATE.
    7. Copy the code that appears.

    Connect in Clickmax

    1. Under Connect your account, choose the Account data center. The default is United States (zoho.com).
    2. Paste the Client ID, the Client Secret and, in Generated code, the code from the previous step.
    3. 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:

    1. 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.
    2. 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).
    3. 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.
    4. 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.
    5. 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

    In Zoho CRMIn Clickmax
    Contact (Contacts module)Contact with the Contato tag, linked to its company
    Non-converted lead (Leads module)Contact with the Lead tag
    Contact or lead tagTag with the same name
    Account (Accounts module)Company
    Deal (Deals module)Opportunity, linked to the contact and the company, in the same stage. Won or lost comes from the stage forecast in Zoho (Closed Won or Closed Lost), and lost ones bring the lost reason. If a stage has a forecast other than Open, Closed Won or Closed Lost, the preview and the import stop with an error; fix the stage forecast in Zoho and try again.
    Pipeline and stagesPipeline with the same stages
    UserOwner, as set in the Owners step
    Custom fieldField, as set in the Fields step
    TaskTask, done if it is completed in Zoho. A status that is not one of Zoho's defaults keeps the task open and goes to the end of the description as "Status no Zoho"
    Call and meetingContact timeline, marked Imported from Zoho CRM
    Note (administrators only)Note on the contact, company or opportunity timeline, marked Imported from Zoho CRM

    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).

    StatusWhat it means
    Reading your Zoho CRM data...Clickmax is reading Zoho CRM.
    Ready to importReading is done.
    Importing into Clickmax...The data is coming in.
    Zoho CRM limited the calls. The import resumes at …Nothing to do. The import resumes on its own at the time shown.
    The Zoho CRM key stopped working…Click Reconnect Zoho CRM, generate a new code, connect again and click Continue import. It continues from where it stopped.
    Import complete.Done.
    The import failed.See Common errors.
    Import stopped.You stopped the import.
    • 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.csv lists 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.

    MessageWhat to do
    Zoho refused the code: it expires in a few minutes and works only once. Generate a new code and paste it right away.Generate a new code in the Generate Code tab and connect right after.
    Zoho did not find this Client ID in the chosen data center. Check the data center and the Client ID.Check the end of the Zoho address in your browser and the Client ID in the Client Secret tab. Then generate a new code.
    Zoho refused the Client Secret. Copy the Self Client's Client Secret again.Copy the Client Secret again, generate a new code and connect.
    The Zoho account belongs to another data center. Choose the data center shown in the Zoho address (zoho.com, zoho.eu, zoho.in...).Choose the right data center and generate a new code.
    The code lacks permissions. Generate a new code pasting the whole scope list.Paste the whole Scopes list in the Scope field and generate a new code.
    Zoho is limiting this account's calls. Wait a few minutes and generate a new code.Wait a few minutes and try again with a new code.
    An import is already running. Wait or cancel it first.Follow the current import or click Stop import.
    Could not reach Zoho right now. Generate a new code and try again in a few minutes.Zoho is unavailable. Try again later.
    Zoho CRM refused the extraction: Zoho Contacts has more than 100,000 records… (with the module name)The module is over the 100,000-record limit. Turn that data type off in the import, or delete or merge records in Zoho until it fits, and import again.

    If the import finished without notes, check that the connecting user is a Zoho CRM administrator.