How to integrate TagoIO with TTN v3

How to integrate TagoIO with TTN v3

This tutorial provides a step-by-step guide to integrate The Things Network (TTN) v3 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:
  • TTN v3 Account: If you don't have one, register here.
  • LoRaWAN Device: Ensure your device is connect to TTN 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., TTN-Integration).
    3. Click Save.
  3. Copy the Authorization Token:
    1. After creation, copy the authorization token. You will need this in later steps.


Step 2: Set Up Integration in TTN v3

Go to your TTN v3 console and create a new Integration. You can create a new integration under the menu Integrations > Webhooks > Add Webhook.

Configure the Webhook:

Field
Description
Webhook ID
Enter a unique identifier (e.g., tagoio-integration).
Webhook Format
Select JSON from the dropdown menu.
Downlink API Key
Enter a preferred value. This key facilitates downlink operations to your devices via TagoIO.
Additional Headers
Add a header for Authorization and set its value to the authorization token you copied in Step 1.
Webhook Endpoint
Use the endpoint format ttn.middleware.REGION.tago.io. Replace REGION with your deployment region (e.g., us-e1, eu-w1).
For a list of available regions, visit TagoIO Network Integration.


    Save the Integration:

    • After filling in all the fields, click Save to create the webhook integration.
    The endpoint ttn.middleware.tago.io 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 ttn.middleware.us-e1.tago.io.


    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 TTN/TTI.
      2. The Device EUI must match exactly to establish a successful connection between TTN and TagoIO.
    2. Select the Appropriate Network and Device Type:
      1. Choose the LoRaWAN TTI/TTN v3 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, Analyses, and Actions to visualize and manage your device data effectively.