# Integração Salesforce CRM

> Crie o aplicativo de integração no seu Salesforce, conecte ao GS Engage por login OAuth, mapeie os campos e envie leads da cadência para o funil certo.

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



<PageHero emoji="🔌" title="Integração Salesforce CRM" description="Conecte o Salesforce ao GS Engage com um login seguro, mapeie campos para Conta, Contato e Oportunidade e leve seus leads direto para o funil certo." gradient="brand" />

Esta integração liga o **Salesforce** ao **GS Engage**. Os leads trabalhados no GS Engage são enviados para o Salesforce como **Contas**, **Contatos** e **Oportunidades**, mantendo o histórico do lead sempre atualizado no seu CRM.

Neste artigo, você vai aprender a **criar o aplicativo de integração no seu Salesforce**, **conectá-lo ao GS Engage**, **mapear os campos** e **enviar leads pela cadência** para o estágio certo da oportunidade. Se quiser entender o papel do GS Engage na sua operação, veja [O que é o GS Engage](/docs/o-que-e-o-gs-engage).

<Callout type="info" title="Antes de começar">
  Se você não enxergar o menu <TextHighlight>Integrações</TextHighlight> ou o cartão <TextHighlight>Salesforce</TextHighlight>, pode ser falta de permissão de acesso.

  Peça ajuda para um usuário administrador da sua conta e, se necessário, revise as configurações em <TextHighlight>Ajustes e Permissões</TextHighlight>.
</Callout>

🔑 Como o Salesforce conecta [#-como-o-salesforce-conecta]

A conexão é feita por **login OAuth** — o mesmo modelo seguro de "Entrar com...". Você faz login na tela oficial do Salesforce e autoriza o acesso; sua senha nunca é digitada nem guardada no GS Engage.

A diferença em relação a outros CRMs é que o Salesforce exige que **cada organização tenha seu próprio aplicativo de integração**. Por isso, antes de conectar, um administrador do seu Salesforce cria um aplicativo e informa dois códigos ao GS Engage: a **Chave do consumidor** e o **Segredo do consumidor**.

<FieldInfoGroup>
  <FieldInfo title="Aplicativo criado na sua organização">
    O aplicativo vive dentro do **seu** Salesforce. É o administrador da sua empresa quem cria, autoriza e pode revogar o acesso a qualquer momento — sem depender do time da Growth Station.
  </FieldInfo>

  <FieldInfo title="Login OAuth (sem senha no GS)">
    Com o aplicativo criado, você clica em <TextHighlight>Conectar com Salesforce</TextHighlight>, faz login na tela oficial do Salesforce e autoriza o acesso. O GS Engage recebe a permissão de forma segura.
  </FieldInfo>

  <FieldInfo title="Renovação automática">
    Depois de conectado, o acesso é renovado automaticamente. Você não precisa reconectar a cada expiração — só reconecta se remover a integração ou se o acesso for revogado no próprio Salesforce.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="info" title="Uma integração por projeto">
  Cada projeto do GS Engage se conecta a **uma** organização do Salesforce. Ao conectar, o GS Engage passa a trabalhar com a instância (o endereço) do Salesforce em que você fez login.
</Callout>

<Callout type="tip" title="Quem faz o quê">
  A criação do aplicativo (a seção seguinte) exige um **administrador do Salesforce**. A conexão em si (duas seções à frente) é feita por você, no GS Engage, com os dois códigos em mãos. Se você não é administrador do Salesforce, encaminhe a próxima seção para quem é.
</Callout>

🧩 Criar o aplicativo no Salesforce [#-criar-o-aplicativo-no-salesforce]

Esta parte é feita **uma vez por organização**, dentro do Salesforce, por um usuário administrador. Ao final, você terá os dois códigos que o GS Engage pede.

<Callout type="info" title="Deixe a URL de retorno à mão">
  No passo 4 você vai precisar da **URL de retorno** do GS Engage. Ela aparece na própria tela de conexão do Salesforce, em <TextHighlight>Ajustes e Permissões</TextHighlight> > <TextHighlight>Integrações</TextHighlight> > <TextHighlight>Salesforce</TextHighlight> — copie de lá para evitar erro de digitação.
</Callout>

<Steps name="Como criar o aplicativo de integração no Salesforce">
  <Step num={1} title="Entre na Configuração do Salesforce">
    No Salesforce, clique na engrenagem (canto superior direito) e escolha <TextHighlight>Configuração</TextHighlight>.

    Use um usuário com perfil de **administrador do sistema**.
  </Step>

  <Step num={2} title="Abra o Gerenciador de aplicativos">
    Na <TextHighlight>Busca rápida</TextHighlight>, digite `App Manager` e abra o <TextHighlight>Gerenciador de aplicativos</TextHighlight>.
  </Step>

  <Step num={3} title="Crie um novo aplicativo">
    Clique em <TextHighlight>New External Client App</TextHighlight>.

    Preencha o nome (por exemplo, **GS Engage**) e o e-mail de contato. Em <TextHighlight>Distribution State</TextHighlight>, mantenha a opção <TextHighlight>Local</TextHighlight>.
  </Step>

  <Step num={4} title="Habilite o OAuth e informe a URL de retorno">
    Marque a opção de habilitar as configurações de OAuth e cole a **URL de retorno** que você copiou do GS Engage.

    Ela tem o formato `https://www.growthstation.app/salesforce/auth/callback`. Cole exatamente como aparece na tela: qualquer diferença faz a autorização falhar.
  </Step>

  <Step num={5} title="Selecione as permissões (escopos)">
    Adicione estes dois escopos — e apenas eles:

    * **Gerenciar os dados do usuário por meio de APIs** (`api`)
    * **Realizar solicitações a qualquer hora** (`refresh_token, offline_access`)

    O primeiro permite criar contas, contatos e oportunidades. O segundo é o que mantém a conexão ativa sem pedir login de novo.
  </Step>

  <Step num={6} title="Revise quem pode usar o aplicativo">
    Em <TextHighlight>Policies</TextHighlight>, mantenha os usuários autorizados a **se auto-aprovarem** — ou, se a sua organização exige aprovação prévia, pré-autorize o perfil de quem vai fazer a conexão.

    Se a sua organização restringe login por faixa de IP, relaxe a restrição para este aplicativo. Sem isso, o Salesforce recusa as chamadas do GS Engage.
  </Step>

  <Step num={7} title="Salve e copie os dois códigos">
    Salve o aplicativo. Depois abra-o novamente e vá em <TextHighlight>Settings</TextHighlight> > <TextHighlight>OAuth Settings</TextHighlight> > <TextHighlight>Consumer Key and Secret</TextHighlight> — o Salesforce pode pedir para você confirmar sua identidade.

    Copie a <TextHighlight>Chave do consumidor</TextHighlight> (Consumer Key) e o <TextHighlight>Segredo do consumidor</TextHighlight> (Consumer Secret). São esses dois valores que o GS Engage pede na próxima seção.
  </Step>
</Steps>

<Callout type="warning" title="O aplicativo leva alguns minutos para ficar pronto">
  Depois de salvar, o Salesforce pode levar **até 30 minutos** para liberar o aplicativo. Se a conexão falhar com uma mensagem como `client identifier invalid`, não é erro de digitação: aguarde e tente de novo.
</Callout>

<Callout type="warning" title="O Segredo do consumidor é uma senha">
  Trate o <TextHighlight>Segredo do consumidor</TextHighlight> como uma senha: envie por um canal seguro e não compartilhe em grupos ou e-mails abertos. Se ele vazar, o administrador pode gerar um novo no Salesforce e reconectar a integração.
</Callout>

🔗 Conectar o Salesforce ao GS Engage [#-conectar-o-salesforce-ao-gs-engage]

Com os dois códigos em mãos, a conexão leva menos de um minuto. Você faz isso uma vez e, depois, apenas ajusta o mapeamento de campos e as cadências.

<Steps name="Como conectar o Salesforce ao GS Engage">
  <Step num={1} title="Abra a área de Ajustes">
    No menu do GS Engage, acesse <TextHighlight>Ajustes e Permissões</TextHighlight>.
  </Step>

  <Step num={2} title="Entre em Integrações > Salesforce">
    Na lista de integrações, localize o cartão <TextHighlight>Salesforce</TextHighlight>.

    Enquanto não estiver conectado, ele exibe o status <TextHighlight>Desconectado</TextHighlight> (em vermelho).
  </Step>

  <Step num={3} title="Escolha o ambiente e informe os dois códigos">
    Em <TextHighlight>Ambiente do Salesforce</TextHighlight>, escolha <TextHighlight>Produção</TextHighlight> ou <TextHighlight>Sandbox</TextHighlight> — precisa ser o mesmo ambiente onde o aplicativo foi criado.

    Cole a <TextHighlight>Chave do consumidor (Consumer Key)</TextHighlight> e o <TextHighlight>Segredo do consumidor (Consumer Secret)</TextHighlight>, conferindo se não sobrou espaço no começo ou no fim.
  </Step>

  <Step num={4} title="Clique em Conectar com Salesforce">
    Clique no botão azul <TextHighlight>Conectar com Salesforce</TextHighlight>.

    Uma janela do Salesforce será aberta para você fazer login e autorizar o acesso.
  </Step>

  <Step num={5} title="Faça login e autorize">
    Na janela do Salesforce, entre com seu usuário e senha do Salesforce e confirme a permissão de acesso solicitada.

    Use a conta que tem acesso à organização do Salesforce que você quer integrar.
  </Step>

  <Step num={6} title="Confirme o status Conectado">
    Ao concluir, a janela se fecha e o cartão passa a exibir o status <TextHighlight>Conectado</TextHighlight> (em verde).

    A partir daí, o mapeamento de campos e as cadências integradas ficam disponíveis.
  </Step>
</Steps>

<Callout type="warning" title="Deixe as janelas (pop-ups) liberadas">
  O login do Salesforce abre em uma nova janela. Se ela não aparecer, verifique se o navegador não está bloqueando pop-ups para o GS Engage e tente novamente.
</Callout>

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

Depois de conectar, defina para qual objeto do Salesforce cada dado do lead deve ir. No Salesforce, os dados são organizados em três objetos:

<FieldInfoGroup>
  <FieldInfo title="Organização (Account)">
    Guarda os dados da empresa do lead: nome da empresa, site, cidade, estado e segmento.
  </FieldInfo>

  <FieldInfo title="Contato (Contact)">
    Guarda os dados da pessoa: nome, sobrenome, e-mail, telefone, celular e cargo. Fica vinculado à Organização.
  </FieldInfo>

  <FieldInfo title="Oportunidade (Opportunity)">
    Representa o negócio em aberto. É criada para cada lead enviado e recebe o estágio e o dono definidos.
  </FieldInfo>
</FieldInfoGroup>

Na tela de mapeamento, para cada campo do GS Engage você escolhe primeiro **onde** o dado será salvo e depois **qual campo exato** do Salesforce recebe o valor.

<FieldInfoGroup>
  <FieldInfo title="Objeto do Salesforce">
    Define o destino do dado: <TextHighlight>Organização</TextHighlight>, <TextHighlight>Contato</TextHighlight>, <TextHighlight>Oportunidade</TextHighlight> ou <TextHighlight>Não Associar</TextHighlight>.
  </FieldInfo>

  <FieldInfo title="Campo do Salesforce">
    Define qual campo exato do objeto escolhido vai receber o valor. Só aparecem os campos que o Salesforce permite gravar.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="warning" title="Regra de envio">
  Se o objeto estiver como <TextHighlight>Não Associar</TextHighlight>, o campo **não** será enviado ao Salesforce.
</Callout>

📇 Campos já mapeados por padrão [#-campos-já-mapeados-por-padrão]

Alguns campos essenciais do lead já vêm associados de fábrica e **não podem ser editados**, para garantir que o registro chegue completo ao Salesforce:

| Campo no GS Engage              | Vai para                |
| ------------------------------- | ----------------------- |
| Nome, Sobrenome e Nome Completo | Nome do **Contato**     |
| E-mails                         | E-mail do **Contato**   |
| Telefones e Celulares           | Telefone do **Contato** |
| Empresa                         | Nome da **Organização** |

Os demais campos padrão e os [campos personalizados](/docs/configuracoes/campos-personalizados) podem ser livremente associados aos campos correspondentes do Salesforce. Se precisar padronizar seus campos antes de mapear, veja [Configuração de Campos](/docs/configuracoes/campos-personalizados).

<Callout type="tip" title="Dica prática">
  Você não precisa mapear tudo de uma vez. Comece pelos campos mais importantes e, depois que estiver funcionando, complete o restante.
</Callout>

🔄 O que é criado no Salesforce [#-o-que-é-criado-no-salesforce]

Quando um lead é enviado, o GS Engage monta o registro completo no Salesforce, evitando duplicidades. Veja o que acontece com cada objeto.

🏢 Organização (Account) [#-organização-account]

O GS Engage primeiro **procura uma conta existente** — pelo site da empresa e, em seguida, pelo nome. Para consultar os dados do lead antes do envio, veja a [Página do Lead](/docs/gerenciamento/pagina-do-lead).

<FieldInfoGroup>
  <FieldInfo title="Se a conta já existir">
    O lead é vinculado à conta existente. O GS Engage apenas **preenche campos que estiverem vazios** — ele nunca sobrescreve dados que já existem no Salesforce.
  </FieldInfo>

  <FieldInfo title="Se a conta não existir">
    Uma nova Organização é criada com nome, site, cidade, estado e segmento do lead (quando disponíveis).
  </FieldInfo>
</FieldInfoGroup>

👤 Contato (Contact) [#-contato-contact]

O GS Engage **procura um contato existente** pelo e-mail e, depois, pelo telefone.

<FieldInfoGroup>
  <FieldInfo title="Se o contato já existir">
    O lead é vinculado ao contato existente, preenchendo apenas os campos que estiverem em branco.
  </FieldInfo>

  <FieldInfo title="Se o contato não existir">
    Um novo Contato é criado com nome, sobrenome, e-mail, telefone, celular e cargo, já vinculado à Organização.
  </FieldInfo>
</FieldInfoGroup>

🎯 Oportunidade (Opportunity) [#-oportunidade-opportunity]

Para cada lead enviado, uma Oportunidade é criada e ligada à Organização e ao Contato.

<FieldInfoGroup>
  <FieldInfo title="Nome da oportunidade">
    Montado no formato **Nome do lead \[Empresa]**, para você identificar rapidamente o negócio.
  </FieldInfo>

  <FieldInfo title="Estágio">
    Recebe o <TextHighlight>Estágio da Oportunidade</TextHighlight> que você escolher na cadência (veja a próxima seção).
  </FieldInfo>

  <FieldInfo title="Dono">
    O responsável pela oportunidade é definido entre os usuários habilitados na cadência.
  </FieldInfo>
</FieldInfoGroup>

🕒 Atividades e anotações [#-atividades-e-anotações]

As ações executadas na cadência são registradas automaticamente no Salesforce, vinculadas ao Contato e à Oportunidade — **sem necessidade de mapear tipos de atividade**.

| Ação no GS Engage                          | Registro no Salesforce                           |
| ------------------------------------------ | ------------------------------------------------ |
| Ligação                                    | Tarefa concluída (com tipo e duração da ligação) |
| E-mail enviado                             | Tarefa concluída (com assunto e conteúdo)        |
| Reunião agendada                           | Evento (com data, horário e descrição)           |
| Mensagem de LinkedIn, WhatsApp ou Pesquisa | Tarefa concluída                                 |
| Anotação da cadência                       | Nota no registro                                 |

🎯 Integrar uma cadência com o Salesforce [#-integrar-uma-cadência-com-o-salesforce]

Aqui você configura uma cadência para **enviar leads ao Salesforce** e define o estágio da oportunidade e quem recebe o lead quando ele for marcado como ganho. Se 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 Salesforce">
    Liga ou desliga a integração do Salesforce para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
  </FieldInfo>

  <FieldInfo title="Estágio da Oportunidade">
    Escolhe em qual estágio a oportunidade será criada no Salesforce. A lista mostra os estágios ativos e ainda em aberto do seu funil.
  </FieldInfo>

  <FieldInfo title="Usuários que poderão receber o Lead Ganho">
    Seleciona os usuários do Salesforce elegíveis para se tornar donos da oportunidade quando o lead for ganho. Você pode escolher mais de um.
  </FieldInfo>

  <FieldInfo title="Enviar Leads Ganhos de maneira">
    Escolhe se a distribuição do lead ganho será <TextHighlight>Manual</TextHighlight> (você escolhe o usuário) ou <TextHighlight>Automática</TextHighlight> (o sistema distribui entre os usuários selecionados).
  </FieldInfo>
</FieldInfoGroup>

<Steps>
  <Step num={1} title="Edite a cadência e abra Integrações">
    No <TextHighlight>Banco de Cadências</TextHighlight>, edite a cadência desejada e acesse a seção <TextHighlight>Integrações</TextHighlight>.
  </Step>

  <Step num={2} title="Ative o envio para o Salesforce">
    Abra o bloco <TextHighlight>Integração da Cadência com o Salesforce</TextHighlight> e ligue o switch <TextHighlight>Enviar Leads desta Cadência para o Salesforce</TextHighlight>.
  </Step>

  <Step num={3} title="Escolha o estágio e os usuários">
    Selecione o <TextHighlight>Estágio da Oportunidade</TextHighlight> e os <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="Cadência com IA">
  Em cadências no modo com IA, a distribuição fica sempre <TextHighlight>Automática</TextHighlight> — a opção <TextHighlight>Manual</TextHighlight> não fica disponível.
</Callout>

<Callout type="tip" title="Dono garantido">
  Se o usuário preferido estiver inativo no Salesforce no momento do envio, o GS Engage atribui a oportunidade a outro usuário ativo da lista, evitando que o lead fique sem dono.
</Callout>

⛔ Desconectar a integração [#-desconectar-a-integração]

Para desligar totalmente a integração com o Salesforce:

<Steps>
  <Step num={1} title="Abra o cartão Salesforce">
    Vá em <TextHighlight>Ajustes e Permissões</TextHighlight> > <TextHighlight>Integrações</TextHighlight> e localize o cartão <TextHighlight>Salesforce</TextHighlight> (status <TextHighlight>Conectado</TextHighlight>).
  </Step>

  <Step num={2} title="Clique em Desconectar e confirme">
    Clique em <TextHighlight>Desconectar</TextHighlight> e confirme a ação na janela que aparece.
  </Step>
</Steps>

<Callout type="warning" title="Atenção ao desconectar">
  Ao desconectar, o envio de leads para o Salesforce e os mapeamentos de campos deixam de funcionar. Para voltar a integrar, refaça o login e revise o mapeamento.
</Callout>

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

<FAQ>
  <FAQItem question="Por que preciso criar um aplicativo dentro do meu Salesforce?">
    Porque o Salesforce passou a exigir isso. A partir de 2026, a plataforma bloqueia integrações que usam um aplicativo compartilhado de outra organização — cada empresa precisa ter o seu, criado e autorizado pelo próprio administrador.

    Na prática isso é bom para você: o acesso fica sob controle da sua equipe, com escopos visíveis e revogação a qualquer momento, direto no Salesforce.
  </FAQItem>

  <FAQItem question="Preciso digitar minha senha do Salesforce no GS Engage?">
    Não. Você informa apenas os dois códigos do aplicativo (<TextHighlight>Chave do consumidor</TextHighlight> e <TextHighlight>Segredo do consumidor</TextHighlight>). O login em si acontece na tela oficial do Salesforce, e sua senha nunca passa pelo GS Engage.
  </FAQItem>

  <FAQItem question="A autorização falhou e apareceu uma mensagem de erro. O que fazer?">
    A tela de retorno mostra o motivo informado pelo Salesforce. Confira, nessa ordem:

    * O **ambiente** escolhido no GS Engage (Produção ou Sandbox) é o mesmo em que o aplicativo foi criado.
    * A **URL de retorno** no aplicativo está exatamente igual à exibida na tela de conexão do GS Engage (sem barra a mais no final).
    * Os dois códigos foram colados **sem espaços** sobrando.
    * Os **dois escopos** (`api` e `refresh_token, offline_access`) estão selecionados.
    * O aplicativo foi salvo há mais de 30 minutos (é o tempo que o Salesforce leva para liberá-lo).
    * Seu usuário tem permissão de uso do aplicativo — se a organização exige aprovação prévia, o administrador precisa pré-autorizar o seu perfil.

    Se o erro persistir, abra uma solicitação para o time com a mensagem exata que apareceu na tela.
  </FAQItem>

  <FAQItem question="Posso usar um ambiente de testes (sandbox) do Salesforce?">
    Pode. Crie o aplicativo no sandbox e, na tela de conexão do GS Engage, escolha <TextHighlight>Sandbox</TextHighlight> em <TextHighlight>Ambiente do Salesforce</TextHighlight>.

    Ambientes de teste têm endereço de login próprio: se você deixar <TextHighlight>Produção</TextHighlight> selecionado, o login não encontra seu usuário e a conexão falha.
  </FAQItem>

  <FAQItem question="O GS Engage vai sobrescrever dados que já existem no Salesforce?">
    Não. Ao encontrar uma conta ou contato já existente, o GS Engage apenas **preenche campos vazios**. Dados já preenchidos no Salesforce são mantidos.
  </FAQItem>

  <FAQItem question="Como o GS Engage evita registros duplicados?">
    As contas são procuradas pelo site e pelo nome da empresa; os contatos, pelo e-mail e pelo telefone. Se já existirem, o lead é vinculado ao registro encontrado em vez de criar um novo.
  </FAQItem>

  <FAQItem question="Preciso mapear os tipos de atividade?">
    Não. As ligações, e-mails, reuniões e mensagens da cadência são registradas automaticamente como Tarefas, Eventos e Notas no Salesforce, sem configuração de tipos.
  </FAQItem>

  <FAQItem question="Preciso reconectar quando o acesso expirar?">
    Não. O acesso é renovado automaticamente. Você só precisa reconectar se desconectar a integração ou se o acesso for revogado no próprio Salesforce.
  </FAQItem>
</FAQ>

📚 Artigos relacionados [#-artigos-relacionados]

<RelatedArticles>
  <RelatedArticle href="/docs/o-que-e-o-gs-engage" title="O que é o GS Engage" description="Entenda o papel do GS Engage na sua operação de prospecção e vendas." />

  <RelatedArticle href="/docs/gerenciamento/leads" title="Leads" description="Gerencie seus leads e acompanhe o que é enviado ao CRM." />

  <RelatedArticle href="/docs/gerenciamento/cadencias" title="Como criar uma cadência" description="Crie uma cadência e configure o envio de leads para o Salesforce." />

  <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/pipedrive" title="Integração Pipedrive" description="Referência de integração de CRM com lógica semelhante de mapeamento." />

  <RelatedArticle href="/docs/integracoes/kommo" title="Integração Kommo CRM" description="Outra integração de CRM com mapeamento de campos e cadências." />
</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>