# Integração Moskit CRM

> Conecte o Moskit ao GS Engage com o token da API, mapeie campos e envie leads da cadência direto para o funil certo.

- URL canônica: https://docs.growthstation.app/docs/integracoes/moskit
- Idioma: pt-BR
- Última atualização: 2026-09-20T08:21:20.467Z
- Produto: GS Engage
- Mantido por: Product Education
- Revisão editorial: 2026-09-02



<PageHero emoji="🔌" title="Integração Moskit + GS Engage" description="Envie os leads trabalhados no GS Engage para o Moskit CRM, com criação automática de contato, empresa e negócio no funil escolhido." gradient="brand" />

Esta integração liga o **Moskit CRM** ao **GS Engage**. Os leads trabalhados na cadência são enviados para o Moskit — criando **contato**, **empresa** e **negócio** — e o histórico das atividades fica registrado na linha do tempo do negócio.

Para entender onde essa integração se encaixa na plataforma, veja também [O que é o GS Engage](/docs/o-que-e-o-gs-engage).

<Callout type="info" title="Como o Moskit conecta">
  O Moskit conecta por **token da API** (uma chave de acesso). Não há login por OAuth, senha nem subdomínio: basta colar o token gerado no seu Moskit e clicar em <TextHighlight>Conectar</TextHighlight>.
</Callout>

🔑 O que você vai precisar [#-o-que-você-vai-precisar]

<FieldInfoGroup>
  <FieldInfo title="Token da API do Moskit" required>
    A chave de acesso que autoriza o GS Engage a criar registros na sua conta do Moskit.

    Ela é gerada dentro do Moskit, em <TextHighlight>Marketplace > API Pública do Moskit CRM</TextHighlight>.
  </FieldInfo>

  <FieldInfo title="Permissão no GS Engage">
    Acesso ao menu <TextHighlight>Ajustes e Permissões</TextHighlight> para abrir a área de integrações.

    Se você não enxergar a opção do Moskit, peça ajuda a um usuário administrador da sua conta.
  </FieldInfo>
</FieldInfoGroup>

🔗 Conectar o Moskit ao GS Engage [#-conectar-o-moskit-ao-gs-engage]

Aqui você informa o **token da API** para ativar a integração. Você faz isso uma única vez e, depois, apenas ajusta os mapeamentos de campos.

<Steps>
  <Step num={1} title="Gere o token no Moskit (site externo)">
    Faça login no Moskit e acesse <TextHighlight>Marketplace > API Pública do Moskit CRM</TextHighlight> para gerar o token da API.

    Copie o token gerado — você vai colá-lo no GS Engage no próximo passo.
  </Step>

  <Step num={2} title="Abra a integração no GS Engage">
    No menu do topo, clique em <TextHighlight>GS Engage</TextHighlight> e selecione <TextHighlight>Ajustes e Permissões</TextHighlight>.

    Na seção de integrações, abra o cartão do <TextHighlight>Moskit</TextHighlight>.
  </Step>

  <Step num={3} title="Cole o token e conecte">
    No bloco <TextHighlight>Token do Moskit</TextHighlight>, cole a chave no campo <TextHighlight>Insira o token do Moskit</TextHighlight>.

    Depois clique em <TextHighlight>Conectar</TextHighlight> e aguarde a validação.
  </Step>

  <Step num={4} title="Confirme o status Integrado">
    Se der certo, você verá o selo verde <TextHighlight>Integrado</TextHighlight> ao lado do campo.

    A partir daí, o mapeamento de campos fica disponível para configurar.
  </Step>
</Steps>

<Callout type="tip" title="Onde encontro o token?">
  Se ficar em dúvida, passe o mouse sobre o link <TextHighlight>Onde encontro o token do Moskit?</TextHighlight>, exibido perto do campo. Ele mostra o caminho <TextHighlight>Marketplace > API Pública do Moskit CRM</TextHighlight>.
</Callout>

<Callout type="warning" title="Se aparecer o selo Falha">
  Um selo vermelho <TextHighlight>Falha</TextHighlight> indica que o token não foi aceito. Gere um novo token no Moskit e conecte novamente.
</Callout>

🏷️ Mapear campos (GS Engage → Moskit) [#️-mapear-campos-gs-engage--moskit]

Depois de conectar, você define **quais dados do lead vão para qual lugar no Moskit**. Cada campo é enviado para um **Contato**, uma **Empresa** ou um **Negócio**.

O mapeamento aparece em duas abas: <TextHighlight>Campos Padrão</TextHighlight> (campos comuns do lead) e <TextHighlight>Campos Personalizados</TextHighlight> (os campos que sua empresa criou no GS Engage). Se você precisar criar ou organizar campos antes de mapear, veja [Configuração de Campos](/docs/configuracoes/campos-personalizados).

<FieldInfoGroup>
  <FieldInfo title="Seção">
    Define **onde** o dado será salvo no Moskit:

    <TextHighlight>Negócio</TextHighlight>, <TextHighlight>Contato</TextHighlight>, <TextHighlight>Empresa</TextHighlight> ou <TextHighlight>Não Associar</TextHighlight>.
  </FieldInfo>

  <FieldInfo title="Campo do Moskit">
    Define **qual campo exato** do Moskit vai receber o valor.

    Este seletor só habilita depois que você escolhe uma <TextHighlight>Seção</TextHighlight>.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="info" title="Campos já associados automaticamente">
  Alguns campos do lead — como **Nome**, **Sobrenome**, **Nome Completo**, **E-mails** e **Telefones/Celulares** (que vão para o Contato) e **Empresa** (que vira o nome da Empresa) — já têm associação fixa e aparecem bloqueados para edição.
</Callout>

📋 Campos padrão do Moskit disponíveis [#-campos-padrão-do-moskit-disponíveis]

Além dos campos personalizados que você criou no Moskit, o GS Engage também permite mapear os campos padrão de cada seção:

| Seção   | Campos padrão                                                           |
| ------- | ----------------------------------------------------------------------- |
| Contato | Nome, E-mail, Telefone, Cargo, CPF, Observações, Link de rede social    |
| Empresa | Nome, Domínio, E-mail, Telefone, CNPJ, Observações, Link de rede social |
| Negócio | Nome, Valor, Data prevista de fechamento                                |

<Callout type="warning" title="Regra de envio dos campos">
  Se a <TextHighlight>Seção</TextHighlight> de um campo estiver como <TextHighlight>Não Associar</TextHighlight>, esse campo **não** será enviado para o Moskit.
</Callout>

<Callout type="tip" title="Dica prática">
  Você não precisa mapear tudo de uma vez. Comece com poucos campos e, depois que estiver funcionando, volte e complete o restante. Os campos personalizados do Moskit ficam em <TextHighlight>Configurações > Campos personalizados</TextHighlight> dentro do Moskit.
</Callout>

🔄 O que acontece na sincronização [#-o-que-acontece-na-sincronização]

Quando um lead é enviado para o Moskit pela cadência, o GS Engage cria os registros na ordem abaixo e os deixa vinculados entre si.

<Steps>
  <Step num={1} title="Empresa">
    Se o lead tiver nome de empresa, o GS Engage cria (ou reaproveita) uma **empresa** no Moskit com os dados mapeados. Se não houver nome de empresa, o processo segue apenas com o contato e o negócio.
  </Step>

  <Step num={2} title="Contato">
    O lead vira um **contato** no Moskit, já vinculado à empresa e ao cargo, quando mapeados.

    Para evitar duplicidade, o GS Engage procura antes um contato com o mesmo e-mail. Se encontrar, reaproveita o registro existente em vez de criar outro.
  </Step>

  <Step num={3} title="Negócio">
    É criado um **negócio** com status **aberto**, na etapa do funil escolhida na cadência. No Moskit, a etapa já determina o funil do negócio.
  </Step>

  <Step num={4} title="Histórico das atividades">
    As atividades executadas na cadência (ligação, e-mail, LinkedIn, WhatsApp e afins) são registradas como **notas na linha do tempo do negócio**, mantendo o histórico do lead dentro do Moskit.
  </Step>
</Steps>

<Callout type="info" title="Quem fica como dono">
  O dono (responsável) do contato, da empresa e do negócio é definido entre os **usuários elegíveis** que você seleciona na configuração da cadência. Se o usuário preferido estiver inativo no Moskit, o GS Engage usa automaticamente outro usuário ativo disponível.
</Callout>

🎯 Integrar uma cadência com o Moskit [#-integrar-uma-cadência-com-o-moskit]

Aqui você liga uma cadência ao Moskit e define para qual funil e etapa os leads vão. Se você ainda não criou sua cadência, siga o passo a passo em [Como criar uma cadência](/docs/gerenciamento/cadencias).

<FieldInfoGroup>
  <FieldInfo title="Enviar Leads desta Cadência para o Moskit">
    Liga ou desliga a integração do Moskit para esta cadência.

    Quando ligado, os campos abaixo ficam disponíveis para configurar.
  </FieldInfo>

  <FieldInfo title="Funil do Moskit">
    Escolha em qual funil (pipeline) do Moskit o negócio vai entrar.
  </FieldInfo>

  <FieldInfo title="Etapa do Funil do Moskit">
    Escolha em qual etapa do funil o negócio vai ficar. As etapas disponíveis dependem do funil selecionado.
  </FieldInfo>

  <FieldInfo title="Usuários que poderão receber o Lead Ganho">
    Selecione os usuários elegíveis para receber o lead. Você pode escolher mais de um usuário.
  </FieldInfo>

  <FieldInfo title="Enviar Leads Ganhos de maneira">
    Escolha se a distribuição será <TextHighlight>Manual</TextHighlight> ou <TextHighlight>Automática</TextHighlight>.
  </FieldInfo>
</FieldInfoGroup>

<Steps>
  <Step num={1} title="Edite a cadência e abra Integrações">
    Na edição da cadência, vá até a seção <TextHighlight>Integrações</TextHighlight> e localize o bloco <TextHighlight>Integração da Cadência com o Moskit</TextHighlight>.
  </Step>

  <Step num={2} title="Ative o envio para o Moskit">
    Ligue o switch <TextHighlight>Enviar Leads desta Cadência para o Moskit</TextHighlight>.

    Os campos de funil, etapa e usuários ficam habilitados.
  </Step>

  <Step num={3} title="Escolha Funil, Etapa e Usuários">
    Preencha o <TextHighlight>Funil do Moskit</TextHighlight> e a <TextHighlight>Etapa do Funil do Moskit</TextHighlight>.

    Depois selecione os usuários em <TextHighlight>Usuários que poderão receber o Lead Ganho</TextHighlight>.
  </Step>

  <Step num={4} title="Defina Manual ou Automática e salve">
    Em <TextHighlight>Enviar Leads Ganhos de maneira</TextHighlight>, escolha <TextHighlight>Manual</TextHighlight> ou <TextHighlight>Automática</TextHighlight> e salve a cadência.
  </Step>
</Steps>

<Callout type="info" title="Modos de distribuição">
  No modo **Manual**, você escolhe o usuário que receberá o lead no momento em que ele é marcado como ganho. No modo **Automática**, o lead é distribuído sozinho, em rodízio entre os usuários selecionados. Em cadências no modo de execução por IA, apenas a distribuição **Automática** fica disponível.
</Callout>

⛔ Cancelar a integração com o Moskit [#-cancelar-a-integração-com-o-moskit]

Aqui você desliga totalmente a integração — útil se você trocou de conta no Moskit ou quer reconfigurar do zero.

<Callout type="warning" title="Atenção: impacto alto">
  Ao cancelar, **todas as associações de campos e as integrações nas cadências deixam de funcionar**. Ao adicionar um novo token, você precisará refazer as configurações.
</Callout>

<Steps>
  <Step num={1} title="Clique em Cancelar integração">
    No cartão do Moskit em <TextHighlight>Ajustes e Permissões</TextHighlight>, clique no link vermelho <TextHighlight>Cancelar integração</TextHighlight>.
  </Step>

  <Step num={2} title="Confirme no modal">
    Na janela <TextHighlight>Cancelar integração com o Moskit?</TextHighlight>, clique em <TextHighlight>Cancelar Integração</TextHighlight> para confirmar — ou em <TextHighlight>Fechar</TextHighlight> para desistir.
  </Step>
</Steps>

<Callout type="tip" title="Para trocar o token">
  Não há edição direta do token: para substituí-lo, cancele a integração e conecte novamente com o novo token.
</Callout>

💬 Dúvidas comuns [#-dúvidas-comuns]

<FAQ>
  <FAQItem question="O Moskit conecta por OAuth ou subdomínio?">
    Não. A conexão é feita apenas pelo **token da API**, gerado no Moskit em <TextHighlight>Marketplace > API Pública do Moskit CRM</TextHighlight>. Não há login por OAuth nem informação de subdomínio.
  </FAQItem>

  <FAQItem question="Preciso associar as atividades como em outros CRMs?">
    Não. No Moskit, as atividades da cadência são registradas automaticamente como **notas na linha do tempo do negócio** — não há uma tela de associação de atividades para configurar.
  </FAQItem>

  <FAQItem question="Por que o seletor 'Campo do Moskit' fica bloqueado?">
    Ele só habilita depois que você escolhe a <TextHighlight>Seção</TextHighlight> (Negócio, Contato ou Empresa). Enquanto a seção estiver como <TextHighlight>Não Associar</TextHighlight>, o campo permanece bloqueado.
  </FAQItem>

  <FAQItem question="O mesmo lead pode virar dois contatos no Moskit?">
    O GS Engage procura um contato com o mesmo e-mail antes de criar um novo e reaproveita o registro existente quando encontra. Ainda assim, contatos sem e-mail ou com e-mails diferentes podem gerar registros separados.
  </FAQItem>

  <FAQItem question="Como troco o token quando ele mudar no Moskit?">
    Cancele a integração atual e conecte novamente com o novo token. Depois, revise o mapeamento de campos e a configuração das cadências.
  </FAQItem>
</FAQ>

📚 Artigos relacionados [#-artigos-relacionados]

<RelatedArticles>
  <RelatedArticle href="/docs/o-que-e-o-gs-engage" title="O que é o GS Engage" description="Entenda a plataforma de prospecção onde a integração com o Moskit funciona." />

  <RelatedArticle href="/docs/gerenciamento/leads" title="Gerenciamento de Leads" description="Organize e acompanhe os leads que serão enviados ao Moskit." />

  <RelatedArticle href="/docs/gerenciamento/cadencias" title="Como criar uma cadência" description="Crie a cadência que enviará os leads para o funil do Moskit." />

  <RelatedArticle href="/docs/configuracoes/campos-personalizados" title="Configuração de Campos" description="Crie e padronize campos para melhorar o mapeamento com o CRM." />

  <RelatedArticle href="/docs/integracoes/kommo" title="Integração Kommo CRM" description="Referência para integrações de CRM com lógica semelhante de mapeamento." />

  <RelatedArticle href="/docs/integracoes/pipedrive" title="Integração Pipedrive" description="Outra integração de CRM com envio de leads pela cadência." />
</RelatedArticles>

<Callout type="info" title="Ainda precisa de ajuda?">
  Se você continuar com dúvidas, abra uma solicitação para o time:\
  [Central de Solicitações](/docs/configuracoes/tickets-de-suporte)
</Callout>