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-kommo.md.
  • English
  • How do I import contacts, companies and opportunities from Kommo?

    You connect Kommo with a long-lived token and the account address, choose what to bring, and Clickmax copies the data. Clickmax only reads Kommo: nothing changes there. The import does not trigger automations, broadcasts or webhooks, and you can repeat it later without duplicating records.

    This page is about importing data. The Kommo webhook card, which receives contacts with tags, is a different integration.

    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 Kommo: only an account admin can create the integration and the token. The token reads the data with the permissions of the user who created it.
    • Have the account address at hand: the one you see in the browser when you open Kommo (for example, yourcompany.kommo.com).
    • Each workspace connects one Kommo account.
    • Only one import can run at a time per workspace.

    Create the token

    Do this in Kommo, in another tab.

    1. Sign in as an admin and open Settings > Integrations > Create integration.
    2. Create a private integration with no redirect URL, and save it. Leave the scopes as they are: Kommo checks all of them. If you clear Access to files, files are left out of the import.
    3. In the Keys and scopes tab, click Generate long-lived token, pick the expiry date and copy the token. Kommo shows the token only once.

    Pick an expiry date that covers the whole import. If the token expires midway, the import stops and waits for a new token.

    Connect in Clickmax

    1. Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the Kommo · import data card.
    2. Under Connect your account, paste the token into Kommo long-lived token. Use Show token to check what you pasted.
    3. In Account address, paste the account address. yourcompany, yourcompany.kommo.com or the full address copied from the browser all work.
    4. Click Connect account.

    Once connected, the screen shows the Connected badge, the account name and its address. If the integration lacks the Access to files scope, a notice says files are left out. To change the token, paste the new one, enter the address and click Update connection. Disconnect removes the connection; what was already imported stays in Clickmax.

    Choose what to bring

    Click Import data from Kommo. 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 Kommo (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 Kommo 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 Kommo pipeline can become a new pipeline with the same stages (Create a new pipeline) or be left out (Do not import). The Closed - won and Closed - lost stages of each pipeline become the won and lost stages of the pipeline. Archived pipelines are listed too.
    3. Fields, in the Contacts, Companies and Deals tabs:
      • For contacts and opportunities, each Kommo field can become a new field (Create field "…"), go to a Field that already exists in Clickmax, or be left out (Do not import). 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, Calls, meetings and emails and Files. In Kommo, Calls, meetings and emails brings the logged calls, and Files brings the files attached to notes. Without the Access to files scope, Files is disabled, with the notice The key has no access to this. Lists is disabled, with the notice Kommo does not provide this data through its API.
    5. When the contact already exists in Clickmax:
      • Fill only what is empty (default).
      • Replace with the Kommo 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.

    Click Continue. In the Review step, check the Kommo totals and how many contacts, fields and pipelines are new. Then click Import.

    What comes over and how it looks in Clickmax

    In KommoIn Clickmax
    ContactContact, linked to its company
    Contact tagTag Kommo: <tag>
    CompanyCompany
    LeadOpportunity, linked to the lead's contacts and company. Leads in Closed - won come in as won; leads in Closed - lost as lost, with the loss reason. The others stay in the same stage they have in Kommo.
    Pipeline and stagesPipeline with the same stages
    UserOwner, as set in the Owners step
    Lead, contact or company noteTimeline, marked Imported from Kommo
    Logged call (incoming or outgoing)Call activity on the timeline, with the duration
    Task, including meetingsTask, with the date. Completed tasks come in as completed.
    File attached to a note, up to 25 MBOpportunity file or link in the note

    What does not come over

    • Kommo lists (catalogs): they are not contact lists.
    • Conversations and chats.
    • Deleted leads.
    • Lead products.
    • Files over 25 MB, and every file if the integration lacks the Access to files scope.

    Kommo call limit

    Kommo accepts up to 7 calls per second and blocks access for a while when that limit is exceeded. Clickmax makes at most 5 calls per second to stay below it, so large accounts take longer to import. If Kommo blocks access anyway, the import pauses for 30 minutes and resumes on its own.

    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 Kommo data...Clickmax is reading Kommo.
    Ready to importReading is done.
    Importing into Clickmax...The data is coming in.
    Kommo limited the calls. The import resumes at …Nothing to do. The import resumes on its own at the time shown.
    The Kommo key stopped working…The token expired or was revoked. Generate a new token in Kommo, click Reconnect Kommo, paste the token 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-kommo-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 the same Kommo account as the first import.

    Common errors

    Clickmax shows these messages in Portuguese. The English below is a translation.

    MessageWhat to do
    Paste the Kommo long-lived tokenThe token field is empty. Paste the token.
    Enter your Kommo account address, like yourcompany.kommo.comCopy the address you see in the browser when you open Kommo. Only kommo.com addresses are accepted.
    Kommo refused the token. Check that you copied the whole token and that it has not expired.Check that the token belongs to the same account as the address. If it expired, generate another one in Keys and scopes.
    Kommo is limiting this account's calls. Try again in a few minutes.Wait a few minutes and try again.
    The Kommo key was revoked or expired. Reconnect under Integrations.Generate a new token and paste it under Update connection. If an import was running, click Continue import.
    An import is already running. Wait or cancel it first.Follow the current import or click Stop import.
    Could not reach Kommo right now. Try again in a few minutes.Kommo is unavailable, or the address is not an account. Check the address and try again later.