Tema
Extensão Pipedrive
Com a extensão Pipedrive conectada, as automações do Columba alimentam o seu CRM enquanto a conversa acontece: localizam a pessoa pelo telefone, criam o negócio no funil certo, anotam o resumo do WhatsApp e agendam a atividade do vendedor — sem duplicar o que já existe. E o caminho inverso também funciona: um negócio ganho, perdido ou movido de etapa no Pipedrive pode iniciar um fluxo aqui.
O Pipedrive continua sendo a fonte da verdade da sua equipe comercial. O Columba entra como a porta de entrada no WhatsApp.
Antes de começar
- Plano do Columba: Profissional ou superior (veja Planos e limites).
- Plano do Pipedrive: qualquer plano tem acesso à API e a webhooks, então a extensão funciona em todos. As automações internas do Pipedrive (por exemplo, "negócio criado → criar atividade") existem a partir do plano Growth; se você estiver no Lite, use o nó Atividade no Pipedrive para o mesmo efeito.
- Um usuário do Pipedrive para a integração: o token pertence a um usuário. Notas e atividades criadas pelo Columba aparecem em nome desse usuário, e a extensão só enxerga o que ele enxerga. Pode ser o próprio vendedor ou um usuário dedicado (que ocupa uma licença).
- Cota de API: o Pipedrive dá a cada conta um orçamento diário de chamadas (30 mil tokens × multiplicador do plano × número de licenças). Um lead novo consome algo em torno de 100 tokens no fluxo completo, então 20 leads por dia gastam cerca de 2 mil dos 30 mil de uma licença Lite. O card da extensão mostra as chamadas do mês.
Onde pegar o token da API
- No Pipedrive, clique na sua foto (canto superior direito) e abra Configurações da empresa.
- Em Preferências pessoais, abra a aba API.
- Copie o token pessoal da API inteiro. Se precisar, gere um novo — o antigo deixa de valer na hora.
Conectar
- No Columba, abra Configuração › Extensões e clique no card Pipedrive.
- Cole o token no campo Token da API e clique em Conectar.
- O Columba valida o token no Pipedrive e mostra a empresa e o usuário conectados.
Se o token for recusado, a tela diz o motivo. Os mais comuns: token copiado pela metade e usuário desativado no Pipedrive.
O que acontece ao conectar
- O token vai para um cofre de segredos e não é exibido de novo.
- O Columba baixa o catálogo do seu Pipedrive: funis e etapas, usuários, tipos de atividade e campos (inclusive os personalizados). É esse catálogo que aparece nos selects dos nós do editor.
- Um webhook chamado Columba é registrado no Pipedrive (Ferramentas e apps › Webhooks) para os eventos de negócio. É ele que faz o gatilho Negócio no Pipedrive funcionar. Não edite nem apague esse webhook por lá; ao desconectar, o Columba o remove.
- Os nós do grupo Pipedrive passam a aparecer na barra lateral do Flow Builder.
Se o catálogo ou o webhook falharem, a extensão fica conectada mesmo assim e o card mostra o que faltou, com um botão para tentar de novo.
Configurações padrão
No card Padrões dos nós, você define o que os nós usam quando o campo correspondente fica vazio:
| Configuração | Para que serve |
|---|---|
| Funil padrão e Etapa de entrada padrão | Onde o nó Negócio no Pipedrive cria o negócio quando o fluxo não escolhe funil e etapa. A etapa precisa pertencer ao funil. |
| Responsável padrão | Usuário do Pipedrive que fica como dono das pessoas e negócios criados pelos nós. Vazio = o dono do token. |
| Casamento de telefone | Tolerante (recomendado): "(51) 99181-8134", "+55 51 99181 8134" e "5191818134" são a mesma pessoa — o Columba ignora formatação, DDI e o nono dígito. Exato: só o número idêntico ao do contato, dígito por dígito. |
As alterações valem a partir da próxima execução dos fluxos.
Testar e atualizar o catálogo
- Testar conexão confere o token agora e atualiza a situação da extensão.
- Atualizar catálogo baixa de novo funis, etapas, usuários, tipos de atividade e campos. Use depois de criar uma etapa ou um campo personalizado no Pipedrive, para ele aparecer nos selects do editor.
Independentemente disso, o Columba confere a conexão uma vez por dia: testa o token e, se o Pipedrive tiver apagado o webhook, registra outro.
Desconectar
Em Configuração › Extensões › Pipedrive, clique em Desconectar e confirme. O Columba remove o webhook no Pipedrive, apaga o token do cofre e limpa as configurações. Nada é apagado no Pipedrive além do webhook.
Os fluxos que usam nós do Pipedrive continuam existindo, mas cada execução sai pela saída Erro desses nós até uma nova conexão. Os vínculos entre contatos e pessoas do Pipedrive são mantidos e voltam a valer quando você reconectar a mesma conta.
Problemas comuns
| Sintoma | O que está acontecendo | O que fazer |
|---|---|---|
| Situação Com erro e um aviso no sino dizendo que o token foi recusado | O token foi regenerado ou o usuário foi desativado no Pipedrive | Gere um token novo e conecte de novo. Até lá, os nós saem pela saída Erro. |
| O gatilho Negócio no Pipedrive parou de disparar | O Pipedrive apaga webhooks que ficam 3 dias sem entrega bem-sucedida (por exemplo, durante uma indisponibilidade) | A verificação diária recria o webhook. Para não esperar, clique em Testar conexão. Confira também em Ferramentas e apps › Webhooks se o webhook Columba está ativo. |
| Uma etapa ou um campo novo não aparece no editor | O catálogo é uma cópia | Clique em Atualizar catálogo. |
| O nó criou uma pessoa que já existia | O telefone no Pipedrive está em um formato que não casa (por exemplo, sem DDD) ou o casamento está em Exato | Deixe o casamento em Tolerante e cadastre telefones com DDD no Pipedrive. |
| Nós falhando com "limite" | O orçamento diário de API da sua conta no Pipedrive acabou | Espere a virada do dia ou compre uma cota adicional no Pipedrive. |
Leia também
- Pipedrive nas automações — os nós e o gatilho, passo a passo
- Visão geral das Extensões
- Funil de vendas do Columba — se você prefere operar o funil aqui dentro