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

      • Configuring Forwarders

      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

      DM Logo
      Expand