How do I import contacts, companies and opportunities from Agendor?
You connect Agendor with the API token of an administrator user, choose what to bring, and Clickmax copies the data. Clickmax only reads Agendor: 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 Agendor: use the token of an administrator user. The token sees what its user sees. A collaborator's token brings only that user's records, and Clickmax cannot check the user's role when you connect.
- Each workspace connects one Agendor account.
- Only one import can run at a time per workspace.
Get the token
Do this in Agendor, in another tab.
- Sign in with an administrator user.
- Open Menu > Integrações > Token da API and copy the token.
Connect in Clickmax
- Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the Agendor · import data card.
- Under Connect your account, paste the token into Agendor API token. Use Show token to check what you pasted.
- Click Connect account.
Once connected, the screen shows the Connected badge and the e-mail of the user who owns the token. To change the token, paste the new one and click Update token. Disconnect removes the connection; what was already imported stays in Clickmax.
Choose what to bring
Click Import data from Agendor. 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 Agendor (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 Agendor 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 Agendor funnel can become a new pipeline with the same stages (Create a new pipeline) or be left out (Do not import). Clickmax adds two stages at the end of each pipeline, Ganho (Won) and Perdido (Lost), for won and lost deals.
- Fields, in the Contacts, Companies and Deals tabs:
- For contacts and opportunities, each Agendor 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). For opportunities, only custom fields are listed: title, value, stage, owner and status always come over.
- For companies, the field goes to a Clickmax field or is left out. Company custom fields are kept by the import (Keep in the company history), but they do not show in Clickmax yet.
- What to bring: select Notes and Tasks. Lists, Calls, meetings and emails and Files are disabled, with the notice Agendor does not provide this data through its API.
- When the contact already exists in Clickmax:
- Fill only what is empty (default).
- Replace with the Agendor 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 how many people, companies and deals the account has and how many contacts, fields and pipelines are new. Agendor does not report how many comments and tasks exist, so those numbers show as —. Then click Import.
What comes over and how it looks in Clickmax
Records deleted in Agendor do not come over.
What does not come over
- Files attached to comments: the Agendor API gives no access to them.
- Lists: Agendor has no contact lists.
- Calls, meetings and emails as separate activities. In Agendor they are tasks, so they come over as tasks when you select Tasks.
- Deal products.
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).
Agendor does not publish a rate limit. Clickmax reads the account slowly and, if Agendor limits the calls, the import pauses and resumes on its own.
- 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-agendor-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 a token from the same Agendor account.
Common errors
Clickmax shows these messages in Portuguese. The English below is a translation.
If the import finished with fewer records than you expected, check that the token belongs to an administrator user. Change the token under Update token and import again: what already came in is not duplicated.