#Conectar a Econodata e enriquecer empresas do CRM

Conecte sua conta da Econodata com o token da API dela e a tela de cada empresa do CRM ganha duas abas: Dados Econodata, com cadastro, porte, faturamento presumido, telefones e dívidas com a União, e Pessoas, com sócios, decisores e colaboradores que você converte em leads. As consultas gastam tokens da sua conta na Econodata.

Antes de começar

• Para conectar a conta: papel de workspace Proprietário ou Administrador, ou Membro com cargo que dê acesso a Integrações.
• Para enriquecer uma empresa: Proprietário, Administrador ou Membro com cargo que permita Editar em Empresas. Para transformar pessoas em leads, o cargo também precisa permitir Criar em Leads. Veja papéis e permissões.
• Uma conta na Econodata com saldo de tokens.
• Cada workspace pode ter uma única conta Econodata conectada.

#Gerar o token na Econodata

O token é gerado na plataforma da Econodata, não na Clickmax. Em outra aba:

1. Entre na sua conta da Econodata.
2. Abra Integrações.
3. Gere um token da API.
4. Copie o token gerado. Ele começa com ek_live_.

Token sem o prefixo ek_live_ é da API antiga da Econodata e não é aceito.

#Conectar na Clickmax

1. Na Clickmax, abra Integrações > Explorar integrações e, na seção Vendas e Pagamentos, selecione o card Econodata.
2. Em Conectar sua conta, cole o token no campo Token da API. Use Mostrar token se quiser conferir o que colou.
3. Clique em Conectar conta.

A Clickmax valida o token na Econodata antes de salvar. Token errado, inativo ou conta sem tokens não criam a conexão, e a recusa aparece logo abaixo do campo — veja Erros comuns.

Conectada, a tela mostra o selo Ativo. Conectar não gasta tokens.

#Trocar o token ou desconectar

Volte à mesma tela, cole o token novo e clique em Atualizar token. Não é preciso desconectar antes: como existe uma só conta por workspace, o token novo substitui o anterior.

Desconectar apaga o token guardado. Os dados já trazidos continuam na tela de cada empresa; o que para é a possibilidade de enriquecer ou atualizar.

#Quando a Econodata passa a recusar o token

O selo vira Credencial inválida e a tela avisa: A Econodata rejeitou o token atual. Cole um token novo para voltar a enriquecer empresas. Normalmente é token revogado ou expirado no painel da Econodata.

Enquanto o token estiver nesse estado, a aba Dados Econodata das empresas volta a pedir a conexão, como se nada estivesse conectado. Cole um token novo e clique em Atualizar token.

#Enriquecer uma empresa

1. Abra Contatos > Minhas Empresas e clique na empresa.
2. Na coluna da direita, abra a aba Dados Econodata.
3. Clique em Enriquecer.

A consulta leva alguns segundos (o botão mostra Consultando a Econodata...) e o resultado aparece na mesma aba, com o aviso Empresa enriquecida com dados da Econodata.

#Por qual chave a empresa é procurada

A Clickmax usa a melhor chave que a empresa já tiver cadastrada, nesta ordem: CNPJ, depois site, depois e-mail. O topo da aba registra qual foi usada, em Consultado por.

Uma empresa sem nenhuma das três não pode ser consultada: o botão fica desabilitado, com o aviso Informe CNPJ, site ou e-mail da empresa para enriquecer. Preencha um dos campos na ficha da empresa e tente de novo.

Vale a pena preencher o CNPJ quando você o tiver: é a chave mais precisa. Site e e-mail são casados por domínio, então uma empresa hospedada num domínio genérico pode não ser encontrada.

#O que aparece na aba

Os dados vêm agrupados em até cinco seções — Cadastro, Atividade, Porte e faturamento, Contato e Dívidas com a União. O retorno da Econodata varia muito de empresa para empresa: campo sem valor não é exibido, e seção inteira sem dado nenhum não aparece. Duas empresas enriquecidas podem mostrar quantidades bem diferentes de informação.

Funcionários e faturamento anual são estimativas da Econodata: ela informa uma faixa e um valor dentro dela, e a aba mostra esse valor. É ele que os filtros numéricos da lista de empresas usam.

#Quais campos da ficha são preenchidos

O enriquecimento completa só os campos que estão vazios na ficha da empresa: razão social, nome fantasia, CNPJ, endereço, telefone, site, e-mail, setor e porte.

Nada que você digitou é sobrescrito. Se o telefone anotado pelo seu time está lá, ele fica — mesmo que a Econodata traga outro. Para trocar, edite o campo à mão.

#Atualizar depois

O topo da aba mostra Atualizado em com a data e a hora da última consulta. Clique em Atualizar para consultar de novo: o bloco de dados é substituído pelo retorno mais recente, e a lista de pessoas é refeita.

Pessoas que você já converteu em lead não são removidas por uma atualização, mesmo que deixem de aparecer no retorno da Econodata.

#Criar leads a partir das pessoas

A aba Pessoas lista quem a Econodata encontrou na empresa, em três grupos: Sócios, Decisores e Colaboradores. Vêm todos os sócios e até 5 decisores e 5 colaboradores, os mais relevantes segundo a Econodata. Cada linha traz o cargo, o nível de decisão, o melhor e-mail disponível e, quando existe, o link do LinkedIn.

• Uma pessoa: clique em Criar lead na linha dela.
• Várias: marque as caixas (ou use Selecionar todos) e clique em Criar leads (N).

Ao final, um aviso resume o lote: quantos foram criados, quantos foram vinculados, quantos já existiam e quantos falharam.

A aba fica vazia, com o texto Nenhuma pessoa encontrada. Enriqueça a empresa na aba Dados Econodata., quando a empresa ainda não foi enriquecida ou quando a Econodata não trouxe ninguém.

#Sem contato duplicado

Se já existe um contato no workspace com o mesmo e-mail, a Clickmax vincula a pessoa a ele em vez de criar um segundo — o histórico, as tags e as oportunidades desse contato continuam intactos. É o que o resumo conta como vinculados.

Pessoa já convertida mostra Ver lead no lugar do botão, e reenviar a mesma seleção não cria nada de novo: ela entra no resumo como já existiam.

#Origem dos leads criados

Na ficha do contato, a origem aparece como Integrações, com Econodata como sub-origem. Dá para separar esses contatos dos demais por esse par.

#Tokens e limites

Quando a cota do plano estoura no meio de um lote, os vínculos são feitos e só as criações falham — o aviso Cota de leads do plano atingida. Alguns leads não foram criados. diz quantas ficaram de fora.

#Erros comuns

Mensagens que aparecem ao conectar, na tela de Integrações:

Mensagens que aparecem ao enriquecer, na aba Dados Econodata:

#Filtrar a lista com os dados trazidos

Depois de enriquecer, CNAE, setor, porte estimado, situação, número de funcionários, faturamento anual e dívida federal viram filtros na lista de empresas. Passo a passo em Como filtrar empresas por CNAE, porte, faturamento e UF.