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.

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

Clique no card, depois em Gerar apikey.

Copie a chave exibida na janela.

Volte ao painel da Econodata, cole a chave no campo Chave de API (apikey) do card do Moskit e clique em Conectar.

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.

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.

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.

4. Confira se as quatro ações estão marcadas e clique em Salvar e sua integração estará completa.

⚠️ 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

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.

⚠️ 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

6. Possíveis erros

ℹ️ 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.

Actualizado em: 04/09/2026