> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/devices-and-settings/connectivity/data-forwarding/ilsp.md). # ILSP Encaminhe as posições dos veículos e os alarmes de segurança do Navixy para centros de monitoramento ILSP no México, usando uma API JSON autenticada por OAuth. A ILSP presta serviços privados de segurança no México, e o protocolo de Encaminhamento de dados da ILSP entrega as posições dos veículos e os alarmes de Segurança aos seus centros de monitoramento. As empresas que compartilham um centro de monitoramento o usam para dar à ILSP visibilidade de seus veículos, e uma conta Navixy pode encaminhar para vários clientes da ILSP ao mesmo tempo. No Navixy, selecione **ILSP** na lista suspensa **Protocolo** . ## O que a Navixy envia A Navixy envia uma solicitação HTTP POST por mensagem para `/CustomerServices/api/SetLastEvent`com um corpo JSON contendo estes campos: | Campo | Conteúdo | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------- | | `customerId` | O número do cliente, obtido da primeira parte do External ID | | `transportLineId` | O número da linha de transporte, obtido da terceira parte do External ID | | `plates` | A placa, obtida da segunda parte do External ID | | `generatedEvent` | O código do evento: `2` para SOS, `3` para perda de energia, `4` para alarme de GSM atenuado, e `1` para todas as demais mensagens | | `generatedEventDate` | Quando o dispositivo registrou a mensagem | | `latitude` e `longitude` | Posição em graus | | `velocidade` | Velocidade | | `rumo` | Direção do deslocamento | | `Odômetro` | Distância percorrida, enviada apenas quando o dispositivo a informa | | `bateria` | Nível da bateria, enviado apenas quando o dispositivo o informa | ### Quando a Navixy envia A Navixy envia uma mensagem quando tem uma posição válida ou quando informa um SOS, uma perda de energia ou um alarme de GSM atenuado. Um alarme é enviado mesmo sem posição, para que a ILSP receba o alerta. Qualquer outra mensagem sem posição é ignorada. ## Antes de começar Reúna da ILSP o seguinte: * O endereço e a porta do endpoint. O endereço geralmente é `https://www.ilspservices.com.mx/` na porta `443`. * Seu client id e client secret. A Navixy exige ambos e não salvará o retransmissor sem eles. * O número do cliente, a placa e o número da linha de transporte de cada veículo. {% hint style="info" %} A ILSP autentica com OAuth em vez de com nome de usuário e senha. Informe o client id no campo **Login** e o client secret no campo **Senha** . A Navixy solicita um token antes de enviar os dados e o renova quando expira. Após cinco solicitações de token com falha, a Navixy desativa o retransmissor, de modo que um client id ou secret incorreto interrompe o encaminhamento em vez de tentar indefinidamente. {% endhint %} ## Configurar o encaminhamento {% stepper %} {% step %} ### Abra o bloco Encaminhamento de dados Acesse **Dispositivos e configurações**, selecione um dispositivo e depois encontre o bloco **Encaminhamento de dados** . {% endstep %} {% step %} ### Abra a lista de protocolos Clique em **Protocols**, e depois clique em **+** para adicionar uma configuração. {% endstep %} {% step %} ### Informe as configurações da ILSP Preencha os campos da seguinte forma: * **Nome**: um rótulo que identifica este retransmissor * **Protocolo**: **ILSP** * **Endereço**: `https://www.ilspservices.com.mx/` * **Porta**: `443` * **Login**: seu client id da ILSP * **Senha**: seu client secret da ILSP {% endstep %} {% step %} ### Ativar e salvar Ligue **Ativado**, e depois clique em **Salvar**. Um retransmissor que não estiver ativado não envia nada. {% endstep %} {% step %} ### Vincule o retransmissor a um dispositivo No bloco do dispositivo **Encaminhamento de dados** , ative a chave do retransmissor que você criou e depois clique em **Salvar**. {% endstep %} {% step %} ### Definir o External ID Clique no ícone de link à direita da linha do retransmissor e, em seguida, insira os três valores que identificam este veículo para a ILSP, separados pelo caractere pipe: ``` customerId|licensePlate|transportLineId ``` Por exemplo, `4821|ABC-123|17`. Todas as três partes são obrigatórias. O número do cliente e o número da linha de transporte devem ser dígitos, e a placa pode conter letras maiúsculas, dígitos e hífens. Repita esta etapa e a anterior para cada dispositivo que encaminha para a ILSP. A configuração do retransmissor é compartilhada pela conta, mas o External ID é definido por dispositivo. {% endstep %} {% endstepper %} ## Gerenciar o encaminhamento Para alterar ou interromper o encaminhamento para a ILSP: * Clique no ícone de link à direita da linha do retransmissor para alterar o External ID de um dispositivo. * Desative a chave para interromper o encaminhamento de um dispositivo e mantenha a configuração para os demais. * Clique em **Protocols**, selecione a linha e edite-a para alterar o nome, o endereço ou as credenciais. A alteração se aplica a todos os dispositivos vinculados a este retransmissor. * Exclua a configuração da **Protocols** lista para interromper o encaminhamento para todos os dispositivos. Confirme na caixa de diálogo. ## Solução de problemas Quando os dados não aparecerem no sistema da ILSP, verifique o seguinte nesta ordem: 1. O retransmissor está ativado e sua chave está ligada para o dispositivo. 2. O client id e o client secret estão corretos. Cinco solicitações de token com falha desativam o retransmissor; portanto, corrija as credenciais e depois desligue **Ativado** e ligue novamente. 3. O endereço e a porta estão corretos. 4. O External ID tem todas as três partes na ordem correta, separadas por pipes, sem espaços ao redor delas. 5. O número do cliente, a placa e o número da linha de transporte correspondem aos registros do lado da ILSP. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/user/pt-br/guide/devices-and-settings/connectivity/data-forwarding/ilsp.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.