> ## 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 ao Moskit via API V4

Guia de uso da integração **nativa** Econodata × Moskit. Diferente de conectores como Make e Zapier, aqui **não há nenhum cenário para montar**: depois de conectada, a sequência **negócio criado ou editado no Moskit → Econodata identifica e enriquece a empresa → dados preenchidos automaticamente no próprio Moskit** acontece sozinha.
Ou seja, a integração enriquece automaticamente as empresas e os contatos vinculados aos negócios do seu CRM, sem que você precise abrir a Econodata, copiar dados ou preencher campos manualmente.
## Pré-requisitos (Caso vá enriquecer os dados a partir do seu CRM)

* Conta **Moskit** com acesso ao **Marketplace** (é onde a chave de API é gerada);
* **Chave de API** (`apikey`) da sua conta Moskit;
* Plano Econodata com **API v4 habilitada e saldo de tokens**. Não é preciso gerar uma API key `ek_live_`: a cobrança é feita na conta que conectou, e a Econodata nunca guarda sua chave da v4.

## 1. Conectar a conta

São **dois passos**, e o segundo é o que mais gente esquece — sem ele a integração fica com o status verde, mas não recebe nenhum dado.
### Passo 1 — colar a chave da API

No painel da Econodata, vá em **Integrações & API → Conectores → CRMs** e clique em **Conectar Moskit** no card do Moskit.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_m881o1.png)

No Moskit, abra o **Marketplace** e localize o card **API Pública**.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1cmslyr.png)

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1skwo2o.png)

Clique no card, depois em **Gerar apikey**.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_2rmzxy.png)
Copie a chave exibida na janela.

![Mostrar Imagem](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-15_1pfml5.png)
Volte ao painel da Econodata, cole a chave no campo **Chave de API (apikey)** do card do Moskit e clique em **Conectar**.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_149885s.png)
A chave é validada **na hora**: se for inválida, a conexão é **recusada** e nada é gravado.
> ℹ️ Gerar uma chave nova **não invalida as anteriores** — sua conta pode ter várias chaves ativas ao mesmo tempo.

Depois de conectar, o card muda para **Conectado**, mas mostra um aviso: falta o passo 2.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_19pa7nu.png)

### Passo 2 — cadastrar o endereço do webhook (manual, e obrigatório)

O Moskit **não oferece um jeito de a Econodata avisar o CRM** de que quer receber os eventos de negócio — não existe API de webhook lá. Então **é você quem cadastra**, uma única vez:
1. No card da Econodata, copie o **endereço do webhook** (ele aparece logo depois de conectar, na mesma tela do passo anterior).
2. No Moskit, vá em **Marketplace → Webhooks**.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_1owzdqf.png)

3. Ative a integração, dê um nome ao webhook (por exemplo, "Econodata"), cole o endereço copiado no campo **URL** e marque as quatro ações de negócio: **Criação de negócio**, **Edição na fase de negócio**, **Edição no status de negócio** e **Edição de negócio**.

![Mostrar Imagem](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/design-sem-nome-16_t8594v.png)
4. Confira se as quatro ações estão marcadas e clique em **Salvar** e sua integração estará completa.
![](https://storage.crisp.chat/users/helpdesk/website/-/1/9/2/4/1924e04f5671d600/image_gjvzo9.png)
> ⚠️ **O endereço contém uma credencial.** Trate-o como senha: não publique nem compartilhe fora da sua conta do Moskit.
> ⚠️ **Ao reconectar, o endereço MUDA e o antigo para de funcionar.** Se você desconectar e conectar de novo, volte ao passo 2 e **substitua** o endereço no Moskit. Sem isso a integração fica conectada e **não enriquece nada**, sem nenhuma mensagem de erro.
> ⚠️ **Desconectar não remove o webhook da sua conta.** O Moskit não tem uma forma de fazer isso automaticamente. O webhook antigo continua chamando a Econodata (e sendo recusado) até você mesmo apagá-lo em **Marketplace → Webhooks**. O dado já enviado **permanece** no seu CRM.

## 2. O que a integração faz

| Gatilho no Moskit | O que a Econodata faz |
| **Negócio criado** | lê o negócio → identifica a empresa vinculada → enriquece |
| **Negócio atualizado** | idem (relê o estado atual do negócio) |
| **Negócio removido** | ignorado de propósito |

A empresa é identificada por **CNPJ** (campo nativo do Moskit) e, se ele estiver vazio, pelo **nome** (busca aproximada, com um limiar de confiança). Se não identificarmos a empresa com confiança, **nada é escrito** — empresa errada no seu CRM é pior que campo vazio — e nada é cobrado.

> ⚠️ **Aqui não há a etapa por site.** Em outros conectores, quando falta o CNPJ a Econodata tenta identificar a empresa pelo domínio do site. O Moskit não devolve o site da empresa na leitura, então **é CNPJ ou nome** — o que torna preencher o CNPJ ainda mais importante nesta integração.

O que a integração **não** faz: não sincroniza sua base em massa, não roda varredura periódica, não traz dado do seu CRM para dentro da Econodata (lê só o necessário para identificar a empresa) e **nunca cria empresa** no seu Moskit — ela só enriquece uma empresa que já existe.

## 3. O que vem no enriquecimento

**Na empresa** (a que já existe no seu Moskit):
* **CNPJ** no campo **nativo** do Moskit (é a chave de identidade usada pela integração);
* um campo **"Econodata"** consolidado, com razão social, faturamento estimado, número de funcionários, CNAE, porte, situação cadastral, endereço e telefones, com a data da última atualização.
**Nos contatos** (até **5 decisores** por empresa):
* nome, **e-mail** e um campo **"Econodata"** com cargo, nível de decisão, área e LinkedIn;
* o contato fica **vinculado à empresa** do negócio.

> ⚠️ **Decisor sem e-mail não é escrito.** O e-mail é a identidade da pessoa aqui: sem ele não temos como evitar duplicata nem respeitar uma remoção feita por você. Pelo mesmo motivo, **decisores que dividem o mesmo e-mail viram um único contato** (o mais sênior).
> 🔸 **Quem aparece como responsável pelos contatos criados.** O Moskit exige um usuário responsável em toda criação, e não existe um "usuário de integração" na API dele. A Econodata usa o **primeiro usuário ativo da conta**. Empresas **nunca** são criadas, então isso vale só para os contatos novos.
> 🔸 **Contato apagado por você não é recriado.** Se você apagar no Moskit um contato que a Econodata criou, ela **não o traz de volta** nos próximos eventos — apagar é uma decisão que a integração respeita.

## 4. O caminho do vendedor

1. O vendedor cria (ou edita) o negócio no Moskit com a **empresa vinculada**.
2. Pouco depois, a empresa daquele negócio já está preenchida — sem abrir a Econodata, sem copiar e colar.

| Situação da empresa no Moskit | O que a Econodata usa |
| campo **CNPJ** preenchido | o CNPJ — mais preciso, **sempre prefira** |
| sem CNPJ | o **nome**, se for parecido com a razão social |
| negócio **sem empresa vinculada** | nada acontece (não há empresa para enriquecer) |
> ⚠️ **Vincular a empresa ao negócio é obrigatório.** Negócio criado sem empresa vinculada não gera enriquecimento nenhum — esse é o comportamento esperado.

## 5. Limites

| Limite | Valor |
| Decisores por empresa | **5** |
| Requisições ao Moskit | **240/min** e **6/segundo** por conta — tetos do próprio Moskit, **compartilhados** com suas outras integrações |
| Reprocessar o **mesmo** negócio | eventos repetidos do mesmo negócio **colapsam num único processamento**. Para reprocessar de propósito, crie um negócio novo |
| Webhook | **cadastro manual** (veja Seção 1, passo 2); não é removido automaticamente ao desconectar |
| Identificação da empresa | **sem etapa por site** — apenas CNPJ ou nome (veja §2) |

## 6. Possíveis erros

| Sintoma | Significado | O que fazer |
| Conexão **recusada** ao colar a chave | chave inválida ou apagada | gere outra em **Marketplace → API Pública** e cole de novo |
| Conexão vira **erro de credencial** depois de funcionar | a chave foi apagada no Moskit | a chave é estática: **reconectar é colar outra** — e depois **refazer o passo 2** |
| Conexão fica **sem saldo** | a carteira de tokens zerou | recarregue; a integração retoma nos próximos eventos |
| Conectado, mas **nada acontece** | quase sempre o **passo 2** não foi feito, ou o endereço mudou depois de uma reconexão | confira em **Marketplace → Webhooks** se o endereço cadastrado é o que o card mostra **agora** |
| Empresa **não foi preenchida** | não identificamos com confiança, ou o negócio não tem empresa vinculada | vincule a empresa e preencha o **CNPJ**; depois **crie um negócio novo** (editar o mesmo pode não reprocessar) |
| Contato **não voltou** depois de você apagá-lo | por desenho: pessoa apagada não é recriada | é o comportamento esperado |
> ℹ️ **Observação.** Se o card do Moskit não aparecer no seu painel, a integração ainda não foi liberada para a sua conta — não é falha de chave. Faturamento e número de funcionários "estranhos" costumam ser **estimativas por faixa**, usadas quando não temos o número exato daquela unidade; o rótulo do campo consolidado indica quando o número é do **grupo** (matriz + filiais) e não da unidade específica.

Se você quer aperfeiçoar o uso da Econodata, entre em contato com o suporte pelo e-mail [**suporte@econodata.com.br**](mailto:suporte@econodata.com.br).