Setting up SIGFOX callbacks

To receive data from the devices, UnaConnect has multiple callbacks to allow SIGFOX services to forward the data. The first thing to know is that all callbacks are protected by a group token unique. It is retrievable via UnaConnect Console in the Group Settings.

  • On the left, the sidebar allows to navigate between the different pages of UnaConnect.
  • Click on Settings.
  • Press Copy Token to copy the token into your clipboard.
  • Go to SIGFOX backend and into the Callbacks page of the Device Type of your choice.
  • Press New and provide the following information according to your needs.
⚠️ For all types of callback, the HTTP method is POST. One header has to be provided: header Authorization and value Bearer TOKEN_OF_GROUP_COPIED. The content-type must be application/json

Type DATA
Channel URL
Subtype BIDIR
URL pattern https://network.unaconnect.io/sigfox/data with the following Body:
{
  "device": "{device}",
  "data": "{data}",
  "time": "{time}",
  "seqNumber": "{seqNumber}",
  "ack": "{ack}"
}

Type SERVICE
Channel URL
Subtype DATA_ADVANCED
URL pattern https://network.unaconnect.io/sigfox/data-advanced with the following Body:
{
    "device": "{device}",
    "time" : "{time}",
    "seqNumber": "{seqNumber}",
    "linkQuality": "{linkQuality}",
    "fixedLat": "{fixedLat}",
    "fixedLng": "{fixedLng}",
    "operatorName": "{operatorName}",
    "countryCode": "{countryCode}",
    ⚠️ "computedLocation": {computedLocation}, ⚠️
    ⚠️ "duplicates": {duplicates} ⚠️
}
⚠️ computedLocation and duplicates ARE ONLY ACCESSIBLE IF YOUR CONTRACT SIGFOX ALLOWS IT

Type SERVICE
Channel URL
Subtype STATUS
URL pattern https://network.unaconnect.io/sigfox/status with the following Body:
{
  "device": "{device}",
  "time": "{time}",
  "batt": "{batt}",
  "duplicate": "{duplicate}",
  "seqNumber": "{seqNumber}"
}

Type SERVICE
Channel URL
Subtype ACKNOWLEDGE
URL pattern https://network.unaconnect.io/sigfox/acknowledge with the following Body:
{
  "device": "{device}",
  "time": "{time}",
  "infoCode": "{infoCode}",
  "infoMessage": "{infoMessage}",
  "downlinkAck": "{downlinkAck}",
  "downlinkOverusage": "{downlinkOverusage}"
}

Type ERROR
Channel URL
URL pattern https://network.unaconnect.io/sigfox/error with the following Body:
{
  "device": "{device}",
  "time": "{time}",
  "info": "{info}",
  "severity": "{severity}"
}

Event Type Any
Channel URL
URL pattern https://network.unaconnect.io/sigfox/event
{
"time":"{time}",
"severity":"{severity}",
"sourceId":"{sourceId}",
"sourceType":"{sourceType}",
"eventType":"{eventType}",
"deviceMessageTime":"{deviceMessageTime}",
"contractId":"{contractId}",
"businessOperatorId":"{businessOperatorId}",
"deviceTypeId":"{deviceTypeId}",
"groupId":"{groupId}",
"subscriptionState":"{subscriptionState}"
}