# 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.

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



<PageHero emoji="🔌" title="Integração Bitrix24 CRM" description="Conecte o Bitrix24 ao GS Engage em poucos cliques, mapeie os campos do lead e leve seus negócios direto para o pipeline e o estágio certos." gradient="brand" />

Esta integração liga o **Bitrix24 CRM** ao **GS Engage**. Assim, os leads trabalhados nas suas cadências viram **empresas, contatos e negócios** no Bitrix24 automaticamente, sem digitação manual e sem perder o histórico.

Neste artigo você vai aprender a **conectar o Bitrix24 ao GS Engage** (via OAuth, sem precisar copiar chaves), a **mapear os campos do lead** e a **configurar o envio de leads** de uma cadência para um pipeline do Bitrix24.

Se você ainda está entendendo o produto, vale conhecer primeiro [o que é o GS Engage](/docs/o-que-e-o-gs-engage). Para ver os dados do lead que serão enviados, consulte também [Gerenciamento de Leads](/docs/gerenciamento/leads).

<Callout type="info" title="Antes de começar">
  Se você não enxergar a seção de <TextHighlight>Integrações</TextHighlight> ou a opção <TextHighlight>Bitrix24</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 Bitrix24 se conecta [#-como-o-bitrix24-se-conecta]

Diferente de integrações por chave de API, o Bitrix24 usa **OAuth**. Na prática, isso significa que você **não precisa copiar tokens nem chaves**: você apenas informa o **domínio do seu portal** e autoriza a conexão dentro do próprio Bitrix24.

<FieldInfoGroup>
  <FieldInfo title="Domínio do Portal" required>
    O endereço completo do seu Bitrix24, no formato `https://empresa.bitrix24.com.br`.

    É o único dado que você digita. A partir dele, o GS Engage abre a tela de autorização do Bitrix24.
  </FieldInfo>

  <FieldInfo title="Autorização (OAuth)">
    Depois de informar o domínio, você faz login e autoriza o acesso dentro do Bitrix24.

    O GS Engage recebe e guarda o acesso de forma segura, e **renova sozinho** quando necessário — você não precisa reconectar de tempos em tempos.
  </FieldInfo>
</FieldInfoGroup>

<Callout type="info" title="O que é o Domínio do Portal?">
  É o começo do endereço do seu Bitrix24 no navegador. Por exemplo, se você acessa `https://minhaempresa.bitrix24.com.br`, esse endereço completo é o seu Domínio do Portal.
</Callout>

🔗 Conectar o Bitrix24 ao GS Engage [#-conectar-o-bitrix24-ao-gs-engage]

Aqui você faz a conexão uma única vez. Depois, basta ajustar os mapeamentos de campos e as cadências.

<Steps>
  <Step num={1} title="Abra Ajustes e Permissões">
    No menu do GS Engage, acesse <TextHighlight>Ajustes e Permissões</TextHighlight> e localize a área de <TextHighlight>Integrações</TextHighlight>.
  </Step>

  <Step num={2} title="Abra o cartão do Bitrix24">
    Na lista de integrações, clique em <TextHighlight>Bitrix24</TextHighlight>.

    No topo do cartão, você verá o status atual: <TextHighlight>Desconectado</TextHighlight> (em vermelho) ou <TextHighlight>Conectado</TextHighlight> (em verde).
  </Step>

  <Step num={3} title="Informe o Domínio do Portal">
    No campo <TextHighlight>Domínio do Portal</TextHighlight>, digite o endereço completo do seu Bitrix24, por exemplo `https://empresa.bitrix24.com.br`.

    O botão de conexão só habilita quando o domínio está no formato correto.
  </Step>

  <Step num={4} title="Clique em Conectar com Bitrix24">
    Clique no botão <TextHighlight>Conectar com Bitrix24</TextHighlight>. Uma janela do Bitrix24 será aberta para você fazer login e **autorizar o acesso**.
  </Step>

  <Step num={5} title="Confirme o status Conectado">
    Ao concluir a autorização, a janela fecha e o cartão passa a exibir <TextHighlight>Conectado</TextHighlight>, junto com o <TextHighlight>Portal</TextHighlight> vinculado.

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

<Callout type="warning" title="Atenção ao formato do domínio">
  Use sempre o endereço completo, começando com <TextHighlight>https\://</TextHighlight> e terminando no domínio do Bitrix24 (por exemplo, `.bitrix24.com.br`).

  Se o formato estiver errado, o GS Engage avisa e o botão de conexão fica desabilitado.
</Callout>

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

Depois de conectar, você define **quais dados do lead** vão para **qual objeto e campo** do Bitrix24. O mapeamento é organizado em abas:

* <TextHighlight>Campos Padrão</TextHighlight> — campos comuns do GS Engage (nome, e-mail, empresa etc.).
* <TextHighlight>Campos Personalizados</TextHighlight> — os campos que a sua empresa criou no GS Engage.

<Callout type="tip" title="Sugestão automática de mapeamento">
  Ao conectar, o GS Engage pode **analisar seus campos e sugerir associações automaticamente**. Revise as sugestões, ajuste o que for necessário e salve. Se aparecer a aba <TextHighlight>Sugestões de Campos</TextHighlight>, ela reúne campos novos que valem a pena mapear.
</Callout>

Para cada campo do GS Engage, você escolhe duas coisas:

<FieldInfoGroup>
  <FieldInfo title="Seção do Bitrix24">
    Define *em qual objeto* o dado será salvo:

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

  <FieldInfo title="Campo do Bitrix24">
    Define *qual campo exato* dentro daquele objeto vai receber o valor.

    Só ficam disponíveis campos **editáveis** do Bitrix24 — campos somente leitura não aparecem na lista.
  </FieldInfo>
</FieldInfoGroup>

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

<Steps>
  <Step num={1} title="Escolha a aba">
    Na tela do Bitrix24, escolha entre <TextHighlight>Campos Padrão</TextHighlight> e <TextHighlight>Campos Personalizados</TextHighlight>.
  </Step>

  <Step num={2} title="Defina a Seção do Bitrix24">
    Na linha do campo, selecione onde ele deve ser gravado: <TextHighlight>Negócio</TextHighlight>, <TextHighlight>Contato</TextHighlight> ou <TextHighlight>Empresa</TextHighlight>.
  </Step>

  <Step num={3} title="Escolha o Campo do Bitrix24 e salve">
    Selecione o campo correspondente do Bitrix24. Ao fazer qualquer alteração, aparece a barra de <TextHighlight>alterações não salvas</TextHighlight> — clique em salvar para aplicar.
  </Step>
</Steps>

<Callout type="tip" title="Dica prática">
  Você não precisa mapear tudo de uma vez. Comece pelos campos essenciais, valide o envio e depois complete o restante. Para criar ou padronizar campos antes de mapear, veja [Configuração de Campos](/docs/configuracoes/campos-personalizados).
</Callout>

🔄 O que o GS Engage cria no Bitrix24 [#-o-que-o-gs-engage-cria-no-bitrix24]

Quando um lead é enviado por uma cadência integrada, o GS Engage monta o registro completo no Bitrix24, na seguinte ordem:

| No GS Engage           | Vira no Bitrix24        | Como funciona                                                                                                                                          |
| ---------------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Empresa do lead        | **Empresa** (Company)   | Busca por uma empresa com o mesmo nome; se existir, reaproveita e só preenche campos vazios. Envia site, cidade, estado e segmento quando disponíveis. |
| Contato do lead        | **Contato** (Contact)   | Busca por e-mail e depois por telefone; se já existir, reaproveita e completa campos vazios. Envia nome, sobrenome, e-mail, telefone e cargo.          |
| Lead trabalhado        | **Negócio** (Deal)      | Cria o negócio com título no formato `Nome [Empresa]`, vinculado ao contato e à empresa, no pipeline e estágio configurados.                           |
| Atividades e anotações | **Timeline do negócio** | As ações da cadência são registradas como atividades e comentários no histórico do negócio.                                                            |

<Callout type="info" title="Sem duplicar registros">
  Antes de criar, o GS Engage **procura registros existentes** (empresa por nome, contato por e-mail/telefone). Quando encontra, ele reaproveita o registro e apenas completa os campos que estavam em branco — evitando duplicatas no seu CRM.
</Callout>

👥 Definição do dono do negócio [#-definição-do-dono-do-negócio]

O **dono (responsável)** do negócio no Bitrix24 é definido a partir dos usuários que você seleciona na configuração da cadência.

<FieldInfoGroup>
  <FieldInfo title="Distribuição entre usuários">
    O GS Engage escolhe o responsável entre os usuários configurados para a cadência. Se o usuário preferido não estiver ativo no Bitrix24, ele **usa outro usuário ativo** da lista como alternativa.
  </FieldInfo>

  <FieldInfo title="Vínculo automático">
    O responsável definido é aplicado à empresa, ao contato e ao negócio criados — tudo já sai atribuído à pessoa certa.
  </FieldInfo>
</FieldInfoGroup>

🎯 Integrar uma cadência com o Bitrix24 [#-integrar-uma-cadência-com-o-bitrix24]

Aqui você configura uma cadência para **enviar leads para um pipeline do Bitrix24** e definir quem recebe o lead quando ele for marcado como **ganho**.

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 Bitrix24">
    Liga ou desliga a integração do Bitrix24 para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
  </FieldInfo>

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

  <FieldInfo title="Estágio do Pipeline do Bitrix24">
    Escolha em qual etapa do pipeline o negócio vai ficar ao ser criado.
  </FieldInfo>

  <FieldInfo title="Usuários que poderão receber o Lead Ganho">
    Selecione um ou mais usuários elegíveis para receber o lead quando ele virar “ganho”.
  </FieldInfo>

  <FieldInfo title="Enviar Leads Ganhos de maneira">
    Escolha entre <TextHighlight>Manual</TextHighlight> (você define para quem enviar) ou <TextHighlight>Automática</TextHighlight> (distribuição alternada entre os usuários selecionados).
  </FieldInfo>
</FieldInfoGroup>

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

  <Step num={2} title="Ative o envio para o Bitrix24">
    Ligue o switch <TextHighlight>Enviar Leads desta Cadência para o Bitrix24</TextHighlight>. Os campos de configuração ficam habilitados.
  </Step>

  <Step num={3} title="Escolha Pipeline e Estágio">
    Selecione o <TextHighlight>Pipeline do Bitrix24</TextHighlight> e, em seguida, o <TextHighlight>Estágio do Pipeline do Bitrix24</TextHighlight>.
  </Step>

  <Step num={4} title="Selecione os usuários elegíveis">
    Em <TextHighlight>Usuários que poderão receber o Lead Ganho</TextHighlight>, escolha um ou mais usuários. Use a busca se a lista for grande.
  </Step>

  <Step num={5} title="Defina o modo 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="tip" title="Dica prática">
  Na dúvida, comece com <TextHighlight>Manual</TextHighlight> para acompanhar de perto os primeiros envios. Depois de validar o comportamento, troque para <TextHighlight>Automática</TextHighlight>.
</Callout>

<Callout type="warning" title="Cuidado com Automática">
  No modo <TextHighlight>Automática</TextHighlight>, o envio acontece sem confirmação. Revise bem o <TextHighlight>Pipeline</TextHighlight> e o <TextHighlight>Estágio</TextHighlight> antes de salvar.
</Callout>

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

Aqui você desliga totalmente a integração. Isso é útil se você trocou de CRM, mudou de portal no Bitrix24 ou quer reconfigurar do zero.

<Callout type="warning" title="Atenção: impacto alto">
  Ao desconectar, os mapeamentos de campos e as integrações configuradas nas <TextHighlight>Cadências</TextHighlight> deixam de funcionar. Você pode precisar configurar tudo novamente ao reconectar.
</Callout>

<Steps>
  <Step num={1} title="Abra o cartão do Bitrix24">
    Em <TextHighlight>Ajustes e Permissões</TextHighlight> > <TextHighlight>Integrações</TextHighlight> > <TextHighlight>Bitrix24</TextHighlight>, com o status <TextHighlight>Conectado</TextHighlight>, clique em <TextHighlight>Desconectar</TextHighlight>.
  </Step>

  <Step num={2} title="Confirme no modal">
    Confirme a ação na janela de confirmação. Após desconectar, o status volta para <TextHighlight>Desconectado</TextHighlight>.
  </Step>
</Steps>

<Callout type="tip" title="Para reconectar depois">
  Basta informar o <TextHighlight>Domínio do Portal</TextHighlight> novamente e autorizar. Depois, revise o mapeamento de campos e as cadências integradas.
</Callout>

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

<FAQ>
  <FAQItem question="Preciso copiar alguma chave de API ou token do Bitrix24?">
    Não. A conexão é feita por **OAuth**: você informa apenas o <TextHighlight>Domínio do Portal</TextHighlight> e autoriza o acesso dentro do próprio Bitrix24. O acesso é renovado automaticamente pelo GS Engage.
  </FAQItem>

  <FAQItem question="Onde encontro o Domínio do Portal?">
    É o endereço do seu Bitrix24 no navegador, no formato `https://empresa.bitrix24.com.br`. Copie o endereço completo, começando por `https://`.
  </FAQItem>

  <FAQItem question="A integração vai duplicar minhas empresas e contatos?">
    Não. Antes de criar, o GS Engage procura registros existentes (empresa pelo nome, contato pelo e-mail e depois pelo telefone). Se já existir, ele reaproveita o registro e só preenche os campos que estavam vazios.
  </FAQItem>

  <FAQItem question="Como o dono do negócio é definido?">
    A partir dos usuários selecionados na configuração da cadência. Se o usuário preferido não estiver ativo no Bitrix24, o GS Engage atribui a outro usuário ativo da lista.
  </FAQItem>

  <FAQItem question="Um campo que mapeei não apareceu no Bitrix24. O que pode ser?">
    Verifique se a <TextHighlight>Seção do Bitrix24</TextHighlight> não está como <TextHighlight>Não Associar</TextHighlight> e se você salvou as alterações. Campos somente leitura do Bitrix24 não recebem valores e não aparecem para mapeamento.
  </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 e onde as integrações de CRM se encaixam." />

  <RelatedArticle href="/docs/gerenciamento/leads" title="Gerenciamento de Leads" description="Veja os dados do lead que são enviados para o seu 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 Bitrix24." />

  <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 CRM" description="Referência para integrações de CRM com lógica semelhante de mapeamento e cadências." />

  <RelatedArticle href="/docs/integracoes/kommo" title="Integração Kommo CRM" description="Conecte o Kommo ao GS Engage e mapeie atividades e campos." />
</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>