Como enriquecer leads do CRM com a API da DataX usando n8n, Make ou Zapier

Antes de começar

• Uma conta DataX com a chave de API. A consulta de sócios está no teste grátis de 24 horas e nos planos Intermediário e Avançado.
• O CNPJ guardado no CRM, num campo da empresa ou do negócio.
• O CRM conectado à ferramenta de automação (n8n, Make ou Zapier), com permissão para criar contatos.

A requisição, igual nas três ferramentas

Se o CRM guarda o CNPJ com pontos, barra e traço, tire esses caracteres antes de montar a URL. Cada sócio retornado consome 1 requisição do limite diário: uma empresa com 3 sócios consome 3.

No n8n

1. Gatilho. Use o gatilho do seu CRM para empresa ou negócio novo, ou um nó Webhook chamado pelo CRM.
2. Requisição. Adicione um nó HTTP Request com o método POST e a URL abaixo. Em Authentication, escolha Generic Credential Type e depois Header Auth, com o nome api-key e a sua chave como valor.
3. Um item por sócio. Adicione um nó Split Out no campo socios.
4. Gravar no CRM. Adicione o nó do CRM para criar ou atualizar o contato, usando {{ $json.nome }}, {{ $json.emails[0] }} e {{ $json.telefones[0] }}.

https://api.datax.plus/v1/empresas/{{ $json.cnpj.replace(/\D/g, '') }}/socios

Troque $json.cnpj pelo campo onde o seu CRM guarda o CNPJ. O replace deixa só os números.

No Make

1. Gatilho. Use o módulo do seu CRM que observa empresas ou negócios novos.
2. Requisição. Adicione o módulo HTTP › Make a request: método POST, a URL abaixo e, em Headers, o nome api-key com a sua chave. Marque Parse response como Yes para o Make ler o JSON.
3. Um item por sócio. Adicione um Iterator sobre socios.
4. Gravar no CRM. Adicione o módulo do CRM para criar o contato, mapeando nome, e-mail e telefone de cada sócio.

https://api.datax.plus/v1/empresas/{{replace(1.cnpj; "/\D/g"; emptystring)}}/socios

No Zapier

1. Gatilho. Escolha o app do seu CRM com o evento de empresa ou negócio novo.
2. Limpar o CNPJ. Se o CNPJ vier formatado, use um passo de Formatter by Zapier ou Code by Zapier para deixar só os números.
3. Requisição. Adicione Webhooks by Zapier › Custom Request: método POST, a URL com o CNPJ mapeado no lugar de {cnpj} e, em Headers, api-key com a sua chave. O Webhooks by Zapier está disponível nos planos pagos do Zapier.
4. Um contato por sócio. Use Looping by Zapier sobre os sócios e, dentro do loop, a ação do CRM que cria o contato.

Mapeamento sugerido

Se o sócio tiver mais de um telefone ou e-mail, grave os outros em campos extras ou numa nota do contato.

Boas práticas

• Guarde a chave numa credencial da ferramenta, nunca escrita no meio do fluxo.
• Marque a empresa como enriquecida, por exemplo com um campo de data, e filtre o gatilho para não consultar o mesmo CNPJ duas vezes.
• Crie o contato só quando houver telefone ou e-mail: nem todo sócio tem contato encontrado.
• Em importações grandes, processe aos poucos para respeitar o limite por minuto do plano: 120 chamadas no Intermediário e 300 no Avançado.
• Use os contatos com uma finalidade legítima e clara, ofereça a opção de sair da lista e evite disparos em massa. Na dúvida sobre a LGPD no seu caso, fale com o seu jurídico.

Outras consultas no mesmo modelo

O mesmo fluxo serve para outras consultas da API: a ficha do CNPJ para completar o cadastro da empresa, a ficha do CPF quando o lead é pessoa física e o reverso de e-mail para descobrir quem preencheu um formulário. A documentação tem todos os endereços e campos.