A conexão com o Pipedrive tem dois jeitos, no mesmo card. O principal é Entrar com o Pipedrive: você vai à tela do Pipedrive, vê as permissões do aplicativo da Toca, clica em Allow and install e volta à Toca, sem copiar senha nem chave. O outro é colar o token de API do seu usuário no Pipedrive. Nos dois casos a conexão vale para uma empresa do Pipedrive e age com a permissão do usuário que conectou.
Esta integração está em homologação: a conexão funciona normalmente, mas as consultas no chat ainda estão em validação.
O token de API é pessoal e dá à Toca o mesmo acesso que o seu usuário tem no Pipedrive. Cada usuário tem um token só por empresa: se alguém gerar um token novo, todas as integrações que usam o atual param, inclusive a da Toca, até você colar o novo. Por isso, prefira Entrar com o Pipedrive.
Antes de começar
- Tenha uma conta ativa no Pipedrive. Conta com período de teste vencido ou pagamento pendente faz o Pipedrive recusar as consultas.
- Se você participa de mais de uma empresa no Pipedrive, deixe ativa a que quer conectar antes de começar: a autorização e o token valem só para ela.
- Para a Toca também mexer em funis, etapas, tipos de atividade e campos personalizados, conecte com um usuário administrador da empresa (entrando com o Pipedrive ou com o token dele). Com um usuário comum a conexão funciona, mas essas partes da configuração ficam recusadas pelo Pipedrive.
- A Toca enxerga o que o usuário conectado enxerga. Se as regras de visibilidade da empresa escondem negócios de outros vendedores, eles também ficam fora das respostas.
- Para o token de API:
- No Pipedrive, clique no seu nome no canto superior direito e abra Configurações da empresa → Preferências pessoais → API (ou acesse app.pipedrive.com/settings/api). Copie o token.
- Se a opção API não aparece, o uso de API está desligado para o seu usuário. Um administrador libera em Gerenciar usuários → Conjuntos de permissões, no conjunto em que você está.
Passo a passo
- Acesse
Configurações → Integraçõesna Toca. - Localize o card Pipedrive e clique em Conectar.
- Escolha um caminho:
- Entrar com o Pipedrive (recomendado): clique no botão. Na tela do Pipedrive, entre com a sua conta, se ainda não estiver logado, revise as permissões e clique em Allow and install (Permitir e instalar). Você volta à Toca com o card conectado.
- Token de API: abaixo de “ou use o token de API”, cole o token copiado em Preferências pessoais → API no campo Token de API e clique em Salvar token. A Toca confere o token no Pipedrive antes de salvar e descobre sozinha o endereço da sua empresa.
- O card fica marcado como conectado. Pelo botão Gerenciar do card, o painel mostra em qual empresa a Toca está conectada.
O que a Toca acessa
Com a conexão ativa, a Toca lê os negócios, funis e etapas (valor, status, ganhos e perdidos, previsão de fechamento e o tempo em cada etapa), os leads e as etiquetas de lead, as pessoas e organizações, as atividades e a agenda do time, as notas e comentários, os produtos e os produtos de cada negócio, as metas de vendas e o progresso delas, os filtros salvos, os projetos e tarefas, os arquivos ligados aos registros, os campos personalizados, os usuários e o histórico de alterações.
A Toca também altera: cria, move de etapa, marca como ganho ou perdido, atualiza, mescla e apaga negócios; cria, converte e apaga leads; agenda, conclui e remarca atividades; cria e atualiza pessoas, organizações, produtos, notas, metas, projetos e tarefas; e mexe em funis, etapas e campos personalizados. Toda alteração só acontece mediante sua aprovação explícita, pedido a pedido, dentro do chat, e o pedido de aprovação mostra o horário da atividade no horário de Brasília.
O acesso é o mesmo nos dois jeitos de conectar: o do usuário que conectou. Entrando com o Pipedrive, a tela do Pipedrive mostra as permissões do aplicativo antes de você aceitar; com o token, vale tudo o que o seu usuário pode fazer no Pipedrive.
Ficam de fora o envio de arquivos e fotos, a administração de usuários, papéis e permissões, os webhooks e a caixa de e-mail do Pipedrive: isso continua no painel do Pipedrive.
Manutenção da conexão
Entrando com o Pipedrive, a Toca renova a autorização automaticamente. O Pipedrive encerra a autorização se ela ficar 60 dias sem uso, ou se o aplicativo da Toca for desinstalado no Pipedrive. Nesses casos, abra o card em Configurações → Integrações pelo botão Gerenciar e clique em Reconectar no Pipedrive.
O token de API não vence com o tempo, mas para de valer quando alguém gera um token novo em Preferências pessoais → API. Se isso acontecer, copie o token novo, abra o card pelo botão Gerenciar, cole no campo Token de API e clique em Trocar token. Por segurança, o token salvo aparece mascarado.
Para trocar de jeito: Entrar com o Pipedrive substitui o token salvo, e salvar um token passa a conexão para ele.
As consultas usam a cota diária de API da sua empresa no Pipedrive, a mesma de qualquer outro aplicativo conectado. O Pipedrive avisa os administradores por e-mail quando ela passa de 75%.
Problemas comuns
- A Toca diz que o limite do Pipedrive acabou — a cota diária de API da empresa foi consumida (por ela e pelos outros aplicativos conectados) e só volta à meia-noite do servidor do Pipedrive. O consumo aparece no painel de uso da API (API Usage Dashboard), nas configurações da empresa no Pipedrive.
- O Pipedrive não aceitou o token — copie de novo em Preferências pessoais → API, sem espaço sobrando. Se alguém gerou um token novo, o antigo deixou de valer.
- A conexão pelo token parou de funcionar — o token foi trocado no Pipedrive (por você ou por outra integração). Cole o token novo no card, ou conecte por Entrar com o Pipedrive, que não depende dele.
- Funil, etapa, tipo de atividade ou campo personalizado não muda — essas alterações pedem um usuário administrador. Conecte de novo com um administrador da empresa, entrando com o Pipedrive ou com o token dele.
- Um negócio ou contato não aparece — a Toca enxerga só o que o usuário conectado enxerga no Pipedrive. Ajuste a visibilidade no Pipedrive ou conecte com quem tem acesso.
- Conectou a empresa errada — ative a empresa certa no Pipedrive (ou copie o token dela), use Excluir integração no menu ⋯ do card e conecte de novo.
- Projetos não aparecem — projetos e tarefas dependem do recurso de Projetos ativo na sua conta do Pipedrive. Sem ele, o Pipedrive recusa essas consultas.