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.
- Sign in as an admin and open Settings > Integrations > Create integration.
- 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.
- 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
- Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the Kommo · import data card.
- Under Connect your account, paste the token into Kommo long-lived token. Use Show token to check what you pasted.
- In Account address, paste the account address.
yourcompany,yourcompany.kommo.comor the full address copied from the browser all work. - 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:
- 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.
- 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.
- 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.
- 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.
- 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
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).
- 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.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 the same Kommo account as the first import.
Common errors
Clickmax shows these messages in Portuguese. The English below is a translation.