Integração com BigDataCorp (via ação automática)

Página inicial BigDataCorp com mulher em blazer azul e texto 'A datatech mais revolucionária do país'

A BigDataCorp é a maior datatech da América Latina, especializada na captura, organização e fornecimento de dados públicos em larga escala. Fundada em 2013, a empresa oferece plataformas e soluções que permitem o acesso a informações atualizadas sobre pessoas, empresas, produtos e muito mais, sempre em conformidade com a Lei Geral de Proteção de Dados (LGPD).

Entre seus principais produtos estão o BigID (validação de identidade), o BigMarket (pesquisa de mercado) e o BigLead (prospecção comercial). A BigDataCorp tem como compromisso a segurança, a inovação e a ética no tratamento de dados, apoiando empresas a tomar decisões mais assertivas e estratégicas.

Através da integração via ação automática é possível coletar os dados de score de risco de crédito de uma empresa ou pessoa e preencher estas informações em campos customizados do CRM de Vendas PipeRun.


REQUISITOS

  • Conta ativa no BigDataCop;

  • Ter contratado os Datasets das APIs de Marketplaces;

  • Conta ativa no PipeRun.


TÓPICOS DO ARTIGO

  1. Como criar o token para integração

  2. Como ativar os Datasets para integração

  3. Como configurar a ação automática


COMO CRIAR O TOKEN PARA INTEGRAÇÃO

1. Acesse o painel do BigDataCorp e faça login na sua conta.

Tela de login do BigDataCorp Center com campos para email e senha

2. No menu à esquerda da tela clique em "Gestão" (1) e, a seguir, em "Gestão de tokens" (2).

Menu de Gestão destacando a opção 'Gestão de tokens' para acessar configurações de tokens do sistema

3. Clique e copie o token que está na tela (1) ou clique em "+ Novo Token"(2) para gerar um novo.

Tela de Gestão de tokens com tabela listando Token ID, data de criação, expiração e opção para desabilitar

Para gerar um novo token selecione a duração de 8760 (1 ano) (1) e clique em "Gerar token" (2).

Formulário 'Gerar novo token' com opção de 8.760 horas selecionada e botão 'Gerar token' destacado

Atenção! O Token gerado tem validade máxima de 1 ano, após este período a integração irá parar de funcionar e será necessário criar um novo token.

Pronto! Você já tem o token que será necessário para realizar as configurações da ação automática no Piperun.


COMO ATIVAR OS DATASETS PARA INTEGRAÇÃO

1. Acesse o painel do BigDataCorp e faça login na sua conta.

2. No menu à esquerda da tela clique em "Plataforma" (1) e, a seguir, em "Configurações da plataforma" (2).

Menu Plataforma com opção Configurações da Plataforma destacada e card BigID mostrando consumo atual de R$ 0,00

3. Clique o ícone do lápis ao lado do usuário para o qual deseja habilitar a integração.

Interface de edição de datasets por usuário com ícone de lápis destacado em vermelho para selecionar usuário


Dica: o usuário deve ser o mesmo para o qual foi criado o token de integração.

4. Clique em "Pessoas" (1) e habilite os datasets marcando a caixa de seleção (2), conforme o exemplo abaixo.

Interface de edição de datasets mostrando aba 'Pessoas' com datasets de Biografia de Vida selecionados

Recomendamos que você selecione todas as opções disponíveis.

5. Para confirmar a alteração clique em "Salvar alterações".

Tela de Edição de Datasets mostrando seleção de datasets do Pessoas com múltiplas opções marcadas e botão Salvar alterações destacado

6. Clique em "Empresas" (1) e habilite os datasets marcando a caixa de seleção (2), conforme o exemplo abaixo.

Tela de edição de datasets do usuário com aba Empresas selecionada e lista de datasets marcados com checkboxes habilitados

7. Para confirmar a alteração clique em "Salvar alterações".

Tela de edição de datasets do usuário com seleção de acesso a múltiplos conjuntos de dados empresariais e botão Salvar alterações destacado

8. Clique em "Marketplace" (1) e habilite os datasets marcando a caixa de seleção para pessoas (2) e empresas (3).

Tela de edição de datasets com abas Pessoas, Empresas, Veículos, Endereços, Processos Judiciais, Produtos, Ondemand e Marketplace destacada em vermelho

Atenção! Os Datasets das APIs de Marketplaces não estão sujeitos a gratuidade, recomendamos que você entre em contato com o suporte da BigDataCorp para obter informações sobre quais os datasets deve ativar para integrar o score de risco de crédito de empresas e pessoas.

9. Para confirmar a alteração clique em "Salvar alterações".

Tela de edição de datasets da pessoa com opções de score de risco de fraude e modelos de probabilidade selecionados

Pronto! Os datasets das APIs de integração foram configurados.


COMO CONFIGURAR A AÇÃO AUTOMÁTICA

1. Posicione o mouse sobre o avatar da conta, localizado no canto superior direito da tela, e clique em "Ajustes e Configurações".

Menu de conta Academy PipeRun com opção 'Ajustes e configurações' destacada em vermelho

2. A seguir, clique em "Ações automáticas", na coluna Ferramentas

Menu de contatos com seta indicando 'Ações automáticas' na coluna Ferramentas

3. Nesta tela, serão listadas todas as Ações Automáticas cadastradas na conta. Para configurar uma nova Ação Automática clique em "+ Adicionar ação". 

Tela de Ações Automáticas com lista de automações cadastradas e botão Adicionar ação em destaque

Confira também nossos artigos sobre como editar ações automáticas e como habilitar ou desabilitar ações automáticas.

4. Nesta primeira etapa será necessário configurar o gatilho que irá disparar a ação bem como o tipo de ação automática que será executada.

Formulário de configuração de ação automática com campos para nome, gatilho, tipo de ação, prioridade, agendamento e tempo de envio

Preencha os campos disponíveis com os seguintes dados:

1.1. Nome da ação automática: para que seja fácil identificar esta Ação Automática na listagem;

1.2. Qual será o gatilho para ocorrer a ação?: informe qual o gatilho deve ser acionado para que a ação seja executada;

Para saber mais sobre sobre gatilhos acesse este artigo.

1.3. Qual o tipo de ação que deseja realizar?: escolha a opção "Webhook - Envio de oportunidade para URL";

1.4. Defina a prioridade da execução da ação: informe a prioridade que a Ação Automática terá para ser enviada para a fila de execução;

A prioridade se aplica somente à Ações Automáticas configuradas para serem disparadas na mesma Etapa e com o mesmo gatilho. Para saber mais, acesse este artigo.

1.5. Agendar execução da ação (Opcional): defina uma faixa de dia e horário para executar a ação. Caso a ação seja acionada fora dessa faixa, ela será automaticamente agendada para o próximo dia e horário disponível;

1.6. Quanto tempo após o gatilho a ação será enviada para fila de execução? (Opcional): defina o intervalo de tempo entre o momento em que o gatilho é disparado e a ação é enviada para a fila para ser executada (por exemplo, 5 minutos após a oportunidade entrar na etapa).

Dica: os tempos de espera variam entre "Imediatamente", quando a ação é enviada para execução no momento em que o gatilho é disparado, sem atraso, ou um tempo "Personalizado", onde é possível definir um período de espera em minutos, horas ou dias, com limite máximo de 7 dias de espera.

Campo de configuração de atraso personalizado para ação de gatilho, com entrada de 5 minutos e aviso de limite máximo de 7 dias

5. Na segunda etapa das configurações será necessário definir quais as condições das oportunidades para que a ação seja disparada.

Formulário de configuração de gatilho com campos para nível, etapa, status, origem, tags, segmento e horário de ativação

2.1. Neste Funil (obrigatório): informe em qual funil a Ação Automática poderá ser realizada;

2.2. Nesta etapa do funil (obrigatório): selecione em qual etapa a Ação Automática deve ser executada;

 2.3. Com este status e situação (obrigatório):  selecione o Status e Situação que a Oportunidade poderá estar para executar essa Ação;

2.4. Origem das oportunidades: defina a origem das oportunidades para que a ação seja executada;

2.5. Tags das oportunidades, empresas e pessoas: selecione quais tags devem ser atribuídas às oportunidades, empresas ou pessoas para que a ação seja executada;

2.6. Segmento das empresas: informe qual o segmento a empresa deve estar vinculada para que ação seja executada;

2.7. Neste horário de ativação do gatilho (Opcional): se esta opção estiver ativada, o gatilho só será acionado dentro das faixas de horários indicados. Será necessário configurar as faixas de horários para execução.

Para saber mais sobre a personalização de dia e horário para a execução de Ações Automáticas, acesse este artigo.

Para mais detalhes sobre a primeira parte de configuração das Ações Automáticas, acesse este artigo.

Clique em "Próximo" para seguir para as configurações específicas da ação.

Formulário de configuração do gatilho com campos para seleção de funil, etapa, status, origem e tags, com botão Próximo em destaque

6. Em "Tipo de envio" (1), selecione como "Avançado", e em "Templates disponíveis" (2) selecione "Avaliação de risco de crédito (BigDataCorp)".

Configuração de webhook mostrando seleção de tipo de envio 'Avançado' e template 'Avaliação de risco de crédito (BigDataCorp)'

Os campos header e valor não precisam ser preenchidos.

8. Na área "JSON Disponível" você poderá visualizar a estrutura padrão do JSON enviado via ação automática.

Configuração avançada de saída de dados JSON com campos de token, CRM e score customizados

9. Já na área central da tela, configure a expressão de saída desejada, seguindo esta estrutura:

{
  "bigDataCorp_token": 'TOKEN_BIG_DATA_CORP', // informe o token de integração gerado pelo BigDataCorp
  "crm_token": 'TOKEN_CRM', // informe o token de integração do CRM PipeRun
  "deal_id": "id", // ID da oportunidade
  "empresa_credito_score_custom_field_id": 'ID_CAMPO',  // informe o ID do campo customizado que receberá o score de crédito da empresa
  "empresa_credito_score_data_custom_field_id": 'ID_CAMPO', // informe o ID do campo customizado que irá receber a data da análise de crédito
  "pessoa_credito_score_custom_field_id": 'ID_CAMPO', // informe o ID do campo customizado do cadastro de pessoas que vai receber o score de crédito
  "pessoa_credito_score_data_custom_field_id": 'ID_CAMPO' //informe o ID do campo customizado do cadastro de pessoas que irá receber a data da análise de crédito
}

Para saber como gerar o token no BigDataCorp retorne ao tópico Como criar o token para integração.

Para saber como gerar o token de integração do CRM PipeRun consulte este artigo.

Para saber como criar campos customizados no PipeRun acesse este artigo.

O campo "deal_id" não precisa ser alterado, pois ele será preenchido de forma automática com o ID da oportunidade que conterá as informações da análise de risco de crédito.

10. Agora, confira a pré-visualização da formatação do JSON de saída, na área direita da tela.

Configuração de formatação JSON avançada com preview de saída de dados de crédito e tokens

12. Para realizar um teste de envio de dados, basta clicar no botão "Envio de teste", localizado no canto inferior esquerdo da tela.

Tela JSON com dados de empresa e botão 'Envio de teste' destacado em vermelho no canto inferior esquerdo

13. Por fim, após finalizar as configurações de saída da ação automática, não esqueça de clicar no botão "Salvar", localizado no canto inferior direito da tela, para registrar a ação.

Tela de configuração avançada de formatação JSON com campos de entrada, legenda e preview, botões Enviar teste, Voltar e Salvar

Dica: é possível ativar os logs temporários da ação automática para acompanhá-la. Para isto, clique nos logs na listagem de ações automáticas e, após em "Logs temporários". Os logs serão mantidos por 24 horas (após esse período, serão excluídos).

Tela de Logs de Ação Automática BigDataCorp com filtros por data e status, mostrando zero resultados

14. Quando o gatilho configurado disparar a ação automática, os campos customizados serão automaticamente preenchidos com dados que descrevem o histórico de crédito da pessoa ou empresa. O sistema devolve uma pontuação numérica que vai de 300 a 1000: valores próximos de 300 indicam alto risco de inadimplência, enquanto pontuações próximas de 1000 sinalizam baixo risco.

Tabela de classificação de risco de crédito por faixa de score: 300-600 alto, 601-800 médio, 801-1000 baixo

15. Nas notas da oportunidade serão registradas as informações referentes ao score de crédito da empresa e ou pessoa associadas à oportunidade.

Pronto! A ação automática foi configurada e o score de risco será atualizado nos campos customizados.


Em caso de dúvidas, chame nossa equipe no chat. 😉