How to integrate TagoIO with Kinéis

How to integrate TagoIO with Kinéis

This tutorial provides a step-by-step guide to integrate Kinéis with the TagoIO Platform. By following these instructions, you will enable uplink and downlink operations, allowing data exchange between your LoRaWAN devices and the TagoIO application.

Prerequisites

Before you begin, ensure you have the following:
  • Kinéis Account: If you don't have one, register here.
  • LoRaWAN Device: Ensure your device is connect to Kinéis and transmitting data.

Step 1: Create Authorization in TagoIO

  1. Access Authorizations:
    1. Go to Devices.
    2. Click on Authorizations at the top of the page.
  2. Create a New Authorization:
    1. Click the Create Authorization button.
    2. Provide a meaningful name for the authorization (e.g., Kinéis-Integration).
    3. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps.


InfoNote : You only need to create a single Authorization code to connect Kinéis to TagoIO for all your devices.


Step 2: Set Up Integration in Kinéis

Go to your Kinéis Portal and create a new distribution. You can create a new distribution under the sidebar Distribution Sidebar Icon > Configuration > Plus sign. 

2.1 Configure the Distribution:

  1. Add a Distribution Code.
  2. Add a Distribution Name.
  3. Fill in the "Active" Checkbox.
  4. Click "NEXT".

2.2 Select Your Devices
  1. Click the Plus button to add a new devices group.
  2. Add a Device Group Code.
  3. Add a Device Group Name.
  4. Select the devices to send data to TagoIO.
    1. Select them by checking their box and clicking the ">" button to change their position to the right panel.
  5. Click "CREATE".
  6. Click "NEXT".
NotesNote : The "Device ID" seen here is the Device ID you will utilize when adding the Device at TagoIO.

2.3. Select Your Data Types and Formats
  1. Click the Plus button to add a new distribution format.
  2. Add a distribution data code.
  3. Select the "Processed type Basic" reference format.
  4. Click "CREATE".
  5. Click "NEXT".

2.4. Select Your Distribution Endpoint.
Press the Plus button to add a new distribution endpoint group.

Configure the distribution:
Field
Description
CodeEnter a unique identifier (e.g., tagoio-integration).
Protocol
HTTP
URLUse the endpoint format https://kineis.middleware.REGION.tago.io/uplink.
Replace REGION with your deployment region (e.g., us-e1, eu-w1).
For a list of available regions, visit TagoIO Network Integration.
Authentication
None
Headers*-KeyEnter the word Authorization
Headers*-ValueSet its value to the TagoIO Authorization token you copied in Step 2.



Info
The endpoint https://kineis.middleware.tago.io/uplink points to the USA region. As we are committed to continuing support for this endpoint, we recommend that users in the USA region update their webhooks to https://kineis.middleware.us-e1.tago.io/uplink.



2.5. Confirmation
  1. Verify the information you've entered is correct.
  2. Press "SAVE".


Step 3: Add Device in TagoIO

To integrate your device with the TagoIO Platform, follow these guidelines:
  1. Ensure Device EUI Consistency:
    1. When creating the device in TagoIO, use the exact same Device EUI that is configured in Kinéis.
    2. The Device EUI must match exactly to establish a successful connection between Kinéis and TagoIO.
  2. Select the Appropriate Network and Device Type:
    1. Choose the Kinéis Network during the device setup process.
    2. Select the correct device type from the available options. If your device is not listed, you can add support through connectors.
  3. Add Device Support via Connectors (If Necessary):
    1. If your device type is not available in the default list, enhance its compatibility by utilizing connectors.
    2. For more information on available connectors and how to use them, refer to the Connector Overview.
For detailed instructions on adding devices, visit the Adding Devices page.



Finalizing Setup

  1. Power On Your Devices:
    1. Turn on your LoRaWAN device and gateway to initiate data transmission.
  2. Verify Data Reception:
    1. In TagoIO, navigate to the Device and into the Data tab to confirm that data is being received.
    2. Alternatively, use the Live Inspector within your device settings to monitor incoming data in real-time.

With data successfully flowing into TagoIO, you can start creating dashboards, add notifications, and create scripts to process your data. 

Learn how to perform downlink for LoRaWAN.