> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar a integração com o Pipedrive

> Saiba como conectar o Pipedrive ao LanderLab e enviar cada lead das suas landing pages para o Pipedrive como uma pessoa, com um lead aberto automaticamente, em tempo real. Sem precisar de código.

<Frame>
  <img src="https://mintcdn.com/landerlab-babdc23f/CyiTBU09-SWFPQqF/images/LL-Pipedrive.png?fit=max&auto=format&n=CyiTBU09-SWFPQqF&q=85&s=4c502adbfbf6d5543c489e1ddb1ec141" alt="LL Pipedrive" width="1200" height="600" data-path="images/LL-Pipedrive.png" />
</Frame>

Conecte o Pipedrive ao LanderLab para enviar automaticamente cada novo lead para a sua conta do Pipedrive no momento em que alguém enviar um formulário. Sem exportações manuais, sem atrasos.

## O que é o Pipedrive e por que usar esta integração?

O Pipedrive é uma ferramenta de CRM e pipeline de vendas usada para gerenciar pessoas, negócios (deals) e follow-ups em um só lugar. Quando você conecta o Pipedrive a uma landing page do LanderLab, cada lead que envia o seu formulário é salvo como uma **pessoa** (person) no Pipedrive, e um **lead** é aberto automaticamente para essa pessoa.

O Pipedrive se conecta com um **API Token**. Você copia o token da sua conta do Pipedrive e o cola no LanderLab uma única vez. Depois disso, é só mapear os campos do formulário e colocar no ar.

<Note>
  As integrações com o Pipedrive **são salvas globalmente na sua conta**. Depois que você conecta uma conta do Pipedrive, pode reutilizá-la em várias landing pages sem precisar informar o API token novamente. Você também pode adicionar mais de uma conta do Pipedrive na mesma tela.
</Note>

## Pré-requisitos

Antes de começar, verifique se você tem:

* Uma conta do LanderLab com pelo menos uma landing page que tenha um campo de e-mail
* Uma conta do Pipedrive
* O seu **API Token pessoal** do Pipedrive

## Passo 1: Obter o seu API Token do Pipedrive

<Steps>
  <Step title="Abra as configurações do Pipedrive">
    Faça login no Pipedrive, clique no seu **ícone de perfil** no canto superior direito e acesse **Company settings**.
  </Step>

  <Step title="Abra a aba API">
    Na barra lateral esquerda, clique em **Personal preferences** e abra a aba **API**.
  </Step>

  <Step title="Copie o seu API token">
    Copie o seu **personal API token**. Guarde-o em um lugar seguro para o próximo passo.

    <Note>
      Se você não estiver vendo a aba API, a sua função de usuário não tem o acesso à API ativado. Peça ao administrador do seu Pipedrive que ative esse acesso para o seu conjunto de permissões.
    </Note>
  </Step>
</Steps>

## Passo 2: Conectar a sua conta do Pipedrive

<Steps>
  <Step title="Acesse sua landing page">
    No LanderLab, acesse **Landing Pages** e abra a landing page à qual você quer adicionar o Pipedrive.
  </Step>

  <Step title="Abra Add Integration">
    Clique em **Add Integration** para abrir o painel de integrações.
  </Step>

  <Step title="Encontre o Pipedrive">
    Pesquise **Pipedrive** ou abra a categoria **CRM** e clique em **Pipedrive**.
  </Step>

  <Step title="Informe as suas credenciais">
    Preencha os seguintes campos:

    * **Name** - Um nome para esta conta (ex.: "Pipedrive"). Ele só é usado para identificar a conta dentro do LanderLab.
    * **API Token** - Cole o personal API token que você copiou do Pipedrive.

    Clique em **Add Pipedrive** para salvar a conta.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/3PsYzlCMwYDTCEcG/images/image-32.png?fit=max&auto=format&n=3PsYzlCMwYDTCEcG&q=85&s=325bef1867b9c1349294d4844407910c" alt="Imagem" width="581" height="338" data-path="images/image-32.png" />
    </Frame>
  </Step>
</Steps>

## Passo 3: Configurar a integração

Depois que você salva a sua conta, um assistente de configuração é aberto. Ele tem três passos: dar um nome à integração, mapear os campos e, por fim, revisar e conectar.

### Dar um nome à integração

<Steps>
  <Step title="Defina um nome">
    Dê a esta integração um nome fácil de reconhecer (ex.: "Pipedrive - Leads de automóveis"). Isso ajuda você a encontrá-la na lista de integrações da sua landing page.
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o mapeamento de campos.
  </Step>
</Steps>

### Mapear os campos

O LanderLab mostra os campos do seu formulário à esquerda e, à direita, um menu suspenso para escolher o **Pipedrive field** correspondente.

<Warning>
  O Pipedrive precisa do **Name** para criar uma pessoa. Você precisa mapear um campo para **Name**; caso contrário, a integração não conseguirá criar o registro e você verá a mensagem "Map a field to Name so Pipedrive can create the person".
</Warning>

<Steps>
  <Step title="Mapeie o e-mail">
    Mapeie o campo de **e-mail** do seu formulário para o campo **Email** do Pipedrive.
  </Step>

  <Step title="Mapeie o nome">
    Mapeie um campo para **Name**. Isso é obrigatório. Use o campo de nome do seu formulário, se você coletar um, ou mapeie outro valor para que o Pipedrive tenha um nome com o qual criar a pessoa.

    <Frame>
      <img src="https://mintcdn.com/landerlab-babdc23f/3PsYzlCMwYDTCEcG/images/image-33.png?fit=max&auto=format&n=3PsYzlCMwYDTCEcG&q=85&s=387f159dcd5101d4d243a4c9454c6cdc" alt="Imagem" width="736" height="542" data-path="images/image-33.png" />
    </Frame>
  </Step>

  <Step title="Mapeie os campos extras">
    Mapeie quaisquer outros campos que você queira enviar. O LanderLab também inclui campos de rastreamento que você pode repassar:

    * LL Lander URL
    * LL Visitor IP
    * LL Visitor User Agent
    * LL Submission Time UTC
    * LL Session Time
    * LL Variant ID

    Os campos que você deixar sem mapeamento não serão enviados ao Pipedrive.
  </Step>

  <Step title="Clique em Continue">
    Clique em **Continue** para avançar para o passo de revisão.
  </Step>
</Steps>

### Revisar e conectar

<Steps>
  <Step title="Revise o mapeamento">
    O último passo mostra tudo o que será enviado ao Pipedrive para cada lead, incluindo cada campo mapeado. Revise com atenção. Se algo parecer errado, clique em **Back** para fazer alterações.
  </Step>

  <Step title="Clique em Connect Pipedrive">
    Clique em **Connect Pipedrive** para salvar e ativar a integração. A partir de agora, cada lead enviado nesta landing page será enviado ao Pipedrive em tempo real como uma pessoa, com um lead aberto para ela.
  </Step>
</Steps>

## Dicas para a integração com o Pipedrive

* **O Name é obrigatório** - O Pipedrive não consegue criar uma pessoa sem um Name. Sempre mapeie um campo para Name antes de conectar.
* **Reutilize a sua conta** - Como o Pipedrive fica salvo globalmente, você só informa o API token uma vez. Conecte a mesma conta a outras landing pages com poucos cliques.
* **Repasse dados de rastreamento** - Mapeie campos como LL Lander URL e LL Variant ID para saber de qual página e de qual variante veio cada lead.
* **Teste com um envio real** - Depois de conectar, envie um lead de teste e confirme se a pessoa e o lead aparecem no Pipedrive em poucos segundos.

## Solução de problemas

<AccordionGroup>
  <Accordion title="Estou vendo a mensagem 'Map a field to Name so Pipedrive can create the person'">
    O Pipedrive exige um Name para criar um registro. Volte ao passo de mapeamento de campos, mapeie um dos campos do seu formulário para o campo **Name** e continue.
  </Accordion>

  <Accordion title="Os leads não estão aparecendo no Pipedrive">
    Confirme se a integração está ativa na sua landing page e se o **Name** está mapeado. Verifique também se o seu API token continua válido no Pipedrive, pois gerar um novo token invalida o antigo.
  </Accordion>

  <Accordion title="O meu API token não é aceito">
    Verifique se você copiou o **personal API token** completo em **Company settings > Personal preferences > API**. Se você o gerou novamente há pouco tempo no Pipedrive, atualize o token no LanderLab para que eles correspondam.
  </Accordion>

  <Accordion title="Não consigo encontrar a aba API no Pipedrive">
    A sua função de usuário não tem acesso à API. Peça ao administrador do seu Pipedrive que ative o acesso à API para o seu conjunto de permissões e depois copie o token novamente.
  </Accordion>
</AccordionGroup>