The Things Network Bot

...

Getting started:

  • From the Bots page, Add a The Things Network Bot using the Add -> Add The Things Network Bot option from the top right drop down box.
Add sigfox bot
  • Enter the details requested on the Add The Things Network Bot dialog box
    • Bot Name is the friendly display name for your bot. If you need have more than one The Things Network account you may wish to name them differently here.
    • Auto-Add Devices allows the automatic creation of Tinamous devices for each LoRa device.
    • Device Prefix is optional and used when naming Tinamous devices to help identify the device (i.e. A device name in Sigfox is something like "TTNUno-1", with the prefix "LoRa" it will be called "Sigfox Device 0018AAD2" with the username @LoRaTTNUno-1 in Tinamous).
    • Click the Add button and wait for the call back information to be shown. Be sure not to close the dialog box.
    • IMPORTANT! Some of the information presented in the dialog box is only available at this time.
Sigfox bot added with instructions

Setting up the The Things Network Integration:

It is important to do this before closing the Add The Things Network Bot dialog box as the information you need is contained on the dialog box and is not available when it is closed. The Sigfox callback must be configured correctly to get measurements posted to Tinamous. We are not able to set this up via their API.

If you closed the dialog box simply delete the bot and add another one.

Add a Custom Callback:

Configure a custom callback at the Sigfox backend:
  • Navigate to the Sigfox Device Type page
  • Select CALLBACKS
  • Click [New]
  • Click Custom callback
Select Custom callback

Done:

  • The Sigfox Bot will appear in the bots list (you may need to refresh it).
  • If you gave the bot API access it will set-up Tinamous devices for your Sigfox devices and try to refresh this list with details on a regular basis.
  • If the bot does not have API access new Sigfox devices will appear as data is pushed to Tinamous.
  • Fields for the devices will be automatically created from the Fields section in the callback body. (e.g. version, temperature and humidity in this example)

The Tinamous Sigfox Bot stores your API Key encrypted in our database. You can revoke access for this key from the Sigfox backend should you need to.

Fault Finding:

If your callback isn't working check the following:
  • Try adding an email callback to ensure your device data is getting through to Sigfox.
  • Check the callback status is OK at Sigfox.
Configure the custom callback
  • If it is showing not authorized check the Header values on the callback
  • If it is showing a bad request it maybe missing the device details "Device" from the body
  • If it is showing a bad request it check you set the content type to application/json
  • If it was working and has stopped check you have not deleted the Sigfox Bot.

Modify Bot Details:

It is not currently possible to modify the The Things Network Bot once created. This will become available in the future. Please contact support if you need help with this.

Modify Device Details:

  • From the Devices page find your device and click Edit.
  • You can modify the basic Tinamous device details (i.e. display name) as you would do normal devices using Edit from the devices page. No changes are made to the Sigfox backend.
  • You can not modify the devices @Name this is fixed.
  • You should not give your device API permissions as it does not need to log into Tinamous.
  • Once a device has published a measurement the fields will be listed and can be edited.
  • When a new device added to Tinamous it is tagged with [Sigfox], [AutoAdded] and the Sigfox device type (if known), these tags can be removed or modified as needed.
Modify device details.