You are viewing an Archived item in your Knowledge Base, it is not publicly accessible.

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Digital Matter Site
  • Contact Us

Provisioning for Telematics Guru on the Sigfox Backend

Written by Matthew Clark-Massera

Updated at March 5th, 2025

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Contact Support
  • Home
  • Devices

If you have registered Oysters on a private Sigfox account, and wish to connect them to Telematics Guru, you need to configure your Sigfox account to forward the data. This is done by adding a callback to the device type that you are using for your Oysters.

First, log in to your private Sigfox account at backend.sigfox.com.

Locate the device type that the Oysters are using, and click on the device type name:

In the information tab for the device type, click Edit:

Now set the downlink mode to Callback. You must do this even if you are not planning on supporting downlinks, as leaving it set to DIRECT will send downlinks and cause unintentional reprogramming. 

If you want to see more detail in the device messages tab on backend.sigfox.com, you can optionally change the payload parsing from Regular (raw payload) to Custom grammar, and populate the custom configuration field with:

Type:0:uint:4::3 InTrip:0:bool:4 FixFailed:0:bool:5 Lat:1:int:32:little-endian Long:5:int:32:little-endian Heading:9:uint:8 Speed:10:uint:8 Vbat:11:uint:8

Now go to the Callbacks tab, and click the New button in the top right:

Now select Custom callback:

For Telematics Guru:

Fill in the Type, Channel, Url pattern, Use HTTP Method, Content type, and Body shown below. 

The URL shown is in the form:

http://<device-region>.telematics.guru:8081
HTML

The device region in the URL is important to target the correct regional instance of Telematics Guru. Refer to this article for an explanation of the regions and the device specific URLs. A short summary is:

Region Device URL
Global (old) http://telematics.guru:8081
APAC01 http://device-apac01.telematics.guru:8081
APAC02 http://device-apac02.telematics.guru:8081
APAC03 http://device-apac03.telematics.guru:8081
EMEA01 http://device-emea01.telematics.guru:8081
EMEA02 http://device-emea02.telematics.guru:8081
EMEA03 http://device-emea03.telematics.guru:8081
AMER01 http://device-amer01.telematics.guru:8081 
AMER02 http://device-amer02.telematics.guru:8081 

Based on which server your Partner account is hosted you will need to use the related URL.

The full text of the Body field is:

{

"device":"{device}",

"time":"{time}",

"data":"{data}",

"seqNumber":"{seqNumber}",

"deviceTypeId":"{deviceTypeId}",

"ack":"{ack}"

}

NB: The available variables differ depending on the subscriptions, the variables on the Body text should match the ones that are available to you on your account.

Finally, select your new callback as the default for downlinks, by clicking the Downlink radio button:

It is possible to setup multiple callbacks to deliver data to multiple platforms. Be sure to select the correct one for the downlink messages.

sigfox telematics

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

Subscribe to Partner News

Subscribe to our mailing list to receive Digital Matter news, product and tehnical updates, and more.

Subscribe

Copyright © Digital Matter . All Rights Reserved.

Privacy Contact Support

Knowledge Base Software powered by Helpjuice

Expand