TagoIO Integration

This guide for integrating the Tektelic NS with the TagoIO application server assumes that you already have a gateway and sensor online on the Tektelic NS. If you do not yet have a gateway and sensor online on the Tektelic NS, please see the following link:

https://knowledgehub.tektelic.com/tektelic-core-network-server-getting-started

Integrating Tektelic NS and TagoIO with Supported Tektelic Sensor:

To learn how to integrate Tektelic NS with TagoIO using a TagoIO supported sensor, please see the instructions below:

First go to your TagoIO account, and if this is your first device connected between Tektelic and TagoIO, you will need to create an Authorization here . Copy it to use in the integration created from the Tektelic network server later on.
Note: You just need to create one Authorization for all your devices.
TagoIO offers "Connectors" that can used to decode sensor payloads on TagoIO's end. To use these TagoIO Connectors, a "Pass-Through" data converter should be used. Please see instructions for adding this "Pass-Through" data converter below:
1. In the left hand pane of the Tektelic CORE Network Server, select "Data Converters"
2. Select the "+" symbol in the top right of the page
3. Give the Data Converter a name such as "Pass Through Data Converter"
4. For "Type" scroll to the bottom of the page and select "Custom v1"
5. Select "Add"
6. You have now created a Pass Through Data Converter to be used in the TagoIO integration.
Now we can create the integration between Tektelic and TagoIO. In the left hand pane of the Tektelic CORE Network Server, select "Applications"
Click on the Application you wish to integrate with TagoIO
Select the "Manage Integrations" tab
In the top right hand side of the page, select the "+" button to add an integration
Name your Integration and select "TagoIO" for the integration "Type"
1. Data Converter: Pass Through Data Converter created in Step 2
2. Authorization: Authorization generated in Step 1
Select "Add"
Once the integration has been created, select the integration and copy the HTTP URL Path
Go back to your Authorization page at TagoIO and edit your previously created authorization by clicking in the pencil button. Paste the HTTP URL path copied from Tektelic along with your Tektelic API address.

Depending on the region of your server, it may be something like:
https://lorawan-ns-na.tektelic.com/ or
https://lorawan-ns-eu.tektelic.com/

The end result should be as follows:

https://lorawan-ns-na.tektelic.com/api/v1/integration/http/xxxx
Now that the integration has been set up, you can begin adding your devices to TagoIO. Go to "Devices/LoraWaN Tektelic", and choose the device connector from the list. Enter your device EUI.
Your integration is now complete. You should be able to see your device in TagoIO with "Last Input" corresponding to the last time an uplink was sent from the sensor. Additionally, you can view the payloads sent by the sensor from the devices "Inspector" tab as seen below:

Integrating Tektelic NS and TagoIO with Unsupported Tektelic Sensor:

If you need guidance on setting up the integration between Tektelic NS and TagoIO with a sensor that is not officially supported by TagoIO, please refer to the instructions below:

First go to your TagoIO account, and if this is your first device connected between Tektelic and TagoIO, you will need to create an Authorization here . Copy it to use in the integration created from the Tektelic network server later on.
Note: If the devices you are using are not officially supported by TagoIO, you will need to create a separate Application and Integration on the Tektelic NS for each device. Each unique Application / Integration will require its own Authorization.
Since TagoIO does not officially support the sensor at this point in time, a Data Converter for the sensor must be added on the Tektelic NS to decode the data before it arrives to TagoIO. Please see instructions for adding the data converter below:
1. In the left hand pane of the Tektelic CORE Network Server, select "Data Converters"
2. Select the "+" symbol in the top right of the page
3. Give the Data Converter a name to identify what device this data converter is for.
4. For "Type" scroll to the bottom of the page and select "Custom v1"
5. From the following Github link, select the "Tektelic v1" folder and select the sensor you would like the data converter for.
  1. https://github.com/TektelicCommunications/data-converters
6. Select all of the decoder and copy it. Paste the copied decoder into the "Decoder" section of the Data Converter we are creating in the Tektelic NS.
7. Select "Add"
8. You have now created a Data Converter to be used in the TagoIO integration.
Now we can create the integration between Tektelic and TagoIO. In the left hand pane of the Tektelic CORE Network Server, select "Applications"
Click on the Application you wish to integrate with TagoIO
Select the "Manage Integrations" tab
In the top right hand side of the page, select the "+" button to add an integration
Name your Integration and select "TagoIO" for the integration "Type"
1. Data Converter: Pass Through Data Converter created in Step 2
2. Authorization: Authorization generated in Step 1
Select "Add"
Once the integration has been created, select the integration and copy the HTTP URL Path
Go back to your Authorization page at TagoIO and edit your previously created authorization by clicking in the pencil button. Paste the HTTP URL path copied from Tektelic along with your Tektelic API address.

Depending on the region of your server, it may be something like:
https://lorawan-ns-na.tektelic.com/ or
https://lorawan-ns-eu.tektelic.com/

The end result should be as follows:

https://lorawan-ns-na.tektelic.com/api/v1/integration/http/xxxx
Now that the integration has been set up, you can begin adding your devices to TagoIO. Go to "Devices/LoraWaN Tektelic", and choose the "Custom Tektelic" device connector from the list. Enter your device EUI.
Your integration is now complete. You should be able to see your device in TagoIO with "Last Input" corresponding to the last time an uplink was sent from the sensor. Additionally, you can view the payloads sent by the sensor from the devices "Inspector" tab as seen below: