[Extensão] Como integrar o Bitrix24 ao Blip

1. Introdução

2. Funcionalidades

3. Pré-requisitos

4. Instalação e configuração

5. Exemplos de uso

6. Boas práticas

7. Suporte

Descrição breve: Crie leads, contatos e empresas no CRM Bitrix24 automaticamente a partir das conversas do seu chatbot no Blip, usando os dados coletados durante o atendimento.

Introdução

A extensão Bitrix24 conecta o seu chatbot do Blip ao CRM Bitrix24. Durante uma conversa, o fluxo envia os dados que o contato informou (nome, e-mail, telefone e outros) direto para o Bitrix24 e cria um lead, um contato ou uma empresa, sem que a equipe precise cadastrar nada manualmente.

Por exemplo, quando um cliente informa nome, e-mail e telefone no atendimento pelo WhatsApp, o fluxo cria um lead no Bitrix24 já preenchido com essas informações. A extensão é desenvolvida pela Wiv e está disponível na Blip Store.

Funcionalidades

• Criar leads no Bitrix24 com os dados coletados na conversa.

• Ao criar um lead, vincular automaticamente um contato (quando há telefone ou e-mail) e uma empresa (quando há nome de empresa).

• Criar contatos no Bitrix24.

• Criar empresas no Bitrix24.

• Preencher os campos do registro com valores fixos ou variáveis do Blip. Os campos disponíveis variam conforme o tipo de registro: e-mail, telefone, site e parâmetros UTM (source, medium, campaign, content e term) valem para lead, contato e empresa; nome vale para lead e contato; título vale para lead e empresa; e nome da empresa, endereço e cidade valem apenas para o lead.

• Salvar o resultado da operação em uma variável de retorno do fluxo, para tratar sucesso ou erro nos blocos seguintes.

Suportada nos seguintes canais: todos os canais disponíveis na plataforma Blip.

Pré-requisitos

Antes de começar, você precisa de:

• Acesso administrativo à sua conta Bitrix24.

• Acesso ao bot no Blip onde a extensão será usada.

• Google Chrome, para instalar a extensão do Builder (ver passo 5).

Instalação e configuração

Siga os passos abaixo para ativar a extensão, conectar sua conta Bitrix24 e usar a integração dentro de um fluxo.

1. Ative a extensão e instale no bot

Ative a extensão Bitrix24 na Blip Store e instale-a no bot de atendimento onde você monta o fluxo no Builder. A extensão passa a aparecer entre as instaladas do bot.

2. Crie o webhook no Bitrix24

Entre na sua conta do Bitrix24 e selecione o ambiente que será integrado.

No menu lateral, acesse Aplicativos > Recursos para desenvolvedor.

Selecione Outro > Webhook de entrada.

Na tela de configuração, copie o primeiro link exibido no campo do webhook. Esse endereço conecta o Bitrix24 à extensão no Blip, então guarde-o para o passo 4.

Atenção: o endereço do webhook funciona como uma credencial de acesso. Não compartilhe esse link publicamente.

Se tiver dúvida sobre onde encontrar esse endereço, veja o vídeo: 

3. Configure as permissões do webhook

Ainda na configuração do webhook, habilite a permissão CRM (crm) e clique em Salvar. Sem essa permissão, a extensão não consegue criar leads, contatos ou empresas no Bitrix24.

4. Conecte o Bitrix24 ao Blip

No Blip, abra a extensão Bitrix24 no bot em que ela foi instalada. No campo Webhook Url (Inbound), cole o endereço copiado no Bitrix24 e clique em Salvar. A conexão com o seu CRM fica ativa.

5. Instale a extensão do Builder no navegador

Na tela de configuração, clique em Instalar extensão. Uma nova aba abre na Chrome Web Store.

Clique em Usar no Chrome ou Adicionar ao Chrome e, ao terminar, volte para o Blip e atualize a página.

Nota: cada pessoa que for configurar as ações da extensão no Builder precisa instalar essa extensão no próprio navegador.

6. Adicione a integração ao fluxo

Abra o Builder do bot e clique em Adicionar bloco > Nova integração.

Selecione o novo bloco, abra a área de ações e clique em Integração. Em seguida, configure a ação do Bitrix24:

• Em Bitrix, escolha o tipo de registro: Contato, Lead ou Empresa.

• Em Ação, escolha a operação (Criar contato, Criar lead ou Criar empresa).

• Preencha os campos com valores fixos ou variáveis do Blip.

• Em Variavel de resultado, informe a variável que vai guardar o retorno da operação.

7. Publique e teste

Salve o bloco e clique em Publicar, no ícone de foguete. Inicie uma conversa de teste, percorra o caminho do fluxo que contém a integração e confira no Bitrix24 se o lead, contato ou empresa foi criado.

Consulte também a variável de retorno configurada no bloco: ela mostra o resultado da operação ou o detalhe de um eventual erro.

Exemplos de uso

Para preencher um registro com dados que o contato informou na conversa, use variáveis do Blip nos campos da ação, por exemplo:

• Nome: {{contact.name}}

• Telefone: {{contact.phoneNumber}}

• E-mail: {{contact.email}}

Você também pode usar variáveis criadas no próprio fluxo, como {{lead.email}} ou {{lead.cidade}}, desde que já tenham sido preenchidas antes do bloco de integração.

Boas práticas

• Teste a integração primeiro em um bot ou ambiente de homologação.

• Use a variável de retorno para acompanhar o resultado e tratar erros no fluxo.

• Confirme que os campos obrigatórios do Bitrix24 estão sendo enviados.

• Nunca exponha o webhook em mensagens, documentos públicos ou capturas de tela. Se ele vazar, revogue-o no Bitrix24 e gere um novo.

Suporte

Em caso de dúvidas ou dificuldades na configuração, fale com o suporte da Wiv pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃