> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.econodata.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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 (necessário ter o modulo de API contratado), 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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_qezcbx.png)
### Passo 2 — Obtenha a chave de integração no Ploomes

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

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-11_1p96vg5.png)
2. Na coluna Integrações, clique em “Usuários de integração”.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-12_1hvzpgc.png)

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

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-13_lsplc3.png)
| **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

1. Volte à Econodata e cole a chave copiada no campo “Chave de integração (User-Key)”.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_ayt91b.png)
2. Clique em “Conectar”.
3. O card passa a exibir o status “Conectado”.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1fpo7kd.png)
|| **⚠️ 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

1. 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](https://help.econodata.com.br/pt/article/integracao-nativa-econodata-rd-station-crm-77bvhy/) e [Como conectar a Econodata ao Pipedrive](https://help.econodata.com.br/pt/article/como-conectar-a-econodata-ao-pipedrive-1ghnimj/).
* Dúvidas que não foram respondidas aqui podem ser encaminhadas ao suporte Econodata.