Integração com Bitrix24 CRM

Bitrix24 é uma plataforma abrangente de gerenciamento de negócios que combina CRM, gerenciamento de projetos, ferramentas de comunicação e muito mais. A integração entre o Cloud PABX da Virtual-Call com o Bitrix24 permite gerenciamento contínuo de contatos, registro automático de chamadas e contexto do cliente em tempo real durante as chamadas. Quando integrada, sua equipe obtém acesso instantâneo às informações do cliente, pode registrar chamadas automaticamente em registros de contato e simplificar fluxos de trabalho de vendas diretamente do PBX.

Visão geral

A integração do Bitrix24 CRM oferece as seguintes capacidades:

• Sincronização de contatos: Sincronize automaticamente contatos do Bitrix24 para sua agenda telefônica do Cloud PABX para fácil pesquisa e discagem.
• Criação de contato/lead: Crie novos contatos ou leads no Bitrix24 diretamente do PABX durante ou após chamadas.
• Call Popup automático: Exiba informações relevantes do cliente do Bitrix24 em um popup do navegador quando as chamadas chegam ou são atendidas.
• Call Journal/Registro de atividades: Crie automaticamente registros de atividade de chamada no Bitrix24 com detalhes da chamada, duração e links de gravação opcionais.
• Associação de usuário: Mapeie extensões (ramais) do PABX para usuários do Bitrix24 para garantir acesso apropriado baseado em permissões e registro de atividades.

Pré-requisitos

Antes de configurar a integração do Bitrix24 CRM, certifique-se de que você tenha o seguinte:

• Conta Bitrix24: Edição Cloud (qualquer nível de plano) com acesso administrativo para gerenciar recursos para desenvolvedores e webhooks.
• Direitos de administrador: Acesso total de admin à sua conta Bitrix24 e ao sistema Cloud PABX da Virtual-Call.
• Firmware do PABX: Versão atual ou recente do firmware (verifique sua versão atual em Settings System About)
• Capacidade de Webhook: Sua rede deve permitir conexões HTTPS de saída para servidores Bitrix24 para entrega de webhook
• Correspondência de e-mail: opcional, mas recomendado. Certifique-se de que as contas de usuário do PABX utilizem endereços de e-mail que correspondam ou possam ser mapeados para e-mails de usuário Bitrix24 para associação automática de usuários.

Conectar Bitrix24 CRM

Siga estas três etapas para estabelecer a conexão entre Bitrix24 e seu Cloud PABX Virtual-Call.

Etapa 1: Crie um Webhook de entrada no Bitrix24

O webhook permite que o Cloud PABX envie informações de chamada e contato para sua instância Bitrix24. Para criar o webhook:

1. Faça login em sua conta Bitrix24 como administrador
2. Navegue para Settings Developer Resources Other Inbound Webhook
3. Clique no botão Add ou + Add Webhook
4. Selecione um usuário (preferencialmente uma conta do sistema ou serviço) que será o proprietário do webhook
5. Na seção de permissões, certifique-se de que as seguintes permissões sejam concedidas:
   • CRM: Leitura, Adição, Atualização (para sincronizar contatos, criar leads e atualizar atividades)
   • User: Leitura (para validar associações de usuário)
6. Clique em Save para gerar a URL do webhook
7. Copie a URL completa do webhook (ela se parecerá com: https://yourbitrix24domain.bitrix24.com/rest/1/xxxxx/crm.contact.list)

Etapa 2: Conecte o Bitrix24 CRM ao PABX

Agora configure a conexão no lado do Cloud PABX Virtual-Call:

1. Faça login em sua interface de admin do Cloud PABX Virtual-Call.
2. Navegue para Integração > CRM
3. Selecione Bitrix24 na lista de CRM
4. Na página de configuração, você verá os seguintes campos:
   • Bitrix24 Webhook URL: Cole a URL do webhook copiada do Bitrix24
   • Bitrix24 domínimo/endereço: Digite seu domínio Bitrix24 (ex: yourcompany.bitrix24.com) sem o protocolo.
5. Clique em Salve ou Conectar
6. Verifique se o status da conexão é exibido como “Conectado" ou mostra uma marca verde.

Etapa 3: Associe usuários Bitrix24 com extensões (ramais) PABX

A integração precisa saber qual usuário Bitrix24 cada extensão PABX representa para registro de atividades e controle de acesso apropriados:

1. Navegue para Integração > CRM > Associação de usuários (ou seção similar em seu PABX)
2. O sistema pode corresponder usuários automaticamente por endereço de email:
   • Se o e-mail de um usuário PABX corresponder ao e-mail de um usuário Bitrix24, eles serão vinculados automaticamente.
   • Revise as correspondências automáticas para garantir precisão.
3. Para usuários sem correspondência automática de e-mail, selecione manualmente o usuário Bitrix24 correspondente de uma lista suspensa
4. Salve as associações

Configurar recursos de integração

Após estabelecer a conexão, configure os recursos específicos que deseja ativar.

Sincronização de contatos

A sincronização de contatos traz seus contatos Bitrix24 para o Cloud PABX Virtual-Call, tornando-os disponíveis em agendas telefônicas para rápida pesquisa e discagem.

Como funciona: Os contatos são sincronizados em sentido único do Bitrix24 para o PABX. O PABX não modifica dados de contato do Bitrix24; em vez disso, importa informações de contato para uma agenda telefônica dedicada como referência.

Para configurar a sincronização de contatos:

1. Na interface de admin do PABX, vá para Integração > CRM > Sincronização de Contatos do Bitrix24.
2. Ative a alternância Sincronização de Contatos.
3. Selecione a agenda telefônica alvo onde contatos Bitrix24 serão importados. Geralmente, é uma agenda telefônica rotulada como “Bitrix24 Contacts” ou similar.
4. Configure a opção Always Query CRM:
   • Ativada: Cada vez que uma chamada é recebida, o PABX consulta o Bitrix24 em tempo real pelas informações do chamador. Isso garante que os detalhes de contato mais atualizados sejam exibidos, mas pode adicionar latência leve.
   • Desativada: O PABX utiliza apenas a agenda telefônica importada localmente. Resposta mais rápida, mas contatos podem estar desatualizados se mudanças ocorrerem no Bitrix24.
5. Clique em Salvar.

Criação de contato/lead

Crie automaticamente novos contatos ou leads no Bitrix24 quando você recebe ou faz chamadas de números desconhecidos.

Para ativar a criação de contatos:

1. Nas configurações de integração do Bitrix24, localize a seção Criação de contato (Contact Creation).
2. Ative a Criação automática de contatos.
3. Escolha quando novos contatos devem ser criados:
   • Em chamadas recebidas: Crie um contato quando uma chamada recebida chegar de um número não encontrado em Bitrix24.
   • Em chamadas efetuadas: Crie um contato quando sua equipe discar um número desconhecido.
   • Ambos (both): Crie contatos para chamadas recebidas e realizadas.
4. Opcionalmente, ative Criar como lead (Create as Lead Instead) se preferir que novos chamadores sejam registrados como leads em vez de contatos.
5. Clique em Salvar.

Call Popup

O call popup exibe informações relevantes do cliente Bitrix24 em um popup do navegador quando as chamadas chegam ou são conectadas. Isso dá à sua equipe contexto imediato sem sair da interface do PABX.

Para configurar o call popup:

1. Navegue para Integração > CRM > Bitrix24 Call Popup.
2. Ative a alternância Ativar janela pop-up do CRM (enable CRM Popup).
3. Configure Eventos que acionam pop-ups (popup trigger events): Selecione quando o popup deve aparecer:
   • Sobre o toque (on ringing): Mostre o popup imediatamente quando uma chamada chega (antes de atender).
   • Em “Respondida” (on answered): Mostre o popup após a chamada ser atendida.
   • Fim do plantão (on call end): Mostre o popup após a chamada ser desconectada.
   • Você pode ativar múltiplos eventos; o popup será acionado em qualquer evento selecionado.
4. Opcionalmente, se você criou rótulos de agenda telefônica CRM no seu PABX, você pode atribuir um rótulo para disparar o popup com base em qual agenda telefônica o contato foi encontrado.
5. Clique em Salvar

Utilizando o Call Popup no Virtual-Call UC Client:

Uma vez configurado, quando uma chamada dispara o popup:

1. Uma janela de popup do navegador se abre automaticamente (certifique-se de que o bloqueador de popup do seu navegador permite popups do domínio do seu PABX).
2. O pop-up exibe as informações de contato do Bitrix24, incluindo nome, telefone, empresa e qualquer campo personalizado.
3. O pop-up pode incluir botões de ação rápida para criar uma nota, registrar uma atividade ou navegar para o registro de contato no Bitrix24.
4. Se nenhum contato correspondente for encontrado, o popup pode oferecer uma opção para criar um novo contato ou lead.

Call Journal/Registro de atividades

Crie automaticamente registros de atividade de chamada no Bitrix24 para cada chamada. Esses registros de atividades fornecem um histórico de comunicação completo com cada contato e ajudam equipes a rastrear interações com clientes.

Para ativar o registro de chamadas:

1. Vá para Integração > CRM > Bitrix24 Call Journal.
2. Ative a alternância Registro automático de chamadas (automatic call logging).
3. Selecione o Tipo de atividade (activity type) no Bitrix24 onde as chamadas devem ser registradas (tipicamente “Call” ou “Phone Call”).
4. Configure o Modelo de descrição (description template) para personalizar quais informações são registradas na atividade. Você pode utilizar as seguintes variáveis:
   • {Time} — Timestamp da chamada
   • {Call_Log_Status} — Status da chamada (atendida, perdida, recusada, etc.)
   • {Call_From} — Número de telefone ou nome da parte chamadora
   • {Call_To} — Número de telefone ou ramal da parte chamada.
   • {Talk_Duration} — Duração da chamada em segundos ou formato HH:MM:SS
   • {Recording_URL} — Link direto para a gravação de chamada (se a gravação estiver ativada)
5. Modelo de exemplo: Call from {Call_From} at {Time}, Duration: {Talk_Duration}. Status: {Call_Log_Status}
6. Se você quiser incluir um link para a gravação de chamada na atividade, ative Incluir link da gravação (include recording link) (requer que gravações de chamada estejam ativadas em seu PABX).
7. Clique em Salvar.

Como o registro de atividades funciona:

• Após cada chamada ser concluída, o PABX envia automaticamente detalhes da chamada para o Bitrix24.
• Um registro de atividade é criado e vinculado ao contato ou lead, que foi chamado ou que chamou.
• A atividade é registrada sob a conta do usuário PABX associado ao ramal que tratou a chamada.
• A atividade aparece no fluxo de atividades do contato no Bitrix24, fornecendo um histórico de comunicação completo

Resolução de problemas

Se você encontrar problemas com a integração do Bitrix24, utilize esta seção para diagnosticar e resolver problemas comuns.

O status da conexão mostra Desconectado (“Disconnected”) ou Erro.

• Verifique a URL do webhook: Certifique-se de que a URL do webhook que você digitou no PABX é exatamente como copiada do Bitrix24, incluindo o protocolo (https://).
• Verifique o acesso de rede: Confirme que seu PABX pode alcançar servidores Bitrix24 (saída HTTPS na porta 443). Teste a partir da rede do seu PBX para garantir que não haja bloqueios de firewall.
• Valide o domínio Bitrix24: Verifique novamente se o campo de domínio Bitrix24 contém apenas o nome do domínio sem https:// ou barras finais (ex: yourcompany.bitrix24.com)
• Permissões de webhook: Faça login novamente no Bitrix24 e verifique se o webhook tem permissões de leitura CRM e User atribuídas
• Status do webhook no Bitrix24: Visite Settings Developer Resources Inbound Webhook e confirme que o webhook está ativo (não desativado ou excluído)

Os contatos não estão sendo sincronizados para a agenda telefônica do PBX

• Verifique se a sincronização de contatos está ativada: Vá para Integração > CRM > Bitrix24 Contact Synchronization e confirme que a alternância está ativada.
• Verifique a agenda telefônica de destino: Certifique-se de que a agenda telefônica selecionada existe e tem o nome correto. Se a agenda telefônica foi excluída ou renomeada, selecione a correta novamente e salve.
• Contatos Bitrix24 devem ter números de telefone: Apenas contatos com pelo menos um campo de número de telefone preenchido serão sincronizados. Contatos sem números de telefone são ignorados.
• Force uma sincronização manual: Algumas versões do PABX oferecem um botão “Sync Now” ou “Refresh”. Clique nele para recuperar imediatamente contatos do Bitrix24.
• Verifique as permissões do usuário Bitrix24: O usuário do webhook Bitrix24 deve ter permissão para ler contatos de CRM. Verifique isso em Configurações > Usuários > Funções/Permissões.

Call Popup não aparece durante chamadas

• Verifique se o popup está ativado: Vá para Integração > CRM > Bitrix24 Call Popup e confirme que Ativar janela pop-up do CRM (enable CRM popup) está ativado.
• Verifique os eventos de disparo do popup: Confirme que pelo menos um evento de disparo (Toque, Atendida ou Fim da chamada) está selecionado.
• Bloqueador de pop-up do navegador: Seu navegador pode estar bloqueando pop-ups. Verifique as configurações do seu navegador e permita pop-ups do domínio do seu PABX. Por exemplo, no Chrome: Configurações, privacidade e segurança, configurações do site, janelas pop-up e redirecionamentos, então adicione sua URL do PABX à lista de permitidos.
• Associação de usuário: Certifique-se de que a extensão que trata a chamada está associada a um usuário Bitrix24. Se não estiver associado, o gatilho do popup pode não funcionar.
• Contato correspondente necessário: O pop-up aparece apenas se o número do chamador recebido corresponder a um contato no Bitrix24 (quando “Sempre consultar o CRM” está ativado) ou na agenda telefônica (quando desativado). Se o número não for encontrado, nenhum popup será exibido.

Atividades de chamada não estão aparecendo no Bitrix24

• Verifique se o registro de chamadas está ativado: Verifique Integração > CRM > Bitrix24 Call Journal e certifique-se de que Registro automático de chamadas (automatic call logging) está ativado.
• Associação de usuário: A extensão PABX que tratou a chamada deve estar associada a um usuário Bitrix24. Sem associação, a atividade não tem onde ser registrada.
• Contato deve existir: Uma atividade só é criada se a chamada está associada a um contato ou lead existente do Bitrix24. Se o número é desconhecido e a criação de contato está desativada, nenhuma atividade é registrada.
• Verifique as permissões do webhook Bitrix24: O usuário webhook deve ter permissão para adicionar atividades ao CRM. Verifique as permissões de criar CRM (CRM create) e Atualização (Update) em Configurações, Recursos para desenvolvedores, Webhook de entrada.
• Revise os registros de chamada: No PABX, verifique os registros de chamada (tipicamente em Relatórios de chamadas (call reports) ou histórico de chamadas (call history)) para verificar se a chamada foi concluída com sucesso antes de verificar atividades Bitrix24.

Números desconhecidos não estão criando novos contatos

• A criação de contatos deve estar ativada: Verifique se Criação automática de contatos (Automatic Contact Creation) está ativada em Integração > CRM > Bitrix24 Contact Creation.
• Gatilho correto selecionado: Confirme que o gatilho para seu tipo de chamada está selecionado (chamadas recebidas (On Inbound Calls), chamadas efetuadas (On Outbound Calls) ou em ambas (Both)).
• Identificação de chamadas (Caller ID) deve ser válida: O contato é criado a partir das informações de caller ID. Se o caller ID é “Desconhecido” (Unknown), “Bloqueado” (Blocked) ou em branco, a criação de contato pode falhar ou criar um registro incompleto.
• Regras de validação Bitrix24: Sua conta Bitrix24 pode ter regras de validação de dados que evitam criar contatos sem certos campos (como nome de empresa ou e-mail). Verifique as configurações do Bitrix24 e ajuste as regras se necessário.
• Permissões de webhook: O webhook deve ter permissões CRM Create e Update para adicionar novos contatos

Links de gravação de chamada não estão inclusos nas descrições de atividade

• A gravação deve estar ativada: Certifique-se de que a gravação de chamadas esteja ativada em seu PABX (Configurações de gravação de chamadas (Settings Call Recording) ou Configurações de gravação (Recording Settings)).
• Verifique se “Incluir link da gravação” (Include Recording Link) está ativado: Na configuração do Call Journal, ative a opção Include Recording Link.
• Permissões de URL de gravação: Certifique-se de que a variável {Recording_URL} esteja adequadamente formatada e que a gravação seja acessível (verifique se o servidor de gravação do PABX está online).
• Teste novamente: Faça uma chamada de teste e deixe-a ser concluída. Verifique a atividade criada no Bitrix24 para verificar se o link de gravação está incluído.

Desativar ou desconectar a integração

Se você precisar pausar temporariamente ou remover completamente a integração Bitrix24, siga estas etapas:

Para desativar temporariamente a Integração:

1. Navegue para Integração > CRM > Bitrix24
2. Desligue a alternância Ativar integração (Enable Integration) ou desmarque recursos individuais:
   • Desative Sincronização de contatos (Contact Synchronization) para parar de sincronizar contatos com a agenda telefônica.
   • Desative Criação de contato (Contact Creation) para evitar que novos contatos sejam criados.
   • Desative Janela pop-up de chamada (Call Popup) para parar de exibir pop-ups.
   • Desative Registro de chamadas (Call Journal) para parar o registro automático de actividades.
3. Clique em Save
4. A integração permanece configurada e pode ser reativada a qualquer momento sem reconfigurar o webhook ou associações de usuário

Para desconectar completamente a integração:

1. No PBX, navegue para Integração > CRM > Bitrix24
2. Clique no botão Desligar (Disconnect) ou Excluir (Delete).
3. Confirme a desconexão quando solicitado
4. No Bitrix24, opcionalmente delete ou desative o webhook:
   • Vá para Configurações, Recursos para desenvolvedores, Outros, Webhooks de entrada (Settings Developer Resources Other Inbound Webhook).
   • Encontre o webhook associado ao Cloud PABX Virtual-Call.
   • Clique em Excluir (Delete) para removê-lo completamente, ou simplesmente desative-o se você puder se reconectar no futuro.
5. Após a desconexão, nenhuma sincronização de contatos adicional, registro de chamadas ou pop-ups ocorrerão.

Resumo

A integração do Bitrix24 CRM transforma seu Cloud PABX Virtual-Call em uma ferramenta de comunicação poderosa e consciente de CRM. Ao ativar a sincronização automática de contatos, pop-ups de chamada, criação de contatos e registro de atividades, sua equipe obtém visibilidade completa sobre interações com clientes e pode trabalhar de forma mais eficiente a partir de uma interface unificada.

Para suporte adicional ou dúvidas sobre a integração Bitrix24, entre em contato com seu administrador do sistema ou consulte a documentação da API Bitrix24 e recursos de suporte Cloud PABX Virtual-Call.

Novo método de autenticação a partir da Versão 84.23.0.24

Suporte a OAuth2 PKCE

Os modelos de integração CRM/Helpdesk personalizados agora suportam o método de autenticação Authorization Code Flow with Proof Key for Code Exchange (PKCE). Este método utiliza um par challenge-verifier em vez de um client secret, melhorando assim a segurança da autenticação OAuth 2.0.