Pipedrive

Esta página é para quem usa Pipedrive e quer o lead do agente entrando no funil sem digitação. Como no HubSpot, é uma integração de mão única: o ChatMade escreve no Pipedrive e nunca lê a sua base.

O que você precisa antes

• Uma conta Pipedrive com permissão de instalar aplicativo.
• Um administrador do ChatMade com a permissão manage_organization.
• Numa instalação própria, as variáveis PIPEDRIVE_CLIENT_ID e PIPEDRIVE_CLIENT_SECRET no .env do backend, com a URL de retorno {BACKEND_URL}/api/v1/crm/pipedrive/callback registrada no aplicativo criado no Developer Hub do Pipedrive.

Bom saber: os escopos não vão na URL de autorização — no Pipedrive eles são declarados no próprio aplicativo, dentro do Developer Hub. Configure lá o que o aplicativo pode fazer.

Você não cola credencial no painel. Não existe formulário de credencial na tela do CRM.

Conectar

1. No painel, vá em Settings → Integrations (“Configurações → Integrações”).
2. Ache o cartão Pipedrive, com a etiqueta CRM e a descrição “Push captured leads into Pipedrive as persons and leads, deduped by email, with the AI summary attached.”
3. Clique em Connect (“Conectar”).
4. Autorize no Pipedrive.
5. Você volta com a confirmação “Pipedrive connected successfully!”.

O cartão passa a mostrar Connected (“Conectado”) e o nome da sua empresa no Pipedrive, mais Manage (“Gerenciar”) e Disconnect (“Desconectar”).

Manage faz apenas um teste de conectividade somente-leitura, que responde com um aviso. Ele não escreve nada no seu Pipedrive.

Apontar o agente para o Pipedrive

1. Main Menu → AI Agents (“Menu principal → Agentes de IA”), abra o agente.
2. Aba Lead Capture (“Captura de leads”), seção When a lead qualifies (“Quando um lead qualifica”).
3. Escolha Pipedrive.
4. Save changes (“Salvar alterações”).

O que é criado no Pipedrive

Quatro chamadas, nesta ordem:

1. Organização — só se o lead tiver informado empresa. O ChatMade procura por nome exato; achando, usa a que existe; não achando, cria. Falhando, a pessoa é criada mesmo assim, só sem vínculo.

2. Pessoa, deduplicada por e-mail exato.

• Não existindo: cria, com nome (ou o e-mail, se não houver nome), e-mail marcado como principal, telefone se houver, e o vínculo com a organização.
• Já existindo: só preenche o que estava em branco. O nome só é escrito se a pessoa não tinha nome; o telefone só se ela não tinha telefone; a organização só se não estivesse vinculada. Nada preenchido é sobrescrito.

3. Lead, com o título {nome ou e-mail} — ChatterMate lead, ligado à pessoa e à organização quando houver.

Antes de criar, o ChatMade verifica se aquela pessoa já tem algum lead aberto. Se tiver, não cria um segundo — capturas repetidas não enchem a sua caixa de leads.

4. Nota no lead, com o mesmo formato do HubSpot:

Lead captured by ChatterMate
AI summary: {o resumo escrito pela IA}
{Rótulo do seu campo}: {resposta}
Captured on: {link da página onde a conversa aconteceu}

Os campos customizados aparecem pelo rótulo que você escreveu. E-mail, nome, empresa e telefone não se repetem na nota. A nota é melhor esforço: falhando, o resto continua valendo.

Bom saber: o link View in CRM ↗ que aparece na ficha da pessoa aponta para a Pessoa no Pipedrive, não para o Lead.

Envio numa direção só

O ChatMade tem exatamente cinco operações com o Pipedrive: gerar a URL de autorização, trocar o código por token, renovar o token, enviar o lead e revogar o token. Mais o teste de conectividade, que é leitura.

Não existe importar, listar, sincronizar de volta ou apagar. As únicas leituras são a checagem de identidade e as buscas de deduplicação feitas imediatamente antes de gravar. Do envio, ficam guardados só o id da pessoa, o id do lead e o link do registro.

E, diferente do HubSpot, o Pipedrive aqui é estritamente preenchedor de lacunas: o código diz literalmente “Only fill fields the existing person is missing — never clobber.” Se você quer a garantia de que nenhum dado já existente será alterado, este é o comportamento.

A renovação de token, e por que ela importa

O Pipedrive tem uma particularidade: o token de renovação morre 60 dias depois do último uso — é uma janela deslizante, e cada renovação reinicia a contagem.

Por causa disso, o worker de CRM roda uma varredura própria a cada 6 horas, renovando qualquer conexão Pipedrive ativa que não seja renovada há mais de 24 horas. Na prática, uma conta parada tem cerca de 59 varreduras falhas de folga antes de a janela de 60 dias realmente vencer.

O token de acesso dura o que o Pipedrive disser, com 1 hora como padrão, e é renovado quando faltam menos de 120 segundos.

Bom saber: você não precisa fazer nada para isso funcionar — desde que o serviço crm_sync esteja no ar. Se você desligou esse container para economizar recurso, a renovação para junto, e sua conexão vai expirar em 60 dias de silêncio.

Enviar uma pessoa à mão

Em Main Menu → People (“Menu principal → Pessoas”), abra a ficha da pessoa. No topo:

Situação	O que a ficha mostra	Botão
Nenhum CRM conectado	No CRM connected.	Connect (“Conectar”)
Conectado, nunca enviado	Not synced to Pipedrive yet.	Sync now (“Enviar agora”)
Já enviado	Synced to Pipedrive · {data} e o link View in CRM ↗	Re-sync (“Enviar de novo”)

Sem e-mail, o botão fica desligado: “Add an email first — CRM sync dedupes by email”. Cliques repetidos dentro de 10 segundos são ignorados.

O envio manual vai para todos os CRMs conectados, não só para o que o agente escolheu.

A fila de envio

Igual à do HubSpot: worker próprio (o serviço crm_sync), um trabalho por lead e por CRM, lido a cada 10 segundos em lotes de até 20. Os trabalhos de uma mesma organização vão em série, para não estourar limite de requisição — um envio ao Pipedrive são quatro chamadas seguidas, bem abaixo do teto de 10 requisições por 2 segundos.

Estados: pendente, processando, concluído, falhou, pulado. Falha transitória repete até 7 vezes, com espera dobrando de 60 segundos até 1 hora. Erro 429 respeita o Retry-After. Erro 4xx que não seja 401 nem 429 é permanente.

O cartão da integração mostra “⚠️ N leads failed to sync in the last 7 days” quando há falhas.

Quando a conexão morre

Três estados: ativo, expirado e revogado.

Atenção: na tela, expirado e revogado mostram o mesmo aviso: “⚠️ Connection expired — reconnect to resume lead sync.” Se você desinstalou o aplicativo pelo lado do Pipedrive, vai ler “expirada” mesmo assim.

Reconectando, os envios que tinham falhado em definitivo voltam para a fila.

Desconectar

Botão Disconnect (“Desconectar”). A confirmação lista: para de enviar leads (cancelando o que está na fila), revoga os tokens, e mantém a escolha de CRM nos agentes — inativa até você reconectar.

Desinstalando pelo lado do Pipedrive, um webhook de entrada avisa o ChatMade e a conexão é marcada como revogada.

Próximo passo

Volte para Captura de leads e ajuste os campos que o agente coleta — é o que determina a qualidade do que chega no seu funil.