Como conectar a Econodata a Ploomes

Este artigo explica, passo a passo, como funciona a integração nativa entre a Econodata e o Ploomes: o que ela faz, como conectar, quais campos são preenchidos automaticamente e como desconectar quando necessário.

1. O que a integração faz

A integração Ploomes é nativa: diferente de conectores como Make ou Zapier, aqui não existe cenário para montar. Depois de conectada, o fluxo acontece sozinho: negócio criado no Ploomes → Econodata enriquece → empresa e decisores preenchidos no próprio Ploomes.

Gatilho no Ploomes	O que a Econodata faz
Negócio criado	A Econodata lê o negócio, identifica a empresa vinculada a ele e faz o enriquecimento.
Negócio atualizado	A mesma coisa acontece de novo: a Econodata relê o estado atual do negócio (não confia no conteúdo do aviso de atualização).
Negócio removido	Esse evento é ignorado de propósito — a integração não faz nada quando um negócio é excluído.

⚠️ Importante: A integração não sincroniza a base em massa nem roda varredura periódica — só reage a negócios criados ou atualizados. Ela também não traz dado do Ploomes para dentro da Econodata (lê apenas o necessário para identificar a empresa) e nunca sobrescreve o que o vendedor já digitou: campo já preenchido é sempre preservado.

2. Pré-requisitos

Uma conta Ploomes (qualquer plano), com alguém administrador disponível para criar o usuário de integração.
A chave da API do Ploomes (User-Key) de um usuário de integração — pode ser um usuário novo ou um que já exista. Essa chave não é a senha de uma pessoa, e o usuário de integração não consome licença da conta.
Uma conta Econodata com saldo de tokens disponível. Não é preciso gerar nenhuma chave de API da Econodata: a cobrança é feita na conta que fizer a conexão.

3. Como conectar

A conexão é feita colando, na Econodata, a chave de um usuário de integração obtido no próprio Ploomes.

Passo 1 — Inicie a conexão na Econodata

Na plataforma Econodata, acesse Integrações & API → Conectores → CRMs.
Localize o card do Ploomes e clique em “Conectar Ploomes”.

Passo 2 — Obtenha a chave de integração no Ploomes

Acesse o Ploomes e vá até Administração

Na coluna Integrações, clique em “Usuários de integração”.

Abra um usuário existente (por exemplo, um usuário “Econodata” já criado para isso) ou crie um novo usuário de integração.
No cadastro do usuário, copie o valor do campo “Chave da API”.

Observação: Essa chave pertence ao usuário de integração, não a uma pessoa — a Econodata nunca tem acesso à senha de ninguém no Ploomes.

Passo 3 — Cole a chave na Econodata e conecte

Volte à Econodata e cole a chave copiada no campo “Chave de integração (User-Key)”.

Clique em “Conectar”.
O card passa a exibir o status “Conectado”.

⚠️ Importante para quem faz o suporte: O perfil do usuário de integração importa. Um perfil restrito passa na validação da chave (que só confere identidade), mas pode ser recusado ao tentar criar um campo personalizado. Nesse caso a integração não falha: ela grava o que consegue nos campos nativos do Ploomes. Se o cliente disser que “falta campo da Econodata” na empresa, o primeiro lugar a olhar é a permissão desse usuário de integração.

4. O que é preenchido no Ploomes

4.1 Campos nativos do cliente/empresa

A integração preenche os campos nativos abaixo sempre que estiverem vazios:

Register (CNPJ) — o campo CNPJ do Ploomes é derivado automaticamente a partir dele.
LegalName (razão social).
Email e Website.
CNAECode, CNAEName e CNAESecondary (atividade econômica).
StreetAddress, Neighborhood, ZipCode, CityId e StateId (endereço, com cidade e UF já resolvidas corretamente).
Phones (telefones).

4.2 Campos criados pela Econodata

Campo	Onde aparece e o que traz
Faturamento estimado (Econodata)	Empresa — valor numérico, para filtrar e segmentar dentro do próprio Ploomes.
Funcionários (Econodata)	Empresa — valor numérico, mesmo uso do campo acima.
Econodata	Empresa — campo consolidado em texto, com razão social, faturamento, funcionários, CNAE, porte, situação cadastral, endereço, telefones e a informação “Fonte: Econodata · data”.
Econodata	Contato — campo consolidado do decisor: cargo, nível de decisão, área, LinkedIn e a fonte.

4.3 Decisores (contatos)

Os decisores entram como contatos vinculados à empresa, com o cargo preenchido no campo nativo quando ele corresponde ao catálogo já usado na conta. Três regras valem sempre:

No máximo 5 decisores por empresa.
A identidade do decisor é o e-mail: sem e-mail, o contato não é escrito; e dois decisores com o mesmo e-mail viram um único contato (o mais sênior).
Sócios e CPF nunca são enviados. Um contato já criado pela integração é atualizado, não duplicado — e um contato que o cliente apagar não é recriado.

5. Como a empresa é identificada

Quando o vendedor cria (ou edita) um negócio no Ploomes com um cliente vinculado, a empresa daquele negócio é preenchida em segundos — sem precisar abrir a Econodata. Para isso funcionar bem de primeira, o que importa é de onde vem o identificador da empresa:

Cliente com CNPJ preenchido	A cascata usa o CNPJ — é o caminho mais preciso e deve sempre ser preferido.
Sem CNPJ, mas com site preenchido	A cascata usa o domínio do site.
Sem CNPJ e sem site	A cascata tenta pelo nome, se ele for parecido com a razão social.
Negócio sem cliente vinculado	Nada acontece — sem cliente não há empresa para enriquecer.

Observação: Se a empresa não for identificada com confiança, nada é escrito no Ploomes — evitamos preencher os dados de uma empresa errada — e nada é cobrado. Dica: se a base de clientes não guarda CNPJ, vale preencher esse campo uma vez; a partir daí, todo evento daquele cliente passa a usar o caminho mais preciso.

6. Consumo de tokens

A cobrança é feita em tokens, na conta que fez a conexão, considerando a base do enriquecimento mais os campos entregues por empresa.

Enriquecer uma empresa (referência)	Tokens
Reprocessar a mesma empresa em 24h	não é cobrado de novo
Empresa não identificada	nada é cobrado quando nada é escrito
O saldo de tokens pode ser acompanhado a qualquer momento no painel da Econodata, sem custo.

7. Limites e pontos de atenção

Até 5 decisores por empresa.
O Ploomes limita a 120 requisições por minuto por conta — esse teto é compartilhado com as outras integrações que o cliente já usa.
Eventos repetidos do mesmo negócio, dentro de aproximadamente 1 hora, não geram reprocessamento.
O campo consolidado “Econodata” tem limite de 4.000 caracteres; o que passar disso é cortado.
É criado um webhook por ação (negócio criado, negócio atualizado).
Se o cliente já usa a integração plug-and-play antiga do Ploomes, ela continua funcionando normalmente — as duas convivem sem conflito.

8. Como desconectar

No mesmo card do Ploomes (já conectado), clique em “Desconectar”.

Ao desconectar pelo lado da Econodata:

A credencial é apagada do nosso lado e os 2 webhooks são removidos do Ploomes.
Os dados que já haviam sido enviados para o Ploomes permanecem lá — nada é apagado do CRM do cliente.

⚠️ Importante: Desconectar pela Econodata não invalida a chave no Ploomes. Quem realmente “mata” a chave é o administrador da conta Ploomes, apagando o usuário de integração por lá. Se o cliente quiser ter certeza de que o acesso foi revogado dos dois lados, oriente-o a também remover (ou trocar a chave d)o usuário de integração no Ploomes.

9. Perguntas frequentes

Colei a chave e a conexão foi recusada. Por quê?

A chave está inválida, foi revogada ou pertence a um usuário que já foi apagado no Ploomes. Gere (ou copie) outra chave de um usuário de integração ativo e cole novamente.

A integração funcionava e passou a dar erro de credencial. O que fazer?

A chave foi revogada do lado do Ploomes. Como essa chave é estática, a única forma de resolver é reconectar colando uma chave nova.

A conexão está sem saldo. O que acontece?

A carteira de tokens da conta zerou. Basta recarregar: a integração retoma automaticamente nos próximos eventos, sem precisar reconectar.

Uma empresa não foi preenchida. Por quê?

Duas causas comuns: a cascata de identificação não encontrou a empresa com confiança suficiente, ou o negócio não tem nenhum cliente vinculado. Preencha o CNPJ do cliente e edite o negócio para disparar uma nova tentativa.

Falta algum campo “Econodata” na empresa. Por quê?

Provavelmente o usuário de integração usado na conexão não tem permissão para criar campos personalizados no Ploomes. Ajuste a permissão desse usuário e reconecte.

Apaguei um contato criado pela integração e ele voltou?

Não deveria — e se voltou, é um comportamento inesperado. Por desenho, um contato apagado pelo cliente não é recriado pela integração.

O card do Ploomes não aparece no painel da Econodata.

Esse conector é liberado de forma gradual (rollout). Se o card não aparece, normalmente é porque ainda não foi habilitado para aquela conta — não é um problema com a chave.

Conectei, mas nada mudou no CRM.

Confira se o negócio tem um cliente vinculado e se esse cliente tem CNPJ, site ou nome reconhecível. Lembre também que eventos repetidos do mesmo negócio, dentro de cerca de 1 hora, não geram um novo processamento.

O faturamento ou o número de funcionários parece estranho.

Quando a Econodata não tem o número exato daquela unidade, ela traz uma estimativa por faixa. O texto do campo consolidado indica quando o valor é do grupo (matriz + filiais) e não apenas daquela unidade específica.

10. Saiba mais

Integrações irmãs, com o mesmo desenho: Como conectar a Econodata ao RD Station CRM e Como conectar a Econodata ao Pipedrive.
Dúvidas que não foram respondidas aqui podem ser encaminhadas ao suporte Econodata.

Actualizado em: 26/08/2026

Esse artigo foi útil?

Obrigado!