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

    You connect PipeRun with a user's API token, choose what to bring, and Clickmax copies the data. Clickmax only reads PipeRun: 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 the importer. The outgoing webhook to PipeRun 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 PipeRun: use the token of a user who sees all deals in the account, ideally an admin. The token sees what its user sees, and the PipeRun API does not tell Clickmax which user owns a token or what that user can see. So Clickmax cannot check this when you connect or while it imports. With a user who sees only their own deals, or who cannot see some pipelines, the import brings only what that user sees and still finishes as Import complete., with no error or warning.
    • Each workspace connects one PipeRun account.
    • Only one import can run at a time per workspace.

    Get the token

    Do this in PipeRun, in another tab.

    1. Sign in with an admin user.
    2. Open your profile and copy the API token.

    Connect in Clickmax

    1. Open Integrações (Integrations) > Explorar integrações (Explore integrations) and select the PipeRun · import data card.
    2. Under Connect your account, paste the token into PipeRun API token. Use Show token to check what you pasted.
    3. Click Connect account.

    Once connected, the screen shows the Connected badge and the account name in PipeRun. 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 PipeRun. 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 PipeRun (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 PipeRun user, including inactive users. 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 PipeRun pipeline 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 opportunities.
    3. Fields, in the Contacts, Companies and Deals tabs:
      • For contacts and opportunities, each PipeRun 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.
    4. What to bring: select Notes. Lists, Tasks, Calls, meetings and emails and Files are disabled, with the notice PipeRun 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 PipeRun 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 contacts, fields and pipelines are new. PipeRun does not report how many people, companies, opportunities and notes the account has, so those numbers show as —. Then click Import.

    What comes over and how it looks in Clickmax

    In PipeRunIn Clickmax
    PersonContact, linked to its companies
    CompanyCompany
    OpportunityOpportunity. Won ones sit in the Ganho (Won) stage; lost ones in Perdido (Lost), with the lost reason. Open ones stay in the same stage they have in PipeRun. One with a status Clickmax does not recognize also comes over as open, in its stage. Frozen ones come over too. The ones in the trash do not.
    Pipeline and stagesPipeline with the same stages, plus Ganho and Perdido
    UserOwner, as set in the Owners step
    Custom fieldField, as set in the Fields step
    NoteContact or opportunity timeline, marked Imported from PipeRun

    What does not come over

    • Tasks and activities, such as calls and meetings.
    • Files.
    • Lists: PipeRun has no contact lists.
    • Tags: the PipeRun API does not report which tags are on each record.
    • Opportunity items and 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).

    StatusWhat it means
    Reading your PipeRun data...Clickmax is reading PipeRun.
    Ready to importReading is done.
    Importing into Clickmax...The data is coming in.
    PipeRun limited the calls. The import resumes at …Nothing to do. The import resumes on its own at the time shown.
    The PipeRun key stopped working…Click Reconnect PipeRun, paste a valid 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.

    When PipeRun 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-piperun-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. The spreadsheet has no row limit: it lists every pending item and cuts none. The button shows up once the import completes.
    • 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 PipeRun account.

    Common errors

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

    MessageWhat to do
    Paste the PipeRun API tokenThe token field is empty. Paste the token.
    PipeRun refused the token. Check that you copied the whole token.Copy the token again from your PipeRun profile.
    PipeRun is limiting this account's calls. Try again in 1 minute.Wait a minute and try again.
    The PipeRun key was revoked or expired. Reconnect under Integrations.Paste a valid token under Update token. 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 PipeRun right now. Try again in a few minutes.PipeRun is unavailable. Try again later.

    Clickmax cannot tell a partial import apart from a complete one, so compare the number of opportunities in Clickmax with the number in PipeRun. If there are fewer than you expected, check that the token belongs to a user who sees all deals. Change the token under Update token and import again: what already came in is not duplicated.