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

  1. Configurar o WebHook Nivel Operador. Esse cadastro é feito na tela de Operador na guia Configurações → URL para integração via WebHook

  2. Habilitar o rastreável para “Integração WebHook”, no cadastro do rastreável.

  3. Configurar alertas de monitoramento no rastreável.

 

Configuração Nivel Cliente

  1. Configurar o WebHook Nivel Cliente. Esse cadastro é feito na tela de Integrações Cliente na guia Integração WebHook

  2. Habilitar o rastreável para “Integração WebHook”, no cadastro do rastreável.

  3. 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
}