Alertas Conheça tudo sobre os alertas da plataforma OnTracking. Configuração e características Neste módulo, vamos criar alertas de algum evento ou ação dos nossos ativos, o que nos permite ter um bom controle e segurança sobre eles. Nesta seção, há mais de 60 alertas disponíveis, como: velocidade máxima, desconexão da bateria, anti-jamming, chegada tardia a um local, aceleração ou frenagem brusca, entre muitas outras. Criar nova alerta Nesta opção, vamos criar nossos alertas. Escolheremos o tipo de alerta que será configurada, o nome do alerta para identificação, o tempo para repetição do alerta (ou seja, após a primeira notificação, quanto tempo deverá passar para que ela seja notificada novamente; caso o valor seja “0”, o alerta será notificada apenas uma vez), os dias da semana em que esse alerta irá funcionar, se queremos que o alerta seja exibida na tela, seja sonora ou falado e se a notificação do alerta terá alguma cor específica. Em seguida, escolhemos o som e, por fim, definimos se a alerta será apenas para o usuário que a está criando (Sim) ou se ficará disponível para todos os usuários do mesmo cliente (Não). Cor na notificação de alertas Dentro da configuração do alerta, você poderá escolher a cor que a notificação do alerta terá. Isso serve para identificar os alertas de forma mais visual. IMPORTANTE: Esta configuração só poderá ser visualizada se o cliente tiver ativo o parâmetro “Notificações de alertas”. Atribuição de ativos a uma alerta Nas ações que aparecem na lista de alertas criadas, será possível atribuir ativos. Isso é feito no primeiro ícone de carro, que abrirá uma janela com a lista dos ativos atribuídos ao nosso usuário. Basta selecionar a caixa dos ativos desejados e pronto. NOTA:  Ao remover o permissão de um ativo de um usuário que esteja atribuído a uma alerta, primeiro é necessário que o usuário desassocie o ativo da alerta (desmarcando a caixa da imagem anterior) e, somente depois, remover a permissão do ativo para o usuário. Caso contrário, a relação entre o ativo e a alerta será mantida. Atribuição de destinatários dos alertas No ícone verde, escolheremos os destinatários dos alertas. Isso significa que os alertas geradas pelo ativo poderão ser enviadas para e-mails, usuários e por mensagem de texto, mesmo que eles não tenham o veículo atribuído diretamente. Configuração avançada de alertas Em atribuir eventos aos alertas, podemos fazer com que a plataforma envie um comando toda vez que a alerta for executada. Por exemplo: se a alerta for de botão de pânico e o equipamento GPS contar com câmeras de vídeo, é possível enviar um comando que permita gerar streaming para a plataforma e, assim, visualizar o que está acontecendo. Os comandos disponíveis variam de acordo com a marca e o modelo do dispositivo GPS. NOTA: essa ação está disponível apenas ao acessar a plataforma no nível distribuidor do OnTracking ou utilizando o botão “Entrar na plataforma” (LOGIN AS) dentro do módulo de usuários na plataforma Partner. Histórico de alertas emitidos O botão Histórico permite visualizar todos os registros dos alertas que foram executadas. Por padrão, serão exibidas as alertas emitidas nos últimos 5 dias. Caso deseje visualizar um período maior, é possível filtrar por um ativo e por um intervalo de datas específico. Para visualizar os  registros emitidos de um único alerta , você pode utilizar o botão  Histórico por definição de alerta , que mostra os registros dessa alerta que foram gerados. Por padrão, serão exibidas as alertas geradas no dia atual. Caso deseje visualizar um intervalo de datas maior, é possível filtrar por um ativo e por um período específico. As informações exibidas na lista são: o nome do ativo que gerou o alerta, o cliente/usuário proprietário, o tipo de alerta, a data e a hora em que o alerta foi gerada e a descrição. O botão  Mostrar localização  exibe um marcador no mapa com a localização onde o alerta foi gerado e, ao clicar no marcador, é mostrada a descrição do alerta. O botão  Mostrar detalhe do alerta  exibe as informações detalhadas do alerta gerado. Notificações na tela As notificações dos alertas na tela serão exibidas no canto inferior direito do mapa, onde é possível visualizar os alertas executados. Para visualizar os detalhes do alerta, basta clicar na caixa de informações e será exibida uma janela com as informações completas. Depois que um alerta é aberto, ela ficará na cor cinza, e apenas as notificações pendentes de abertura permanecerão na cor vermelha. Detalhe do alerta Ao abrir o  detalhe do alerta , na primeira aba são exibidos o alerta e as informações reportadas pelo equipamento do Ativo, na data e hora em que a alerta foi emitida. Adicionalmente, contamos com 3 botões: Ocultar/traçar percurso: serve para mostrar ou ocultar o percurso dos 4 relatórios anteriores e posteriores à geração do alerta. Ocultar marcador / mostrar no mapa: serve para mostrar ou ocultar o marcador do alerta no mapa. Copiar localização: copia para a área de transferência as coordenadas da localização onde o alerta foi gerado. Na segunda aba, “ Relatórios próximos ao alerta ”, são exibidos os 4 relatórios anteriores e posteriores ao relatório que gerou o alerta: A aba “ Multimídia ” aparecerá somente quando o relatório que gerou o alerta contiver vídeo, foto, assinatura digital ou gravação de áudio. A aba “ Informações do OnAlert ” aparecerá somente quando o usuário tiver permissão na plataforma OnAlert e exibirá as seguintes informações: No campo Alerta, é possível visualizar as informações do alerta. Em Incidentes / Comentários, está disponível a opção para adicionar informações referentes ao alerta e alterar o seu status. Comandos aparece apenas quando o usuário tiver permissão para enviar comandos e permite enviá-los ao equipamento que gerou o alerta. Por fim, em Procedimento, é possível consultar os procedimentos que o cliente ou o Ativo tenha atribuídos no OnPartners. A aba “ Formulário respondido ” aparecerá somente quando o relatório que gerou o alerta contiver formulário. Lista de alertas disponíveis Tipo de alerta Informações Ativo Parado É disparado quando o ativo mantém uma velocidade inferior a 5 km/h durante o período em que o alerta está ativo. Deve-se levar em consideração que esse alerta funciona com a ignição OFF. Ativo em Movimento É disparado quando a plataforma detecta que o ativo iniciou o movimento, ou seja, quando a velocidade é maior que zero km/h. Chegada a um Local O alerta será enviado quando o ativo se aproximar do local dentro de um raio de x metros previamente definido pelo usuário. Velocidade Máxima Quando um ativo atinge ou ultrapassa a velocidade máxima definida, o alerta é ativado. Saída de Geocerca Esse alerta notificará no momento em que um ativo sair do perímetro da geocerca que lhe foi atribuída. Geocerca e local E/S Esse alerta pode notificar quando um Ativo sair e/ou entrar no perímetro da geocerca e/ou local que lhe for atribuído. As informações a serem configuradas são: Nome do alerta pelo qual ele será identificado. Minutos que o Ativo deve permanecer dentro da geocerca e/ou local para emitir o alerta. Minutos que o Ativo deve permanecer fora da geocerca e/ou local para emitir o alerta. Alertar quando o Ativo estiver dentro e/ou fora da geocerca e/ou local. Combinar geocercas: essa opção serve para que as geocercas selecionadas para o alerta sejam consideradas como uma única geocerca. Tempo para repetir o alerta caso o Ativo continue dentro e/ou fora da geocerca e/ou local. Posteriormente, é necessário selecionar os Ativos e as geocercas/locais para o alerta. Máximo de Km Percorridos Esse tipo de alerta será enviado quando o ativo atingir ou ultrapassar a quantidade de quilômetros permitidos para percorrer em um dia. Alerta de Ignição Esse tipo de alerta será enviado quando for detectado que o ativo foi ligado ou desligado. Desconexão de Bateria Esse tipo de alerta será acionado assim que for detectado que a bateria do Ativo está sendo desconectada. Botão de Pânico Esse tipo de alerta será enviado assim que o botão de pânico for pressionado. Ignição Ligada Esse tipo de alerta apenas notifica quando detecta que o ativo foi ligado. Temperatura Fora de Faixa Esse tipo de alerta é disparado quando o sensor de temperatura detecta que a temperatura está fora dos limites estabelecidos. Ativo Rebocado Esse tipo de alerta é disparado quando se detecta que o ativo está sendo rebocado por um guincho ou qualquer outro veículo. Anti-Jamming Esse evento reporta quando o equipamento detecta que o sinal está sendo interferido ou bloqueado. Alerta Fora da Base Esse tipo de alerta notifica quando os ativos não estão na base durante o período estabelecido. Aceleração Brusca Esse tipo de alerta é ativado quando se detecta uma aceleração muito rápida em um curto período de tempo. Frenagem Brusca Esse tipo de alerta é ativado quando se detecta uma frenagem muito rápida em um curto período de tempo. Alerta de Rotação Esse tipo de alerta é ativado quando se detecta uma frenagem muito rápida em um curto período de tempo. Alerta de Consumo de Combustível É enviado um alerta quando o ativo consome combustível acima da quantidade estabelecida no limite do alerta. Alerta Fora de Rota Esse tipo de alerta notifica quando o ativo se afasta mais de 50 metros da rota atribuída. Alarme do Ativo Esse tipo de alerta notifica quando é detectado que o alarme do ativo foi acionado. Alerta de Marcha Lenta Esse tipo de alerta é executado quando o ativo está ligado, porém parado, ou seja, com velocidade igual a 0. Alerta de Remoção do Equipamento GPS Dispara um alerta quando é detectado que o equipamento foi removido ou recolocado. Alerta de Pranchão Esse tipo de alerta é destinado a caminhões-guincho com pranchão (rampa de reboque), sendo acionado quando o pranchão desliza e quando retorna à posição original. Alerta de Equipamento Sem Reportar Esse alerta é disparado quando o equipamento deixa de enviar dados ao servidor, seja por perda de sinal, dados ou qualquer outro motivo. Alerta de Descarga em Geocerca Esse alerta é destinado a caminhões betoneira e serve para detectar quando ocorre uma descarga de cimento fora de uma geocerca. Lista de Equipamentos Esse alerta notifica enviando uma lista dos ativos selecionados, contendo informações do último reporte, como posição, data e hora, além do equipamento associado ao ativo. Abertura/Fechamento de Portas Esse alerta é executado quando o equipamento detecta a abertura ou o fechamento da porta do veículo. Bateria Baixa Esse tipo de alerta é acionado quando o equipamento GPS envia um reporte indicando bateria baixa. Alerta de Baixa da Caçamba Esse alerta permite receber notificações quando se detecta que o caminhão abaixa a caçamba, geralmente ao finalizar a descarga de materiais. Alerta de Levantamento da Caçamba Esse alerta é recebido quando se detecta o levantamento da caçamba traseira do caminhão durante a descarga de materiais. Alerta de Engate de Acoplado Notifica quando um veículo sem tração própria é acoplado a outro para reboque. Alerta de Desengate de Acoplado Esse tipo de alerta notifica quando o veículo é desengatado do acoplado. Alerta de Abertura de Cofre Esse tipo de alerta notifica quando ocorre a abertura de um cofre. Alerta de Fechamento de Cofre Esse tipo de alerta notifica quando ocorre o fechamento de um cofre. Alerta de Eventos Esse alerta notifica quando ocorre o evento especificado, por exemplo, botão de pânico. Alerta de Velocidade em Geocerca   Combustível no Tanque Envia um alerta quando o percentual de combustível no tanque é menor ou igual à tolerância configurada para cada tanque. Ativo Parado Fora de Geocerca Alerta quando um ativo permanece fora das geocercas configuradas por um período superior ao estabelecido; o tempo padrão para alerta é de 3 minutos. Chegada Tardia ao Local   Alerta de Acessórios/Sensores   Alerta de Formulário a Vencer   Alerta de Distância Entre Ativos É disparado quando um dos ativos secundários está muito distante ou muito próximo do ativo principal. Alerta de Equipamentos Sem Reportar por Marca e Modelo Esse alerta é disparado quando o percentual de equipamentos sem reportar é maior ou igual ao percentual definido na configuração. Alerta de Tarefa Programada Alerta gerado por tempo. Não depende de um reporte do equipamento e é executado nos dias e horários especificados. Permite o envio de comandos programados a dispositivos GPS ou formulários para usuários da plataforma, motoristas ou destinatários. Alerta de Eventos Dentro ou Fora de Geocercas Esse alerta funciona quando um evento (pânico, ignição, abertura, etc.) é ativado dentro ou fora de uma geocerca. Alerta de Subacessórios/Sensores OBD/CANBUS Alerta de subacessórios OBD. Funciona com informações obtidas via OBD e notifica quando um valor mínimo, máximo ou faixa é atingido. Alerta de Acessórios/Sensores Sem Reportar Gera um alerta quando um acessório ultrapassa o tempo permitido sem enviar reportes. Alerta de Excesso de Velocidade por Ruas   Alerta de Acessórios/Sensores em Geocerca Gera um alerta de acessório considerando uma geocerca, podendo alertar apenas quando estiver dentro ou fora da geocerca. Alerta IoT Esse alerta notifica quando ocorre o evento especificado, por exemplo, botão de pânico. Alerta de Proximidade (COVID-19) É disparado quando um ativo envia um evento de violação do limite de proximidade. Alerta de Velocidade em Geocerca Linear/Rota Gera um alerta de velocidade em geocercas do tipo linear/rota, podendo alertar por velocidade máxima, mínima ou fora de faixa, conforme definido na geocerca ou por excesso de velocidade conforme o sentido. Alerta de Sobreestadia Gera um alerta para excesso de tempo parado, com ou sem ignição, e dentro ou fora de uma geocerca. Alerta de Descanso Entre Condução Efetiva Reenvio de alertas para terceiros A partir da configuração de alertas, é possível reenviar, em tempo real, os alertas emitidos pela plataforma para terceiros. Esses terceiros podem ser um sistema próprio da empresa ou outra plataforma. Configuração de reenvio de alertas “Atribuir servidor de destino” A opção para configurar o reenvio de alertas está localizada no módulo de alertas, nas opções do canto superior direito, e se chama “Atribuir servidor de destino”. Após acessar o módulo, devemos definir o servidor de destino para onde desejamos que os alertas sejam reenviados e também selecionar quais alertas queremos que sejam enviados ao host. IMPORTANTE:  essa opção de “Atribuir servidor de destino” está disponível apenas para o distribuidor e quando o acesso é realizado com login como cliente. O cliente final não terá acesso a essa opção. Na opção “Histórico de envios”, será possível consultar um histórico de todos os envios realizados de cada alerta e o respectivo resultado. Forma de receber os dados dos alertas A plataforma envia cada alerta por meio de uma requisição HTTP realizada ao servidor de destino. As informações e os dados do alerta são enviados por meio de dados POST dentro da requisição HTTP. As chaves que serão recebidas dentro da requisição POST serão as seguintes. idalert device date time description latitude longitude speed address vehicle patent Um exemplo em linguagem PHP de como receber esses dados seria o seguinte: O código acima é o que você deve colocar no seu servidor de destino que receberá os alertas, por exemplo:  https://miservidor.com/receive_alerts.php Com o exemplo acima, você deve conseguir receber os dados e, a partir daí, fica por conta de vocês definir qual ação realizar com as informações recebidas, como, por exemplo, salvá-las em um banco de dados. Exemplo de como receber os dados utilizando a linguagem C# using System; using System.Collections.Generic; using System.IO; using System.Net; using System.Text; namespace DumpHttpRequests { internal class Program { private static void Main(string[] args) { if (!HttpListener.IsSupported) { Console.WriteLine("Windows XP SP2 or Server 2003 is required to use the HttpListener class."); return; } // URI prefixes are required, var prefixes = new List() { "http://*:8000/" }; // Create a listener. HttpListener listener = new HttpListener(); // Add the prefixes. foreach (string s in prefixes) { listener.Prefixes.Add(s); } listener.Start(); Console.WriteLine("Listening..."); while (true) { // Note: The GetContext method blocks while waiting for a request. HttpListenerContext context = listener.GetContext(); HttpListenerRequest request = context.Request; string documentContents; using (Stream receiveStream = request.InputStream) { using (StreamReader readStream = new StreamReader(receiveStream, Encoding.UTF8)) { documentContents = readStream.ReadToEnd(); } } Console.WriteLine($"Recived request for {request.Url}"); Console.WriteLine(documentContents); // Obtain a response object. HttpListenerResponse response = context.Response; // Construct a response. string responseString = "Respuesta a la peticion"; byte[] buffer = System.Text.Encoding.UTF8.GetBytes(responseString); // Get a response stream and write the response to it. response.ContentLength64 = buffer.Length; System.IO.Stream output = response.OutputStream; output.Write(buffer, 0, buffer.Length); // You must close the output stream. output.Close(); } listener.Stop(); } } } Herança de alertas por meio de grupos de Ativos, geocercas e locais É importante que você saiba que é possível utilizar diferentes grupos de Ativos, geocercas e locais para economizar tempo na administração dos alertas, ao atribuir Ativos, geocercas e locais. A seguir, detalharemos o uso desses grupos para permitir a atribuição de alertas conforme o grupo ao qual o Ativo pertence, ou também utilizando grupos de geocercas e locais. Como utilizar os grupos de Ativos em alertas? Os grupos de Ativos são muito importantes nos alertas, pois ajudam para que, sempre que você adicionar um Ativo à plataforma, não seja necessário atribuir alertas manualmente, fazendo com que isso funcione de forma automática por meio dos grupos. Vale ressaltar que existem 2 tipos de grupos de Ativos: 1. Grupo predefinido pelo sistema: “Todos os Ativos”. 2. Grupos personalizados, que podem ser criados a partir do módulo “Grupos de Ativos”. Portanto, se você quiser que algum alerta seja atribuído automaticamente aos Ativos atuais e aos que venham a ser adicionados futuramente à sua conta, basta atribuir ao alerta o  grupo de Ativos chamado “Todos os Ativos” . Dessa forma, todo Ativo existente na sua conta pertencerá automaticamente a esse grupo e, consequentemente,  será atribuído de forma automática a todas as alertas que tenham esse grupo associado. No segundo caso, você pode utilizar  grupos de Ativos criados por você  e atribuí-los aos alertas. Nesse cenário, é importante saber que, sempre que um novo Ativo for adicionado à plataforma, será necessário atribuí-lo manualmente ao grupo para que ele herde as alertas associadas a esse grupo. Como utilizar os grupos de geocercas? Nossa plataforma oferece suporte a diferentes tipos de grupos, entre eles os grupos de geocercas. É importante saber utilizá-los para reduzir o trabalho na atribuição de alertas. Nesse caso, para não atribuir manualmente as geocercas aos alertas, você tem 2 opções: 1. Utilizar o grupo predefinido pelo sistema “Todas as geocercas” , esse grupo já vem criado por padrão na plataforma. Assim, se você desejar que uma alerta tenha todas as geocercas existentes ou futuras, deve utilizá-lo no momento de atribuir geocercas à alerta. Ao usar esse grupo, você garante que as geocercas criadas futuramente sejam automaticamente atribuídas ao alerta. 2. Utilizar grupos de geocercas personalizados , esses grupos também podem ser atribuídos às alertas. Nesse caso, se você atribuir um grupo de geocercas a uma alerta e posteriormente adicionar ou remover geocercas do grupo, a alerta atualizará automaticamente a herança das geocercas pertencentes a esse grupo. I IMPORTANTE:  Caso existam restrições de permissões em nível de usuário, ao utilizar o grupo “Todas as geocercas”, os alertas desse usuário funcionarão apenas com as geocercas para as quais ele tenha permissão e consiga visualizar. Esses alertas não funcionarão com geocercas criadas por outros usuários que tenham a opção “Somente meu usuário” configurada como Sim. Como utilizar os grupos de locais? Assim como as geocercas, a plataforma oferece suporte a grupos de locais, havendo também 2 opções: 1. Grupo predefinido pelo sistema “Todos os locais” , esse grupo serve para ser atribuído a um alerta e, ao criar qualquer local dentro da plataforma, ele será automaticamente atribuído ao alerta, sem a necessidade de realizar qualquer alteração no alerta. O uso desse grupo pode ajudar significativamente a economizar tempo na operação da plataforma. 2. Grupos de locais personalizados , esses grupos também podem ser atribuídos aos alertas. Nesse caso, ao atribuir um grupo de locais a um alerta e posteriormente adicionar ou remover locais do grupo, o alerta atualizará automaticamente a herança dos locais que pertençam ao grupo. IMPORTANTE : Caso existam restrições de permissões em nível de usuário, ao utilizar o grupo “Todos os locais”, os alertas desse usuário funcionarão apenas com os locais para os quais o usuário tenha permissão e consiga visualizar. Esses alertas não funcionarão com locais criados por outros usuários que tenham a opção “Somente meu usuário” configurada como Sim. Alertas via WhatsApp Uma vez configurado o serviço  de WhatsApp na plataforma OnPartners. Primeiro, é necessário ativar no OnPartners o parâmetro  Utilizar WhatsApp  para o cliente que deverá receber os alertas por esse meio. Depois, ao acessar com um usuário do cliente o módulo de  Alertas  do  OnTracking , será encontrada, dentro de  Destinatários deste alerta , a aba  WhatsApp : Nessa seção,  você poderá selecionar os usuários que devem receber os alertas via WhatsApp . Para isso, é necessário  cadastrar o campo Celular do usuário no formulário  dentro do OnPartners. Também será possível  inserir outros números de celular como destinatários  dos alertas via WhatsApp. Uma vez que o alerta seja gerado, ele será enviado via WhatsApp para os dispositivos especificados como destinatários.