Integração Milvus

A integração do BomControle com o Milvus permite conectar o módulo financeiro e de contratos do BomControle aos dados operacionais do Milvus. Em termos práticos, essa integração possibilita que: cobranças avulsas lançadas no Milvus sejam recebidas automaticamente no BomControle, contratos no BomControle sejam ajustados conforme o consumo registrado no Milvus (por exemplo, horas extras além do contratado, quantidade de tickets resolvidos ou equipamentos monitorados), e que haja um vínculo unificado de clientes entre as duas plataformas. Isso tudo traz mais automação à gestão: você reduz retrabalho de lançar cobranças manualmente e assegura que faturamento e suporte técnico estejam alinhados.

Acessando a tela de configuração: Para configurar, navegue até Configurações > Integrations no BomControle e clique no ícone do Milvus. A janela modal “Configuração Integração – Milvus” será exibida. 

Imagem da tela de configuração da integração do BomControle com Milvus

Visão geral dos campos: A tela de integração com o Milvus apresenta os seguintes campos e opções principais:

• Integração ativa? – Alternador Sim/Não para habilitar ou desabilitar a integração com o Milvus. Inicialmente estará desligado. Ao marcar Sim, os demais campos são liberados para edição.

Regras: Obrigatório marcar “Sim” para configurar. Com “Não”, a integração permanece desativada e nenhuma comunicação ocorre. Ao desativar (voltar para "Não") e salvar, a integração será removida (desconectada).

Impacto: Ativar a integração permite conectar-se à API do Milvus e habilitar funcionalidades como sincronização de clientes e atualização de dados de contratos. Desativar interrompe imediatamente qualquer sincronização ou comunicação com o Milvus.

• Empresa: Seleção da empresa cuja integração com o Milvus será feita.

Regras: Obrigatório selecionar a empresa antes de prosseguir para autenticação. Dica: escolha a empresa do BomControle que corresponde à sua operação relacionada ao Milvus. Se sua conta Milvus gerencia informações de uma única empresa, selecione essa. Caso o BomControle tenha múltiplas empresas, atualmente a integração Milvus é realizada uma por vez (caso precise integrar múltiplas empresas do BomControle a diferentes contas Milvus, será necessário configurar separadamente para cada – normalmente utiliza-se apenas uma).

Impacto: A empresa selecionada servirá para contextualizar todos os dados recebidos do Milvus. Por exemplo, clientes sincronizados e cobranças importadas serão vinculados a essa empresa no BomControle. Além disso, essa seleção define qual empresa terá seus contratos potencialmente atualizados com dados do Milvus.

• Autenticação (botão “Autenticar”): Botão usado para iniciar o processo de conexão com o Milvus.

Regras: Disponível somente quando ainda não houve autenticação. Importante: só clique em Autenticar após selecionar a Empresa acima. Se tentar autenticar sem empresa selecionada, o sistema exibirá um erro exigindo a seleção. Ao clicar, o BomControle abrirá uma página de autorização do Milvus (pode ser em outra aba/janela) solicitando seu login no Milvus e permissão para integração. Confirme a operação no Milvus; então você será redirecionado de volta.

Impacto: Após a autorização bem-sucedida, o BomControle receberá um token de acesso do Milvus. Internamente, a integração ficará marcada como autenticada, e o botão “Autenticar” passará a mostrar Autenticado. Somente depois de autenticado o BomControle poderá consultar e enviar informações para o Milvus. Observação: caso você tenha várias instâncias ou contas no Milvus, verifique se conectou à conta correta durante a autorização.

• Salvar (botão): Botão para salvar as configurações após autenticar.

Regras: Fica habilitado somente depois que a integração está ativa e autenticada (ou seja, quando o campo Integração ativa está “Sim” e o status já indica Autenticado). Se a empresa não foi selecionada ou a autenticação não ocorreu, tentar salvar resultará em erro (“Preencha todos os campos.”). Ao clicar em Salvar, o BomControle irá finalizar a configuração da integração Milvus.

Impacto: O sistema armazena o token de acesso e registra a configuração. É nesse momento que a integração entra em vigor. O BomControle também obtém do Milvus informações necessárias (por exemplo, gera internamente a URL de webhook ou token de integração). Uma mensagem “Configuração salva com sucesso.” confirmará a conclusão. A partir de então, funcionalidades como sincronização e atualizações automáticas estarão ativas. (Diferentemente de outras integrações, não há um URL visível para copiar – o BomControle cuida internamente da comunicação com o Milvus após a autenticação.)

• Sincronizar Clientes: Este botão aparece após a integração estar ativa e autenticada, na parte inferior da tela, e permite realizar manualmente uma sincronização de cadastros de clientes entre os sistemas.

Regras: Ativo somente quando a integração já foi configurada e salva (estado autenticado). Clique em Sincronizar Clientes para iniciar o procedimento. Não há parâmetros adicionais – o sistema fará tudo automaticamente.

Impacto: Ao acionar a sincronização, o BomControle irá consultar o banco de dados de clientes/empresas do Milvus e comparar com os Clientes cadastrados no BomControle (da empresa selecionada na integração). Para cada cliente encontrado no Milvus, o BomControle tenta localizar um correspondente pelo número de documento (CPF ou CNPJ).

• Se encontrar um cliente com o mesmo documento no BomControle, o sistema realiza o vínculo entre eles (associando internamente o ID, para futuras referências cruzadas).

• Se não encontrar, o BomControle criará um novo cadastro de Cliente automaticamente com os dados básicos vindos do Milvus.
  Essa sincronização inicial facilita as integrações seguintes (por exemplo, cobranças ou contratos), garantindo que as entidades de cliente estão alinhadas nos dois sistemas. Ao solicitar a sincronização, uma notificação “Sincronização iniciada com sucesso” aparecerá – o processo pode levar alguns minutos em segundo plano caso haja muitos registros.

• Remover configuração: Caso deseje desativar permanentemente a integração com o Milvus, use o botão Remover configuração.

Regras: Disponível após a integração estar configurada (ativo e autenticado). Ao clicar, o sistema pedirá confirmação: “A integração Milvus será removida, deseja continuar?”. Confirmando, a integração será desligada.

Impacto: O BomControle apagará os tokens de acesso e deixará de se comunicar com o Milvus. Qualquer sincronização agendada ou automática será cancelada. O ícone do Milvus nas Integrações voltará ao estado inativo (sem o check verde). Você poderá reconfigurar do zero mais tarde, se necessário. Uma mensagem de sucesso confirmará a remoção. Note que remover aqui não desfaz eventuais dados já sincronizados (clientes criados, etc.), apenas interrompe integrações futuras.

Funcionamento da integração Milvus: Uma vez ativada, a integração trabalha de duas formas: mediante ações automáticas e através de sincronizações. Com a conexão estabelecida, o BomControle pode receber do Milvus informações de uso para aplicar em contratos e faturamento. Por exemplo, se você possui contratos cadastrados no BomControle com franquia de horas ou tickets, o sistema pode, ao final do período, consultar o Milvus para verificar consumo excedente e automaticamente ajustar o valor da cobrança ou gerar cobranças avulsas conforme a quantidade de horas extras, tickets resolvidos ou dispositivos monitorados registrados no Milvus para aquele cliente.

Essas alterações automáticas ocorrem durante os processos de faturamento (como na geração de faturas de contrato), eliminando a necessidade de calcular manualmente variáveis de contrato. Além disso, as cobranças avulsas registradas no Milvus (por exemplo, um serviço pontual cobrado fora de contrato) podem ser importadas e inseridas no Financeiro do BomControle de forma automatizada, garantindo que nada fique de fora do seu contas a receber. 

A sincronização de clientes, que pode ser acionada manualmente (via botão) ou possivelmente de forma periódica, assegura que novos clientes cadastrados em um sistema apareçam no outro, evitando duplicidades e facilitando o vínculo de contratos e tickets. Em resumo, a integração Milvus + BomControle visa unificar o backoffice financeiro com a operação de suporte técnico, tornando a gestão mais eficiente e sem erros de transcrição.