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.
Integração Bitrix24 CRM
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.
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. Para ver os dados do lead que serão enviados, consulte também Gerenciamento de Leads.
Antes de começar
Se você não enxergar a seção de Integrações ou a opção Bitrix24, 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.
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.
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.
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.
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.
Aqui você faz a conexão uma única vez. Depois, basta ajustar os mapeamentos de campos e as cadências.
Abra Ajustes e Permissões
No menu do GS Engage, acesse Ajustes e Permissões e localize a área de Integrações.
Abra o cartão do Bitrix24
Na lista de integrações, clique em Bitrix24.
No topo do cartão, você verá o status atual: Desconectado (em vermelho) ou Conectado (em verde).
Informe o Domínio do Portal
No campo Domínio do Portal, 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.
Clique em Conectar com Bitrix24
Clique no botão Conectar com Bitrix24. Uma janela do Bitrix24 será aberta para você fazer login e autorizar o acesso.
Confirme o status Conectado
Ao concluir a autorização, a janela fecha e o cartão passa a exibir Conectado, junto com o Portal vinculado.
A partir daí, o mapeamento de campos fica disponível para configurar.
Atenção ao formato do domínio
Use sempre o endereço completo, começando com https:// 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.
Depois de conectar, você define quais dados do lead vão para qual objeto e campo do Bitrix24. O mapeamento é organizado em abas:
- Campos Padrão — campos comuns do GS Engage (nome, e-mail, empresa etc.).
- Campos Personalizados — os campos que a sua empresa criou no GS Engage.
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 Sugestões de Campos, ela reúne campos novos que valem a pena mapear.
Para cada campo do GS Engage, você escolhe duas coisas:
Define em qual objeto o dado será salvo:
Negócio, Contato, Empresa ou Não Associar.
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.
Regra de envio dos campos
Se a Seção do Bitrix24 estiver como Não Associar, aquele campo não será enviado para o Bitrix24.
Escolha a aba
Na tela do Bitrix24, escolha entre Campos Padrão e Campos Personalizados.
Defina a Seção do Bitrix24
Na linha do campo, selecione onde ele deve ser gravado: Negócio, Contato ou Empresa.
Escolha o Campo do Bitrix24 e salve
Selecione o campo correspondente do Bitrix24. Ao fazer qualquer alteração, aparece a barra de alterações não salvas — clique em salvar para aplicar.
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.
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. |
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.
O dono (responsável) do negócio no Bitrix24 é definido a partir dos usuários que você seleciona na configuração da cadência.
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.
O responsável definido é aplicado à empresa, ao contato e ao negócio criados — tudo já sai atribuído à pessoa certa.
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.
Liga ou desliga a integração do Bitrix24 para esta cadência. Quando ligado, os campos abaixo ficam disponíveis.
Escolha em qual pipeline (funil) o negócio vai entrar.
Escolha em qual etapa do pipeline o negócio vai ficar ao ser criado.
Selecione um ou mais usuários elegíveis para receber o lead quando ele virar “ganho”.
Escolha entre Manual (você define para quem enviar) ou Automática (distribuição alternada entre os usuários selecionados).
Edite a cadência e abra Integrações
Na cadência, acesse a seção Integrações e localize o bloco Integração da Cadência com o Bitrix24.
Ative o envio para o Bitrix24
Ligue o switch Enviar Leads desta Cadência para o Bitrix24. Os campos de configuração ficam habilitados.
Escolha Pipeline e Estágio
Selecione o Pipeline do Bitrix24 e, em seguida, o Estágio do Pipeline do Bitrix24.
Selecione os usuários elegíveis
Em Usuários que poderão receber o Lead Ganho, escolha um ou mais usuários. Use a busca se a lista for grande.
Defina o modo e salve
Em Enviar Leads Ganhos de maneira, escolha Manual ou Automática e salve a cadência.
Dica prática
Na dúvida, comece com Manual para acompanhar de perto os primeiros envios. Depois de validar o comportamento, troque para Automática.
Cuidado com Automática
No modo Automática, o envio acontece sem confirmação. Revise bem o Pipeline e o Estágio antes de salvar.
Aqui você desliga totalmente a integração. Isso é útil se você trocou de CRM, mudou de portal no Bitrix24 ou quer reconfigurar do zero.
Atenção: impacto alto
Ao desconectar, os mapeamentos de campos e as integrações configuradas nas Cadências deixam de funcionar. Você pode precisar configurar tudo novamente ao reconectar.
Abra o cartão do Bitrix24
Em Ajustes e Permissões > Integrações > Bitrix24, com o status Conectado, clique em Desconectar.
Confirme no modal
Confirme a ação na janela de confirmação. Após desconectar, o status volta para Desconectado.
Para reconectar depois
Basta informar o Domínio do Portal novamente e autorizar. Depois, revise o mapeamento de campos e as cadências integradas.
Preciso copiar alguma chave de API ou token do Bitrix24?
Não. A conexão é feita por OAuth: você informa apenas o Domínio do Portal e autoriza o acesso dentro do próprio Bitrix24. O acesso é renovado automaticamente pelo GS Engage.
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://.
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.
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.
Um campo que mapeei não apareceu no Bitrix24. O que pode ser?
Verifique se a Seção do Bitrix24 não está como Não Associar e se você salvou as alterações. Campos somente leitura do Bitrix24 não recebem valores e não aparecem para mapeamento.
Ainda precisa de ajuda?
Se você continuar com dúvidas, abra uma solicitação para o time:
Central de Solicitações
Este artigo foi útil?
Integração Salesforce CRM
Conecte o Salesforce ao GS Engage via login OAuth, mapeie os campos para Conta, Contato e Oportunidade e envie leads da cadência para o funil certo.
Integração Agendor CRM
Conecte o Agendor ao GS Engage com uma API Key, mapeie os campos do lead e envie negócios para o pipeline certo pela cadência.