Pipedrive nas automações

Com a extensão Pipedrive conectada, a barra lateral do editor ganha o grupo Pipedrive, com seis nós, e o grupo Gatilhos ganha o gatilho Negócio no Pipedrive. Sem a extensão, nada disso aparece.

Todos os nós agem sobre a pessoa do contato da conversa: o Columba a localiza pelo telefone (tolerante a formatação), guarda o vínculo e, nos nós seguintes e nas próximas conversas, não repete a busca. Nenhum nó derruba o atendimento: qualquer falha sai pela saída Erro, com o motivo em {{flow.pipedrive_error}}.

Conecte a saída Erro

Em fluxos onde o CRM importa (lead novo, orçamento), ligue a saída Erro a um Notificar Equipe. Sem isso, um token revogado ou uma pessoa sem telefone passariam em silêncio e o lead ficaria fora do Pipedrive.

Gatilho: Negócio no Pipedrive

Dispara quando um negócio é criado, muda de etapa, é ganho, perdido, reaberto ou troca de responsável no Pipedrive. O contato é resolvido pela pessoa do negócio (pelo vínculo já gravado ou pelo telefone dela) e o fluxo começa com os dados do evento em {{pipedrive.*}}.

Quando usar: o vendedor marca o negócio como ganho e você quer a mensagem de boas-vindas no WhatsApp; o negócio entra em "Proposta enviada" e o Columba agenda o lembrete; o negócio é perdido e a tag do contato muda.

Configuração:

Campo	O que é
Eventos	Quais mudanças disparam: negócio criado, mudou de etapa, ganho, perdido, reaberto, trocou de responsável ou qualquer alteração. Nenhum marcado = só mudança de etapa.
Funil do Pipedrive	Só negócios deste funil. Vazio = todos.
Etapa de destino	Só quando o negócio estiver nesta etapa. Vazio = qualquer.
Canal	WhatsApp: abre (ou reaproveita) a conversa e o fluxo fala com o contato. Sem canal: roda só ações internas (tags, ficha, funil do Columba, tickets, avisos), sem conversa.
Número de WhatsApp	Com canal WhatsApp, por qual número a conversa nasce. Vazio = primeiro número público conectado.
Criar contato	Cria o contato no Columba quando a pessoa do negócio ainda não existe aqui, pelo telefone dela. Desligado, o evento só roda para contatos já cadastrados.
Tags do contato	Aplicadas ao contato criado.
Se este contato já estiver em um fluxo	Reiniciar (padrão) interrompe o fluxo atual daquela conversa; Ignorar mantém o que estava rodando e só registra o evento.

Regras: o negócio precisa ter uma pessoa com telefone no Pipedrive; sem isso o evento fica registrado no painel do gatilho ("último evento") e o fluxo não roda. Conversa em atendimento humano nunca é interrompida. Um evento que o Pipedrive reenviar é ignorado.

Variáveis: {{pipedrive.event}} (created, stage_changed, won, lost, reopened, owner_changed ou updated), {{pipedrive.deal.title}}, {{pipedrive.deal.value}}, {{pipedrive.deal.stage_id}}, {{pipedrive.deal.status}}, {{pipedrive.deal.url}}, {{pipedrive.previous.stage_id}} (o que mudou), {{pipedrive.person.name}}, {{pipedrive.person.phone}}, {{pipedrive.person.email}} e {{pipedrive.person.url}}.

Localizar no Pipedrive

Procura a pessoa do contato no Pipedrive pelo telefone e, se achar, carrega o negócio aberto mais recente dela. É o primeiro nó da maioria dos fluxos com Pipedrive: ele decide se o contato é lead novo ou cliente em acompanhamento.

Configuração:

• Buscar também pelo e-mail — se o telefone não achar, tenta pelo e-mail do contato.
• Carregar negócio aberto — grava o negócio aberto mais recente em {{flow.pipedrive_deal_*}} (ligado por padrão).

Saídas: Encontrado, Não encontrado e Erro.

Variáveis: {{flow.pipedrive_person_id}}, {{flow.pipedrive_person_name}}, {{flow.pipedrive_person_url}} e, com negócio aberto, {{flow.pipedrive_deal_id}}, {{flow.pipedrive_deal_title}}, {{flow.pipedrive_deal_stage_id}}, {{flow.pipedrive_deal_url}} e {{flow.pipedrive_open_deals}} (quantidade). Sem negócio aberto, {{flow.pipedrive_deal_id}} fica vazio — dá para testar com uma Condição.

Pessoa no Pipedrive

Cria a pessoa no Pipedrive ou atualiza a existente, sem duplicar. Na pessoa encontrada, acrescenta o telefone e o e-mail que faltam e grava os campos informados; na pessoa nova, usa o nome e o telefone do contato.

Configuração:

• Nome — vazio = nome do contato. Aceita variáveis.
• E-mail — vazio = e-mail do contato.
• Responsável — usuário do Pipedrive dono da pessoa criada. Vazio = padrão da extensão.
• Campos da pessoa — pares campo/valor; escolha o campo pelo nome (inclusive personalizados) e informe o valor com variáveis, por exemplo {{flow.cidade}}.
• Atualizar se já existir — desligado, a pessoa encontrada fica como está.
• Buscar também pelo e-mail — antes de criar, tenta achar pelo e-mail.

Saídas: Sucesso e Erro.

Variáveis: {{flow.pipedrive_person_id}}, {{flow.pipedrive_person_url}} e {{flow.pipedrive_person_created}} (true quando criou).

Negócio no Pipedrive

Cria um negócio para a pessoa do contato no funil e na etapa escolhidos. Se a pessoa ainda não existe no Pipedrive, o nó a cria (nome e telefone do contato). Se ela já tem um negócio aberto, o nó não cria outro: sai por Já existia com os dados dele — é o que evita o negócio duplicado quando o cliente escreve de novo.

Configuração:

• Título — vazio = nome do contato + "WhatsApp". Aceita variáveis.
• Funil e Etapa de entrada — vazios = padrões da extensão (ou a primeira etapa do funil).
• Responsável — usuário do Pipedrive. Vazio = padrão da extensão.
• Valor — em reais (1.500,00 ou {{flow.valor}}).
• Previsão de fechamento — data AAAA-MM-DD ou variável.
• Campos do negócio — pares campo/valor, como no nó anterior. Campos numéricos, monetários e de opção são convertidos para o formato do Pipedrive (numa opção, pode informar o rótulo).
• Se já houver negócio aberto — Reaproveitar o aberto (padrão) ou Criar mesmo assim.
• Criar pessoa se não existir — desligado, sem pessoa o nó sai por Erro.

Saídas: Criado, Já existia e Erro.

Variáveis: {{flow.pipedrive_deal_id}}, {{flow.pipedrive_deal_title}}, {{flow.pipedrive_deal_stage_id}}, {{flow.pipedrive_deal_url}} e {{flow.pipedrive_deal_created}}.

Cliente antigo com evento novo

Quando todos os negócios da pessoa estão ganhos ou perdidos, não há "aberto" para reaproveitar — o nó cria um negócio novo na mesma pessoa. É o comportamento certo para quem volta meses depois com uma compra nova.

Atualizar no Pipedrive

Muda o negócio aberto do contato: etapa, status (ganho, perdido ou reaberto), valor, previsão, responsável, título e campos. O alvo é o negócio em {{flow.pipedrive_deal_id}} (de um nó anterior) ou, sem ele, o negócio aberto mais recente da pessoa.

Configuração:

• Etapa e, se for de outro funil, Funil.
• Status — Manter, Ganho, Perdido ou Reabrir. Ao marcar Perdido, o Motivo da perda (texto livre) é gravado.
• Valor, Previsão de fechamento, Responsável, Título e Campos do negócio — só o que for preenchido é alterado.

Saídas: Sucesso e Erro (também quando não há negócio aberto).

Nota no Pipedrive

Adiciona uma nota ao negócio aberto do contato (ou à pessoa, se não houver negócio). Com um Título único, o nó atualiza a nota que começa com esse título em vez de criar outra a cada execução — é assim que o "Resumo do WhatsApp" fica sempre atual, sem acumular.

Configuração:

• Conteúdo — texto da nota; quebras de linha são preservadas. Aceita variáveis, por exemplo {{flow.last_ai_response}} ou as informações que a IA salvou.
• Onde — Negócio (padrão; cai na pessoa se não houver negócio aberto) ou Pessoa.
• Título único — por exemplo, Resumo do WhatsApp.
• Fixar no negócio — deixa a nota no topo do negócio.

Saídas: Sucesso e Erro. Grava {{flow.pipedrive_note_id}}.

Atividade no Pipedrive

Cria uma atividade (tarefa, ligação, reunião, e-mail ou um tipo criado por você) no negócio aberto do contato ou na pessoa. Com Não duplicar ligado, se já existir uma atividade aberta com o mesmo tipo e assunto, o nó não cria outra — é o que garante um único "Responder cliente" por negócio.

Configuração:

• Assunto — aceita variáveis.
• Tipo — lista dos tipos de atividade do seu Pipedrive.
• Prazo (dias) — vence daqui a N dias (0 = hoje; 1 = amanhã), no fuso da conta. Hora opcional (09:00).
• Responsável — usuário do Pipedrive. Vazio = dono do negócio (ou da pessoa).
• Observações — texto livre.
• Não duplicar — ligado por padrão.
• Onde — Negócio (padrão) ou Pessoa.

Saídas: Sucesso (criada, ou já existia uma aberta igual) e Erro. Grava {{flow.pipedrive_activity_id}} e {{flow.pipedrive_activity_due_date}}.

Variáveis

Variável	Quem grava	Valor
{{flow.pipedrive_person_id}}, {{flow.pipedrive_person_name}}, {{flow.pipedrive_person_url}}	Localizar, Pessoa, Negócio	A pessoa do contato no Pipedrive
{{flow.pipedrive_deal_id}}, {{flow.pipedrive_deal_title}}, {{flow.pipedrive_deal_stage_id}}, {{flow.pipedrive_deal_status}}, {{flow.pipedrive_deal_url}}	Localizar, Negócio, Atualizar	O negócio-alvo
{{flow.pipedrive_open_deals}}	Localizar	Quantos negócios abertos a pessoa tem
{{flow.pipedrive_person_created}}, {{flow.pipedrive_deal_created}}	Pessoa, Negócio	true quando o nó criou (em vez de reaproveitar)
{{flow.pipedrive_note_id}}, {{flow.pipedrive_activity_id}}	Nota, Atividade	Ids gravados
{{flow.pipedrive_error}}	Qualquer nó, na saída Erro	O motivo, em texto
{{pipedrive.event}}, {{pipedrive.deal.*}}, {{pipedrive.previous.*}}, {{pipedrive.person.*}}	Gatilho Negócio no Pipedrive	O evento recebido

Use os links (*_url) em Notificar Equipe ou Avisar no WhatsApp para o vendedor abrir o negócio com um toque.

Exemplos

Lead novo pelo WhatsApp

1. Gatilho Nova Conversa.
2. Localizar no Pipedrive → saída Não encontrado.
3. Resposta IA com as perguntas de qualificação (a IA salva as respostas em variáveis).
4. Pessoa no Pipedrive — nome do contato, e-mail se houver.
5. Negócio no Pipedrive — funil "Vendas", etapa "Novo lead", valor {{flow.valor}}.
6. Nota no Pipedrive — título único Resumo do WhatsApp, conteúdo com o que a IA coletou.
7. Atividade no Pipedrive — tipo Tarefa, assunto "Enviar orçamento", prazo 1 dia.
8. Transferir Humano para a vendedora.

Se o lead escrever de novo antes do orçamento, o passo 2 sai por Encontrado, o passo 5 sai por Já existia e a nota do passo 6 é atualizada, não duplicada.

Cliente em acompanhamento volta a escrever

1. Gatilho Conversa Reaberta (e o mesmo fluxo no gatilho Nova Conversa, se a conta tem mais de um número).
2. Localizar no Pipedrive → Encontrado.
3. Condição: {{flow.pipedrive_deal_id}} não está vazio (há negócio aberto).
4. Atividade no Pipedrive — assunto "Responder cliente", prazo 0 dias, Não duplicar ligado.
5. Transferir Humano para o dono do negócio — sem IA no meio.

Negócio ganho ou perdido no Pipedrive

1. Gatilho Negócio no Pipedrive — eventos Ganho e Perdido, canal Sem canal.
2. Condição: {{pipedrive.event}} é igual a won.
   • Sim → Tag no Contato: adicionar Cliente, remover Em negociação.
   • Não → Tag no Contato: remover Em negociação.

Com canal WhatsApp no gatilho, dá para acrescentar um Enviar Texto de boas-vindas ao cliente que fechou.

Leia também

• Extensão Pipedrive — conectar, configurações padrão e problemas comuns
• Gatilhos
• Integrações
• Referência técnica (JSON)