Integração Salesforce CRM
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.
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.
Antes de começar
Se você não enxergar o menu Integrações ou o cartão Salesforce, 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 Ajustes e Permissões.
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.
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.
Com o aplicativo criado, você clica em Conectar com Salesforce, faz login na tela oficial do Salesforce e autoriza o acesso. O GS Engage recebe a permissão de forma segura.
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.
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.
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 é.
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.
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 Ajustes e Permissões > Integrações > Salesforce — copie de lá para evitar erro de digitação.
Entre na Configuração do Salesforce
No Salesforce, clique na engrenagem (canto superior direito) e escolha Configuração.
Use um usuário com perfil de administrador do sistema.
Abra o Gerenciador de aplicativos
Na Busca rápida, digite App Manager e abra o Gerenciador de aplicativos.
Crie um novo aplicativo
Clique em New External Client App.
Preencha o nome (por exemplo, GS Engage) e o e-mail de contato. Em Distribution State, mantenha a opção Local.
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.
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.
Revise quem pode usar o aplicativo
Em Policies, 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.
Salve e copie os dois códigos
Salve o aplicativo. Depois abra-o novamente e vá em Settings > OAuth Settings > Consumer Key and Secret — o Salesforce pode pedir para você confirmar sua identidade.
Copie a Chave do consumidor (Consumer Key) e o Segredo do consumidor (Consumer Secret). São esses dois valores que o GS Engage pede na próxima seção.
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.
O Segredo do consumidor é uma senha
Trate o Segredo do consumidor 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.
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.
Abra a área de Ajustes
No menu do GS Engage, acesse Ajustes e Permissões.
Entre em Integrações > Salesforce
Na lista de integrações, localize o cartão Salesforce.
Enquanto não estiver conectado, ele exibe o status Desconectado (em vermelho).
Escolha o ambiente e informe os dois códigos
Em Ambiente do Salesforce, escolha Produção ou Sandbox — precisa ser o mesmo ambiente onde o aplicativo foi criado.
Cole a Chave do consumidor (Consumer Key) e o Segredo do consumidor (Consumer Secret), conferindo se não sobrou espaço no começo ou no fim.
Clique em Conectar com Salesforce
Clique no botão azul Conectar com Salesforce.
Uma janela do Salesforce será aberta para você fazer login e autorizar o acesso.
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.
Confirme o status Conectado
Ao concluir, a janela se fecha e o cartão passa a exibir o status Conectado (em verde).
A partir daí, o mapeamento de campos e as cadências integradas ficam disponíveis.
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.
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:
Guarda os dados da empresa do lead: nome da empresa, site, cidade, estado e segmento.
Guarda os dados da pessoa: nome, sobrenome, e-mail, telefone, celular e cargo. Fica vinculado à Organização.
Representa o negócio em aberto. É criada para cada lead enviado e recebe o estágio e o dono definidos.
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.
Define o destino do dado: Organização, Contato, Oportunidade ou Não Associar.
Define qual campo exato do objeto escolhido vai receber o valor. Só aparecem os campos que o Salesforce permite gravar.
Regra de envio
Se o objeto estiver como Não Associar, o campo não será enviado ao Salesforce.
📇 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 podem ser livremente associados aos campos correspondentes do Salesforce. Se precisar padronizar seus campos antes de mapear, veja Configuração de Campos.
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.
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)
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.
O lead é vinculado à conta existente. O GS Engage apenas preenche campos que estiverem vazios — ele nunca sobrescreve dados que já existem no Salesforce.
Uma nova Organização é criada com nome, site, cidade, estado e segmento do lead (quando disponíveis).
👤 Contato (Contact)
O GS Engage procura um contato existente pelo e-mail e, depois, pelo telefone.
O lead é vinculado ao contato existente, preenchendo apenas os campos que estiverem em branco.
Um novo Contato é criado com nome, sobrenome, e-mail, telefone, celular e cargo, já vinculado à Organização.
🎯 Oportunidade (Opportunity)
Para cada lead enviado, uma Oportunidade é criada e ligada à Organização e ao Contato.
Montado no formato Nome do lead [Empresa], para você identificar rapidamente o negócio.
Recebe o Estágio da Oportunidade que você escolher na cadência (veja a próxima seção).
O responsável pela oportunidade é definido entre os usuários habilitados na cadência.
🕒 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 |
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.
Liga ou desliga a integração do Salesforce para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
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.
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.
Escolhe se a distribuição do lead ganho será Manual (você escolhe o usuário) ou Automática (o sistema distribui entre os usuários selecionados).
Edite a cadência e abra Integrações
No Banco de Cadências, edite a cadência desejada e acesse a seção Integrações.
Ative o envio para o Salesforce
Abra o bloco Integração da Cadência com o Salesforce e ligue o switch Enviar Leads desta Cadência para o Salesforce.
Escolha o estágio e os usuários
Selecione o Estágio da Oportunidade e os Usuários que poderão receber o Lead Ganho.
Defina Manual ou Automática e salve
Em Enviar Leads Ganhos de maneira, escolha Manual ou Automática e salve a cadência.
Cadência com IA
Em cadências no modo com IA, a distribuição fica sempre Automática — a opção Manual não fica disponível.
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.
Para desligar totalmente a integração com o Salesforce:
Abra o cartão Salesforce
Vá em Ajustes e Permissões > Integrações e localize o cartão Salesforce (status Conectado).
Clique em Desconectar e confirme
Clique em Desconectar e confirme a ação na janela que aparece.
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.
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.
Preciso digitar minha senha do Salesforce no GS Engage?
Não. Você informa apenas os dois códigos do aplicativo (Chave do consumidor e Segredo do consumidor). O login em si acontece na tela oficial do Salesforce, e sua senha nunca passa pelo GS Engage.
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 (
apierefresh_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.
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 Sandbox em Ambiente do Salesforce.
Ambientes de teste têm endereço de login próprio: se você deixar Produção selecionado, o login não encontra seu usuário e a conexão falha.
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.
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.
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.
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.
Ainda precisa de ajuda?
Se você continuar com dúvidas, abra uma solicitação para o time:
Central de Solicitações
Sua opinião importa
Este guia resolveu sua dúvida?
Leva poucos segundos e ajuda a manter a KB realmente útil.
Integração HubSpot CRM
Conecte o HubSpot ao GS Engage por OAuth e envie automaticamente empresas, contatos, negócios e atividades das suas cadências.
Integração Bitrix24 CRM
Conecte o Bitrix24 ao GS Engage por OAuth, mapeie os campos do lead e envie negócios para o pipeline certo, com dono e estágio definidos.