For AI agents: the complete documentation index is available at https://docs.clickmax.io/llms.txt, the full documentation bundle is available at https://docs.clickmax.io/llms-full.txt, and this page is available as Markdown at https://docs.clickmax.io/features/integrations/import-from-piperun.md.
  • Português
  • Como importar contatos, empresas e oportunidades do PipeRun?

    Você conecta o PipeRun com o token de API de um usuário, escolhe o que trazer e a Clickmax copia os dados. A Clickmax só lê o PipeRun: nada muda lá. A importação não dispara automações, disparos nem webhooks, e você pode repetir depois sem duplicar registros.

    Esta página é sobre o importador. O webhook de saída para o PipeRun é outra integração.

    Antes de começar

    • Para importar: papel de workspace Proprietário ou Administrador, ou Membro com cargo que tenha a permissão Importar de outro CRM. Para conectar a conta, o cargo também precisa de acesso a Integrações. Veja papéis e permissões.
    • No PipeRun: use o token de um usuário que vê todos os negócios da conta, de preferência um administrador. O token enxerga o que o usuário dele vê, e a API do PipeRun não informa à Clickmax de qual usuário é o token nem o que ele pode ver. Por isso, a Clickmax não consegue conferir isso ao conectar nem durante a importação. Com um usuário que vê só os próprios negócios, ou que não vê alguns funis, a importação traz só o que esse usuário vê e termina como Importação concluída., sem erro nem aviso.
    • Cada workspace conecta uma conta do PipeRun.
    • Só pode haver uma importação em andamento por workspace.

    Pegar o token

    Faça isto no PipeRun, em outra aba.

    1. Entre com um usuário administrador.
    2. Abra o seu perfil e copie o token de API.

    Conectar na Clickmax

    1. Abra Integrações > Explorar integrações e selecione o card PipeRun · importar dados.
    2. Em Conectar sua conta, cole o token em Token de API do PipeRun. Use Mostrar token para conferir o que colou.
    3. Clique em Conectar conta.

    Conectada, a tela mostra o selo Conectado e o nome da conta no PipeRun. Para trocar o token, cole o novo e clique em Atualizar token. Desconectar remove a conexão; o que já foi importado continua na Clickmax.

    Escolher o que trazer

    Clique em Importar dados do PipeRun. Também dá para chegar aqui pela lista de contatos: na seta ao lado de Adicionar contato, escolha Importar contatos e, abaixo da área do arquivo, clique em PipeRun (no celular, toque antes em +N outros se ele não aparecer). Se a conta já estiver conectada, o chip mostra Conectado e a importação abre ali mesmo, sem sair de Contatos. A janela tem três passos: Mapear, Conferir e Importar.

    No passo Mapear:

    1. Responsáveis: escolha o atendente da Clickmax de cada usuário do PipeRun, inclusive os inativos. Quem ficar sem par entra sem responsável, ou com o Responsável padrão se você escolher um. A importação não cria atendentes nem envia convites.
    2. Pipelines: cada funil do PipeRun pode virar um pipeline novo com as mesmas etapas (Criar pipeline novo) ou ficar de fora (Não importar). A Clickmax acrescenta duas etapas no fim de cada pipeline, Ganho e Perdido, para as oportunidades ganhas e perdidas.
    3. Campos, nas abas Contatos, Empresas e Oportunidades:
      • Em contatos e oportunidades, cada campo do PipeRun, inclusive os campos personalizados, pode virar um campo novo (Criar campo "…"), ir para um Campo que já existe na Clickmax ou ficar de fora (Não importar). Em oportunidades, aparecem só os campos personalizados: título, valor, etapa, responsável e status vêm sempre.
      • Em empresas, o campo vai para um Campo da Clickmax ou fica de fora. Os campos personalizados de empresa são guardados pela importação (Guardar no histórico da empresa), mas ainda não aparecem na Clickmax.
    4. O que trazer: marque Notas. Listas, Tarefas, Ligações, reuniões e e-mails e Arquivos aparecem desabilitados, com o aviso O PipeRun não oferece estes dados pela API.
    5. Quando o contato já existe na Clickmax:
      • Preencher só o que estiver vazio (padrão).
      • Trocar pelos dados do PipeRun.
      • Não mexer no contato.

    A Clickmax identifica contatos repetidos por e-mail, telefone ou CPF, com as mesmas regras da importação por planilha.

    Clique em Continuar. No passo Conferir, veja quantos contatos, campos e pipelines são novos. O PipeRun não informa quantas pessoas, empresas, oportunidades e notas a conta tem, então esses números aparecem como —. Depois clique em Importar.

    O que vem e como fica na Clickmax

    No PipeRunNa Clickmax
    PessoaContato, ligado às empresas dela
    EmpresaEmpresa
    OportunidadeOportunidade. As ganhas ficam na etapa Ganho; as perdidas, na etapa Perdido, com o motivo da perda. As em aberto ficam na mesma etapa em que estão no PipeRun. Uma com um status que a Clickmax não reconhece também vem como em aberto, na etapa dela. As congeladas também vêm. As que estão na lixeira não vêm.
    Funil e etapasPipeline com as mesmas etapas, mais Ganho e Perdido
    UsuárioResponsável, conforme o passo Responsáveis
    Campo personalizadoCampo, conforme o passo Campos
    NotaLinha do tempo do contato ou da oportunidade, marcada como Importado do PipeRun

    O que não vem

    • Tarefas e atividades, como ligações e reuniões.
    • Arquivos.
    • Listas: o PipeRun não tem listas de contatos.
    • Tags: a API do PipeRun não informa quais tags estão em cada registro.
    • Itens e produtos das oportunidades.

    Acompanhar, parar e repetir

    Você pode fechar a janela: a importação continua e, ao voltar, você vê o andamento por tipo (Lidos, Criados, Já existiam, Ignorados, Falharam).

    SituaçãoO que significa
    Lendo os dados do PipeRun...A Clickmax está lendo o PipeRun.
    Pronto para importarA leitura terminou.
    Importando para a Clickmax...Os dados estão entrando.
    O PipeRun limitou as chamadas. A importação volta às …Não precisa fazer nada. A importação continua sozinha no horário mostrado.
    A chave do PipeRun parou de funcionar…Clique em Reconectar o PipeRun, cole um token válido e clique em Continuar importação. Ela segue de onde parou.
    Importação concluída.Terminou.
    A importação falhou.Veja Erros comuns.
    Importação parada.Você parou a importação.

    Quando o PipeRun limita as chamadas, a importação pausa e volta sozinha.

    • Parar: clique em Parar importação. O que já entrou continua na Clickmax.
    • Itens que não entraram: clique em Baixar itens não importados. A planilha importacao-piperun-pendencias.csv lista o tipo e o motivo de cada item, com a situação falhou, ignorado ou aviso. aviso quer dizer que o item entrou, mas uma associação (por exemplo, a empresa de um contato) ficou de fora. A planilha não tem limite de linhas: ela traz todos os itens pendentes, sem cortar nenhum. O botão aparece quando a importação é concluída.
    • Repetir: importar de novo não duplica nada. Contatos e empresas são atualizados conforme a opção que você escolher em Quando o contato já existe na Clickmax. Oportunidades e históricos que já vieram não são reescritos. Conecte com um token da mesma conta do PipeRun.

    Erros comuns

    MensagemO que fazer
    Cole o token de API do PipeRunO campo do token está vazio. Cole o token.
    O PipeRun recusou o token. Confira se copiou o token inteiro.Copie o token de novo no seu perfil do PipeRun.
    O PipeRun está limitando as chamadas desta conta. Tente em 1 minuto.Espere um minuto e tente de novo.
    A chave do PipeRun foi revogada ou expirou. Reconecte em Integrações.Cole um token válido em Atualizar token. Se havia uma importação em andamento, clique em Continuar importação.
    Já existe uma importação em andamento. Aguarde ou cancele antes.Acompanhe a importação atual ou clique em Parar importação.
    Não foi possível falar com o PipeRun agora. Tente de novo em alguns minutos.Indisponibilidade do lado do PipeRun. Tente de novo mais tarde.

    A Clickmax não distingue uma importação parcial de uma completa, então compare o número de oportunidades na Clickmax com o do PipeRun. Se vieram menos do que você esperava, confira se o token é de um usuário que vê todos os negócios. Troque o token em Atualizar token e importe de novo: o que já veio não é duplicado.

    Relacionados