> 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 posições de veículos e alarmes de Segurança do Navixy para centros de monitoramento do ILSP no México, usando uma API JSON autenticada por OAuth. A ILSP fornece serviços privados de segurança no México, e o protocolo de encaminhamento de dados da ILSP entrega posições de veículos e alarmes de segurança aos seus centros de monitoramento. 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 ILSP ao mesmo tempo. No Navixy, selecione **ILSP** em **Protocolo** o menu suspenso. ## O que o Navixy envia O 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, retirado da primeira parte do ID Externo | | `transportLineId` | O número da linha de transporte, retirado da terceira parte do ID Externo | | `placas` | A Placa, retirada da segunda parte do ID Externo | | `generatedEvent` | O código do evento: `2` para SOS, `3` para perda de energia, `4` para o alarme de interferência GSM, e `1` para cada outra mensagem | | `data do evento gerado` | Quando o dispositivo registrou a mensagem | | `latitude` Webhook `longitude` | Posição em graus | | `velocidade` | Velocidade | | `rumo` | Direção de deslocamento | | `odômetro` | Distância percorrida, enviada somente quando o dispositivo a reporta | | `bateria` | Nível da bateria, enviado somente quando o dispositivo o reporta | ### Quando a Navixy envia A Navixy envia uma mensagem quando tem uma posição válida ou quando reporta um SOS, uma perda de energia ou um alarme de atenuação GSM. Um alarme é enviado mesmo sem uma posição, então o ILSP recebe o alerta. Qualquer outra mensagem sem posição é ignorada. ## Antes de começar Colete o seguinte do ILSP: * O endereço e a porta do endpoint. O endereço geralmente é `https://www.ilspservices.com.mx/` na porta `443`. * Seu ID do cliente e segredo do cliente. 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" %} O ILSP se autentica com OAuth em vez de com um nome de usuário e senha. Insira o ID do cliente no **Login** campo e o segredo do cliente no **Senha** campo. A Navixy solicita um token antes de enviar dados e o renova quando ele expira. Após cinco solicitações de token com falha, a Navixy desativa o retransmissor, então um ID do cliente ou segredo incorreto interrompe o Encaminhamento de dados em vez de continuar tentando indefinidamente. {% endhint %} ## Configurar encaminhamento {% stepper %} {% step %} ### Abra o bloco Encaminhamento de dados Dispositivos e configurações **na barra lateral esquerda.**, selecione um dispositivo e, em seguida, encontre o **Encaminhamento de dados** bloco. {% endstep %} {% step %} ### Abra a lista de protocolos Salvar **Protocolos**, depois clique em **+** para adicionar uma configuração. {% endstep %} {% step %} ### Acesse as configurações do 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 ID de cliente do ILSP * **Senha**: seu segredo de cliente do ILSP {% endstep %} {% step %} ### Ative e salve Ative **Ativado**, depois clique em **para salvar o comando. Clique em**. Um retransmissor que não está ativado não envia nada. {% endstep %} {% step %} ### Vincule o retransmissor a um dispositivo No dispositivo **Encaminhamento de dados** bloco, ative o alternador do retransmissor que você criou e, em seguida, clique **para salvar o comando. Clique em**. {% endstep %} {% step %} ### Defina o ID externo Clique no ícone de link à direita da linha do retransmissor e, em seguida, insira os três valores que identificam este veículo para o ILSP, separados por um caractere de barra vertical: ``` 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 o ILSP. A configuração do retransmissor é compartilhada em toda a conta, mas o ID externo é definido por dispositivo. {% endstep %} {% endstepper %} ## Gerenciar encaminhamento Para alterar ou interromper o encaminhamento para o ILSP: * Clique no ícone de link à direita da linha do retransmissor para alterar o ID externo de um dispositivo. * Desative o alternador para interromper o encaminhamento de um dispositivo e manter a configuração para os outros. * Salvar **Protocolos**, 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 **Protocolos** 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 ILSP, verifique o seguinte, nesta ordem: 1. O retransmissor está ativado e seu alternador está ligado para o dispositivo. 2. O ID de cliente e o segredo do cliente estão corretos. Cinco solicitações de token com falha desativam o retransmissor, então corrija as credenciais e, em seguida, altere **Ativado** desligue e ligue novamente. 3. O endereço e a porta estão corretos. 4. O ID externo tem as três partes na ordem correta, separadas por barras verticais, 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 do 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.