The verification-code is deprecated, now you need to use Authorization instead. This article has been updated to help you to setup using Authorization.

Sigfox is a relatively low-cost wireless network technology that requires low power to connect, and that is implemented by lost cost hardware modules.

Uplink is the process to send data from the devices to TagoIO. The Downlink is used to send data back to the devices. Access this documentation to learn about downlink.

Follow these steps to setup the Sigfox Backend and TagoIO.


1. TagoIO setup

From your TagoIO account, go to Devices, click on 'Add Devices', and filter by Sigfox. Then, search for the device that you want to add. If you don't find it, select the type Custom Sigfox Device.

When selecting Custom Sigfox Device, a payload parse will NOT included on the new device. You will need to add your own parser to extract values. 

Just give a name for the device, type the Device ID, and click on the'Create Device' button. 

For example, if you selected the 'Custom Sigfox Device' type, you will be presented with the following screen. 

After a device is created, a standard parser is included in the 'Payload Parser' tab based on the selected connector (unless you selected Custom Sigfox). Later, you can add your own script to execute any calculation or to parse more data. 

Then, you need to create an Authorization and use it in the Orbiwise setup later. 

The Authorization should be generated by TagoIO here; no Additional Parameters are needed.


2. Sigfox Setup

On the Sigfox Backend Portal, you will need to create a callback type 'uplink'. We will use the Data Uplink option to obtain the basic information in the messages.

If your contract with Sigfox allows you to get more information like RSSI, SNR, STATION, you can use the Advanced Data option

Click on the Device Type  and select your device from the list. Click on the Callback button, then click on New, and select the option Custom callback.
Configure the uplink with the instructions below.

Let's setup the callback using the option 'Data Uplink':
- Type:  DATA & UPLINK
- Channel: URL
- URL: https://sigfox.middleware.tago.io/uplink
- Use HTTP Method: POST
- Send SNI: Check the box "Send SNI".
- Headers: Add two rows in the Headers section inside the header and value fields:

 header value
 device  {device}
authorization<authorization generated by TagoIO>

- Content-type: application/json
- Body: Copy and paste the JSON text below.

[{
    "variable": "device",
    "value": "{device}",
    "serie": "{time}"
},{
    "variable": "data",
    "value": "{data}",
    "serie": "{time}"
},{
    "variable": "seqNumber",
    "value": "{seqNumber}",
    "serie": "{time}"
}]

Your uplink integration is now complete!

Information about Downlink can be found here.


You also can create your own parse scripts to process variables from the payload.