---
title: "Piperun"
description: "Integração Piperun + CustomerX: Como funciona e como configurar"
url: https://ajuda.customerx.com.br/pt-br/articles/164-piperun
collection: "Integrações - CRM"
updated: 2026-08-31
language: pt-br
---

# Piperun

Integração Piperun + CustomerX: Como funciona e como configurar

A integração entre o **Piperun** e o **CustomerX** permite que negócios ganhos no Piperun sejam automaticamente transformados em **clientes** dentro do CustomerX. Além disso, é possível importar dados relevantes como **contratos**, **contatos** e a **timeline da negociação**, facilitando a continuidade do relacionamento e a gestão de sucesso do cliente.

## O que a integração faz?

Ao configurar a integração, você poderá:

-   Criar automaticamente clientes no CustomerX a partir de negócios ganhos no Piperun.
    
-   Importar o **contrato** com base no valor da negociação.
    
-   Trazer o **contato principal** (quem negociou).
    
-   Sincronizar a **timeline da negociação** para histórico e contexto.
    

## Como configurar a integração

Para realizar a integração, você precisará fornecer algumas informações essenciais:

### 1\. Autenticação

-   **URL de acesso**: o link da sua conta Piperun. Exemplo: `www.suaempresa.piperun.com`
    
-   **Token de autenticação**: disponível na tela do usuário, à esquerda, logo abaixo da sua foto.  
    👉 [Clique aqui para acessar](https://app.pipe.run/v2/me/user-data)
    

### 2\. Configurações de importação

Você deverá informar:

-   **Quais entidades deseja importar?**  
    Opções: `cliente`, `contato`, `contrato`, `timeline`.
    
-   **Deseja importar apenas negócios ganhos em funis específicos?**  
    Se sim, informe o **nome do funil**.
    
-   **Qual vínculo deseja utilizar para identificar o cliente no CustomerX?**  
    Opções: `CNPJ`, `e-mail`, `código`.
    
-   **Deseja importar todos os negócios ganhos até o momento ou apenas os novos?**  
    Escolha entre:
    
    -   Importar **todos os negócios ganhos** até agora.
        
    -   Importar **apenas novos negócios ganhos** daqui em diante.
        
-   **Deseja importar algum campo personalizado?**  
    Se sim, informe:
    
    -   **Nome do campo personalizado** no Piperun.
        
    -   **Entidade** à qual ele pertence (`negócio`, `pessoa`, `organização`).
        
    -   **Campo de destino** no CustomerX (pode ser um campo personalizado também).
        

## Observações importantes

-   A integração é **unidirecional**: os dados vêm do Piperun para o CustomerX.
    
-   A segmentação por funil permite maior controle sobre quais negócios são considerados.
    
-   Campos personalizados ajudam a manter informações específicas relevantes para sua operação de CS.
    

## Exemplos de uso

-   Um negócio ganho no funil “Vendas B2B” gera automaticamente um cliente no CustomerX com o contrato e o contato principal.
    
-   A timeline da negociação é importada, permitindo que o time de CS entenda o histórico antes do onboarding.
    
-   Campos como “Tipo de solução contratada” ou “Segmento” podem ser mapeados para campos personalizados no CustomerX.
