Helpful

Certification

Sigfox Certifications

Sigfox Certification HandbookWho certifies What ?Why certification?

Sigfox Verified

Sigfox Verified certification processBe prepared for Sigfox RF & Protocol Tests
Callbacks & APICallbacks

Custom Callback Creation

Context

This article explains how to create a custom callback.

Procedure

  1. Click on the Device type tab.
  2. In the Name column, choose the Device type that you want to create your callback for.
  3. Click on Callbacks on the left side menu.
  4. Click on the New button, located on the upper right side of the screen.
  5. Choose Custom Callback.
  6. Configure your Custom Callback

Custom callback configuration

Type

Choose the desired type within the drop-down menu.

  •   DATA / UPLINK: to deliver uplink messages to a customer platform.
  •   DATA / BIDIR: same as DATA/UPLINK type, including downlink payload processing from the customer platform.
  •   ERROR: to ease the troubleshooting in case of communication failure.
  •   SERVICE: to enable additional services.
    1. STATUS: device battery and temperature information
    2. GEOLOC: to be used only if the geolocation service is enabled. 
    3. ACKNOWLEDGE: to retrieve the network acknowledgement confirming the downlink message transmission.
    4. REPEATER: service messages (battery, number of repeated messages,…) from repeater devices.
    5. DATA_ADVANCED: Some variables are computed over the different BS which received the messages and thus this callback is delayed by approximately 30s: 
      • The following variables are available today: device, time, data, seqNumber, lqi, fixedLat, fixedLng, operatorName, countryCode. 
      • Extra variables will be available in future releases based on contract option such as computedLocation, MetaData.

Send duplicate

Related to the deprecation of MetaData in the DATA callbacks, a warning is added when editing or creating a callback: 

The feature send duplicate and the following information: snr, station, avgSnr, lat, lng, rssi, will not be available anymore for customers in the DATA callback feature from the first of June 2019.

Please contact your Sigfox Operator in order to answer this service continuity.

Channel

Choose the communication means.

  • URL: to push the data to a single URL destination.
  • BATCH_URL: This option pushes the data transmitted by devices within a 1 second time period.
  • EMAIL: to get the callback data in your email address.

Custom payload configuration

This option allows the user to decode the payload within the Backend GUI. For more information, please click on the question mark icon.

URL pattern

Define the HTTP request to be pushed to your server, including available variables. An example is displayed in the GUI.

HTTP method

Three HTTP methods can be used:

  • GET
  • POST
  • PUT

SSL/TLS configuration

It is possible to enable the Server Name Indication (SNI) to start the SSL/TLS handshaking process.

Can't find what you're looking for ?

Have questions? Our worldwide Community of expert fans can answer them.
Have answers? Join the Community and help!

sigfoxask

Ask the community >