A conexão com o Pipedrive fica na tela Integrações, no menu lateral, grupo Conta
(endereço /integracoes), dentro da seção CRM.
Cria ou atualiza a pessoa no Pipedrive, junto da organização e do negócio, usando o token de API da sua conta.
Ao contrário do RD Station e do HubSpot, o Pipedrive é conectado por token de API colado por você — o aplicativo de autorização do Pipedrive exige publicação no marketplace deles, o que não é pré-requisito de uma integração da sua própria conta.
Duas regras valem para todos os CRMs:
- Uma conexão por CRM (um RD Station, um HubSpot, um Pipedrive), valendo para todos os sites da conta. Se você conectar mais de um, o lead qualificado é enviado a todos eles — ao migrar de CRM, desconecte o antigo antes de conectar o novo para não duplicar leads.
- A integração com CRM está disponível nos planos Pro e Full. No plano Grátis o token e o subdomínio nascem desabilitados, com "O plano Grátis não inclui a integração com CRM" e um botão Solicitar upgrade — antes existia o caminho de preencher os dois e ser recusado só no clique.
Só o dono e os administradores da conta conectam integrações.
Conectar
- No Pipedrive, abra Configurações pessoais → API e copie o token.
- No Data Lead, no cartão Pipedrive, cole o valor em Token de API.
- Preencha o Subdomínio da conta: é a parte antes de
.pipedrive.comno endereço que você usa (emhttps://minhaempresa.pipedrive.com, o subdomínio éminhaempresa). - Clique em Conectar. A mensagem de sucesso é Pipedrive conectado.
O token é conferido contra a API do Pipedrive antes de ser salvo — um token errado gravado como "conectado" só seria descoberto no primeiro lead perdido. Se o token pertencer a outra conta, a mensagem é explícita: "Esse token é da conta "outraempresa". Corrija o subdomínio ou cole o token da conta certa."
O token fica guardado cifrado e nunca volta a aparecer na tela. Por isso o campo nasce vazio mesmo com a integração já conectada: trocar o token é sempre colar um novo e clicar em Trocar token.
O que é criado na primeira sincronização
O Pipedrive identifica a pessoa pelo e-mail ou, na falta dele, pelo telefone. Sem nenhum dos dois, o envio é recusado.
| Objeto | Quando é criado |
|---|---|
| Pessoa | Sempre — criada, ou atualizada quando já existe |
| Organização | Só na primeira sincronização, e só se o lead tiver empresa |
| Negócio | Só na primeira sincronização, com o título <nome do lead> — Data Lead |
| Nota | Só na primeira sincronização, com o resumo da conversa, o score e o link |
Como o Pipedrive não tem uma operação de "criar ou atualizar", o Data Lead busca a pessoa por e-mail (ou telefone) com correspondência exata antes de criar — é isso que evita duplicatas. Nas sincronizações seguintes a pessoa é atualizada e nada mais é criado.
Uma falha ao criar a organização, o negócio ou a nota não derruba a pessoa.
Mapeamento de campos
Clique em Editar mapeamento. Os padrões são:
| Campo do Data Lead | Campo no Pipedrive |
|---|---|
| Nome | name |
email |
|
| Telefone | phone |
| CPF | datalead_cpf |
| CNPJ | datalead_cnpj |
| Empresa | org_name |
| Porte | datalead_porte |
| CNAE | datalead_cnae |
| Setor | datalead_setor |
| UF | datalead_uf |
| Score | datalead_score |
| Explicação do score | datalead_explicacao |
| Playbook | datalead_playbook |
| Origem | datalead_origem |
| Mídia | datalead_midia |
| Campanha | datalead_campanha |
| Link da conversa | datalead_conversa |
| Resumo da conversa | datalead_resumo |
Os campos datalead_* são campos customizados: crie-os uma vez no Pipedrive ou reaponte o
mapeamento para campos que você já usa. Deixe em branco para não enviar o campo.
Os três campos extras têm uso direto aqui:
- Dono do registro — id do usuário do Pipedrive que fica como responsável.
- Funil — id do funil onde o negócio deve nascer.
- Etapa — id da etapa inicial do negócio.
Sem funil e etapa, o negócio nasce no funil padrão da sua conta.
Restaurar padrões só preenche a tela; nada muda antes de Salvar mapeamento. Trocar o token não apaga o mapeamento já salvo.
Testar a conexão
Testar envia um lead de verdade, com o mesmo mapeamento do envio automático. Procure por Teste Data Lead no Pipedrive e apague o registro depois. O intervalo mínimo entre dois testes é de 30 segundos.
Erros comuns
| Mensagem na tela | O que significa | O que fazer |
|---|---|---|
| Token recusado pelo Pipedrive. Confira o token e o subdomínio da conta. | O token não passou na verificação | Gerar um token novo em Configurações pessoais → API |
| Esse token é da conta "…". Corrija o subdomínio ou cole o token da conta certa. | Token e subdomínio não combinam | Corrigir um dos dois |
| A conexão expirou. Conecte novamente. | O token deixou de valer | Colar um token novo |
| Faltam dados na configuração. | Lead sem e-mail e sem telefone | Rever o playbook |
| O CRM recusou os dados enviados. Confira o mapeamento dos campos. | Campo apontado não existe | Abrir Editar mapeamento |
| O CRM respondeu num formato que não reconhecemos. Fale com o suporte. | O Pipedrive não devolveu o id da pessoa | Falar com o suporte |
A fila tenta de novo automaticamente só quando o problema é do provedor (limite de chamadas, indisponibilidade ou tempo esgotado): até 14 tentativas, por cerca de 82 horas. Erros de configuração, mapeamento ou autenticação falham já na primeira tentativa e ficam visíveis no cartão.
Desconectar
Desconectar apaga a conexão e o token: "Desconectar o Pipedrive? Os leads qualificados param de ser enviados para lá." Não há como desfazer — para voltar, cole o token novamente.
Veja também
Precisa de ajuda?
Fale com o suporte da Data Stone pelo canal combinado com a sua conta. Tenha à mão o subdomínio da conta do Pipedrive e a mensagem de erro completa (nunca envie o token).