Pipedrive

O conector Pipedrive lê negócios, pessoas, organizações, atividades, notas, funis, etapas, usuários e os dicionários de campos de uma conta Pipedrive, e grava com cada registro quem pode vê-lo segundo a visibilidade definida no Pipedrive.

​

Capacidades

• Traz ao Data Catalog os registros do CRM: negócios, pessoas, organizações e atividades, com funis, etapas e usuários da conta.
• Traduz os campos customizados. Os valores de deals, persons e organizations viram tabelas em formato longo, uma linha por campo, com o nome do campo e o rótulo da opção resolvidos pelos dicionários de campos.
• Envia o texto de cada nota ao Knowledge como documento, com a mesma permissão da linha da nota.
• Alimenta o Memory pelo fragmento de ontologia do conector: negócios, pessoas, organizações, usuários, atividades, funis e etapas viram nós. Pessoas se unem a contatos de outros CRMs pelo e-mail ou telefone, e organizações pelo domínio do site. Os nós só entram no grafo depois que a ontologia unificada é aplicada.
• Calcula a permissão de cada registro a partir do campo de visibilidade do Pipedrive e do plano da conta (ver Permissões).

​

Recursos disponíveis

No Data Catalog, notes nasce ligado e os demais recursos nascem desligados. Você escolhe quais carregar depois de conectar. deal_fields, person_fields e organization_fields não têm switch no Data Catalog. Cada um é carregado junto com a entidade que descreve: deal_fields com deals, person_fields com persons e organization_fields com organizations. Sem eles, as tabelas de campos customizados não seriam construídas.

​

Permissões (ACL)

O conector lê a permissão de cada item na fonte e a guarda junto com o dado. Em Comportamento dos dados, você escolhe entre dois modos: No modo “Espelhar a fonte”, a Strattum reconhece cada pessoa pelo e-mail que ela tem no Pipedrive. O conector grava esse e-mail como uma identidade do Pipedrive, ligada a esta conexão. O Pipedrive não tem a opção Exigir login na fonte como prova de identidade. No passo de acesso do assistente de criação, o Comportamento dos dados começa em “Aberto”.

​

Como a fonte define acesso

No Pipedrive, negócios, pessoas e organizações têm um dono e um nível de visibilidade (visible_to). O significado do nível depende do plano da conta. Os grupos de visibilidade são os papéis (roles) da conta, que podem ter subgrupos. Atividades e notas não têm visibilidade própria. Funis, etapas, usuários e campos são visíveis para qualquer usuário da conta.

​

Como a Strattum traduz o acesso

Para negócios, pessoas e organizações, quem recebe acesso depende do visible_to e do plano. Os administradores ativos da conta entram em todos os registros. Uma atividade ou nota recebe os leitores de um registro pai, o autor e os administradores. O pai é o negócio, se houver. Senão, a pessoa, e por último a organização. Funis, etapas, usuários e os três dicionários de campos recebem acesso para todos que podem usar o conector. O plano vem do campo Plano do Pipedrive do Console. O conector também lê as opções de visibilidade da conta: se elas incluem 5 ou 7, a conta é tratada como Premium / Ultimate, mesmo que o campo diga Lite / Growth. Se as opções não puderem ser lidas, vale Premium / Ultimate, a leitura mais restrita. Todo erro de leitura reduz o acesso, nunca o amplia. Se os grupos não puderem ser lidos, os níveis 3 e 5 caem para dono e administradores. Se o pai de uma nota ou atividade foi apagado ou não respondeu, ela fica com autor e administradores. O Pipedrive libera alguns negócios para seguidores (followers). O conector não lê seguidores, então um seguidor só vê o negócio se outra regra da tabela o incluir.

​

Quando a identidade não é encontrada

• Usuário inativo ou apagado no Pipedrive não recebe acesso.
• Usuário sem e-mail no Pipedrive não recebe acesso, e a execução registra quantos ficaram de fora.
• Um registro sem nenhum leitor resolvido fica invisível no modo “Espelhar a fonte”. Uma nota nessa situação não é publicada no Knowledge.

​

Quando a permissão é atualizada

A permissão é calculada em todo sync, junto com o dado. Mudar um usuário de grupo, promovê-lo a administrador ou desativá-lo não altera os registros, então o conector compara a cada execução os usuários, os grupos e o plano com os da última execução completa. Se algo mudou, os recursos com permissão rodam em full refresh naquela execução e todos os registros são regravados com a permissão nova. Atividades e notas rodam sempre em full refresh. Quando uma delas está ligada, deals, persons e organizations também rodam em full refresh, para que uma mudança de visibilidade no pai chegue aos filhos na mesma execução.

​

Pré-requisitos

• Uma conta Pipedrive em qualquer plano.
• Um usuário Admin da conta para gerar o token. O token de um usuário comum limita a sincronização ao que ele vê, e o teste de conexão recusa esse token.
• Saber o plano da conta (Lite / Growth ou Premium / Ultimate), que muda o significado da visibilidade.
• Uma só conexão Pipedrive por instalação da Strattum.

​

Autenticação e escopos

A autenticação usa o token de API pessoal do usuário Admin, enviado no cabeçalho x-api-token. O token pessoal não tem escopos: ele herda o acesso do usuário que o gerou. Se o usuário dono do token for desativado, o conector para de sincronizar.

​

Configuração no Console

​

Como a sincronização funciona

A frequência vem do passo Sincronização. A referência do conector é uma execução a cada 6 horas. Ordem. Em cada execução, o conector lê primeiro os usuários e os grupos de visibilidade, depois funis, etapas e dicionários de campos, depois negócios, pessoas e organizações, e por último atividades e notas. Recurso desligado no Data Catalog não é gravado. Paginação. O conector pede 500 itens por página. As listagens da API v2 avançam por cursor, e users e notes (API v1) avançam por deslocamento. Full refresh (padrão). A tabela do recurso é reescrita a cada execução, e um registro apagado no Pipedrive some dela. Incremental. Só deals, persons e organizations aceitam. A execução pede ao Pipedrive o que mudou desde o último update_time visto, menos 10 minutos de margem, e mescla o resultado pelo id. O incremental só vale com activities e notes desligados, e uma mudança de usuários ou grupos força um full refresh. Remoção. Em incremental, um registro apagado no Pipedrive continua na Strattum até o próximo full refresh. Se o Pipedrive indicar mais páginas sem dizer onde continuar, a execução mescla o que leu em vez de reescrever a tabela, e o cursor não avança. Notas no Knowledge. Cada nota vira um documento com o título Nota <id>. Uma execução que leu todas as notas sem falha reconcilia o Knowledge, e notas apagadas no Pipedrive saem do índice. Se uma página de notas falhar, as notas lidas até ali são publicadas e nada é removido.

​

API da fonte

Rate limits. O Pipedrive dá a cada conta um orçamento diário de 30.000 tokens, multiplicado pelo plano (Lite 1, Growth 2, Premium 5, Ultimate 7) e pelo número de assentos. Há também um limite por janela de 2 segundos: com token de API, 20 requisições no Lite, 40 no Growth, 100 no Premium e 120 no Ultimate. Esgotado o limite, o Pipedrive responde 429, e responde 403 quando bloqueia tráfego abusivo. O conector desacelera quando restam menos de 10% das requisições da janela. Diante de um 429, espera o tempo informado pelo Pipedrive, no máximo 60 segundos, e tenta de novo até 5 vezes. Depois disso, a execução falha, o que acontece quando o orçamento diário acabou. Um 403 encerra a execução sem nova tentativa. Erros 5xx e conexões interrompidas têm até 5 tentativas com recuo crescente. Referência oficial: Pipedrive, limites de requisição

​

Limitações conhecidas

• No modo “Espelhar a fonte”, negócios, pessoas, organizações, atividades e notas ainda não aparecem para nenhum usuário. A plataforma ainda não associa as identidades gravadas pelo Pipedrive às contas da Strattum. Para liberar o conteúdo agora, use “Aberto” e limite o acesso em Quem pode usar este conector.
• O Pipedrive não permite vincular a conta de cada usuário: a identidade é o e-mail do usuário no Pipedrive.
• Seguidores (followers) e a lista de usuários com permissão de um negócio não são lidos. Um seguidor pode ver no Pipedrive um negócio que não vê na Strattum.
• Os conjuntos de permissões do Pipedrive, como “ver atividades de outros usuários”, não entram no cálculo. Só a visibilidade do registro conta.
• O plano da conta não vem da API. Se o campo Plano do Pipedrive estiver errado numa conta Lite / Growth, registros visíveis para a empresa inteira ficam mais restritos que no Pipedrive.
• Em incremental, um registro apagado no Pipedrive só some no próximo full refresh.
• Produtos, leads, arquivos, e-mails, projetos e metas não são lidos.
• O título do documento de cada nota no Knowledge é Nota <id>, sem o nome do negócio, da pessoa ou da organização.
• Uma conexão Pipedrive por instalação.

​

Troubleshooting

​

Próximos passos