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.

Steps

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

ℹ️ SIGFOX DATA callback

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}"
}

SERVICE callbacks

ℹ️ SIGFOX DATA ADVANCED callback

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

ℹ️ SIGFOX STATUS callback

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}"
}

ℹ️ SIGFOX ACKNOWLEDGE callback

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}"
}

ℹ️ SIGFOX ERROR callbacks

Type ERROR
Channel URL
URL pattern https://network.unaconnect.io/sigfox/error with the following Body:

{
  "device": "{device}",
  "time": "{time}",
  "info": "{info}",
  "severity": "{severity}"
}

ℹ️ SIGFOX EVENT configuration

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}"
}