A integração via WebHook envia os ALERTAS gerados na plataforma Selsyn para uma URL definida pelo agente integrador. Os alertas serão enviados para os ratreáveis configurados.
Configuração Nivel Operador
Configurar o WebHook Nivel Operador. Esse cadastro é feito na tela de Operador na guia Configurações → URL para integração via WebHook
Habilitar o rastreável para “Integração WebHook”, no cadastro do rastreável.
Configurar alertas de monitoramento no rastreável.
Configuração Nivel Cliente
Configurar o WebHook Nivel Cliente. Esse cadastro é feito na tela de Integrações Cliente na guia Integração WebHook
Habilitar o rastreável para “Integração WebHook”, no cadastro do rastreável.
Configurar alertas de monitoramento no rastreável.
Após efetuar uma dessas configurações (ou ambas), todos os ALERTAS de monitoramento gerados na plataforma Selsyn serão enviados para a URL WebHook, adicionando um comentário no alerta evidenciando o envio.
Caso ambos os níveis forem configurados, o envio será determinado pela configuração menos abrangente (Nível Cliente).
Formato do envio via WebHook
Os alertas serão enviados seguindo o protocolo HTTP Rest - Metodo POST
Headers da requisição:
x-webhook-apikey
- ApiKey Gerada no cadastro do WebHook. Camada de segurança garantindo que o alerta foi originado na Plataforma Selsyn
x-webhook-uuid
- Identificador unico da transação para analise de problemas
Body da requisição:
{ "id": 888, "data": "2023-12-03T10:15:30.000Z", "tipo": { "key": "IGNITION_ON", "value": "Ligou Ignição", "ativo": true }, "agrupador": "IGNITION", "detalhes": "Detalhes do alerta", "sonoro": true, "motorista": { "key": "888", "value": "Nome Motorista", "ativo": true }, "rastreavel": { "key": "PLA1234", "value": "PLA-1234 - Nome Rastreavel", "ativo": true }, "cliente": { "key": "123", "value": "Nome cliente", "ativo": true }, "departamento": { "key": "345", "value": "Descricao Dpto", "ativo": true }, "posicao": { "latitude": -56.789456, "longitude": -25.123456 }, "ignicao": true, "velocidade": 56, "energia": 12.23 }