Reencaminhar a partir da sua plataforma de seguimento

Os seus rastreadores continuam a enviar para onde enviam hoje. A sua plataforma reencaminha as posições para aqui: sem SMS, sem ir aos veículos.

Nesta página

Traccar (e GPSWox)
Wialon e Navixy (Wialon IPS)
flespi
Qualquer outra plataforma: o webhook
Como as unidades são associadas

Ative-o na consola: Frota → Rastreadores GPS → Mais → Ligar a sua plataforma. Aí encontra o token da sua organização e os endereços abaixo já preenchidos. As unidades que a sua plataforma envia são associadas aos seus rastreadores pelo IMEI ou pelo identificador da unidade; as que ainda não adicionou aparecem listadas aí, cada uma adicionada com um toque.

Atenção:

O token nestes endereços é a chave: mantenha-o secreto. Se for divulgado, atribua um novo token ao reencaminhamento na mesma folha; o antigo deixa de funcionar de imediato.

Traccar (e GPSWox)

No traccar.xml, reencaminhe as posições e os eventos em JSON:

traccar.xml

&lt;entry key='forward.enable'&gt;true&lt;/entry&gt;
&lt;entry key='forward.url'&gt;https://nways.ng/v1/trackers/forward/O_SEU_TOKEN/traccar&lt;/entry&gt;
&lt;entry key='forward.json'&gt;true&lt;/entry&gt;
&lt;entry key='event.forward.enable'&gt;true&lt;/entry&gt;
&lt;entry key='event.forward.url'&gt;https://nways.ng/v1/trackers/forward/O_SEU_TOKEN/traccar&lt;/entry&gt;

O N-Ways lê o uniqueId do aparelho, a posição (velocidade em nós) e, nos seus atributos, ignition, power, battery, batteryLevel, sat, totalDistance e alarm; os eventos ignitionOn, ignitionOff, alarm e deviceOverspeed. Sem JSON, também funciona um modelo de URL:

cURL

https://nways.ng/v1/trackers/forward/O_SEU_TOKEN/osmand?id={uniqueId}&amp;lat={latitude}&amp;lon={longitude}&amp;timestamp={fixTime}&amp;speed={speed}&amp;bearing={course}

Wialon e Navixy (Wialon IPS)

Adicione um retranslator (Wialon) ou um destino de reencaminhamento (Navixy) no protocolo Wialon IPS, para o servidor trk.nways.ng, porta 5039. O identificador único de cada unidade é o seu IMEI, e a palavra-passe é o seu token.

flespi

Adicione um stream do tipo HTTP para https://nways.ng/v1/trackers/forward/O_SEU_TOKEN/flespi, no formato de mensagens predefinido do flespi. O N-Ways lê ident, timestamp, position.*, engine.ignition.status, external.powersource.voltage, battery.* e vehicle.mileage.

Qualquer outra plataforma: o webhook

Envie (POST) JSON para https://nways.ng/v1/trackers/forward/O_SEU_TOKEN/webhook, ou para https://nways.ng/v1/trackers/forward/webhook com Authorization: Bearer O_SEU_TOKEN. Uma posição, uma lista, ou {"positions": [...]}, no máximo 500 por pedido e 2 MB.

Uma posição

{"positions": [{
  "unitId": "356307042441013",
  "name": "Hiace 2",
  "lat": 6.6018, "lng": 3.3515,
  "time": "2026-10-23T09:41:00Z",
  "speedKmh": 42, "heading": 90,
  "ignition": true, "extVoltage": 12.6, "batteryPct": 88,
  "alarms": ["sos"]
}]}

Campo	O que é
`unitId` (ou `imei`)	Obrigatório. De 4 a 40 letras, algarismos, - ou _: é o que associa a unidade aos seus rastreadores.
`lat`, `lng` (ou `lon`)	Graus, WGS 84. Omita ambos para um evento sem posição.
`time` (ou `timestamp`)	ISO 8601, ou segundos ou milissegundos desde a época Unix. Por omissão: agora.
`speedKmh`, `heading`, `altitude`, `accuracy`, `sats`	km/h, graus, metros, metros, satélites.
`ignition`, `extVoltage`, `batteryV`, `batteryPct`, `odometerKm`	A ignição, a alimentação externa (V), a bateria e o conta-quilómetros do veículo.
`alarms`	`sos`, `power_cut`, `overspeed`, `low_battery`, `tow`, `crash`, `vibration`, `geofence`, `removal`.
`valid`	`false`: guardada no registo do aparelho, nunca no mapa.
`name`	O nome da unidade na sua plataforma (dá nome ao veículo quando o adiciona).

A resposta é {"taken": 1, "unknown": ["<unidades ainda não adicionadas>"]}. Erros: 401 INVALID_FORWARDING_TOKEN, 400 com o que está errado e em que posição, 403 TRACKERS_OFF enquanto o N-Ways tiver os seus rastreadores desativados, 413 acima de 2 MB ou de 500 posições.

Como as unidades são associadas

Uma unidade cujo IMEI ou identificador corresponde a um dos seus rastreadores move o respetivo veículo, e os seus alarmes disparam os seus alertas.
Uma unidade que não adicionou aparece listada na consola, com o que enviou por último. Adicione-a com um toque: é criado um veículo com o nome dela.
As posições em 0, 0 ou fora da África Ocidental, e as vindas do futuro (um relógio no fuso horário errado), ficam no registo do aparelho e nunca movem um veículo.