The Things Network

Website: https://www.thethingsnetwork.org/ 

Overview

Prerequisites

Analysis

  • Information about the devices connected to The Things Network (brand, model).
  • Information about the data sent by these devices. Our team can help in exploring the data. 
  • Access to The Things Network

Data Fetch

  • Access to The Things Network.
  • Devices configured and sending data through the network.

Data Delivery

To send event data to EarthRanger, you will need:

  • A special EarthRanger user (e.g., “Gundi Service Account”) for this integration. 
    Please refer to EarthRanger's documentation or contact our Support team.
  • A long-lived token for authentication assigned to the user created in the previous step. 
    Please refer to EarthRanger's documentation or contact our Support team.

Configuration 

 

Self-Service integration not available yet, please contact our Support Team.

This integration requires assistance from our support team for setup and configuration. Please contact our support team at support@earthranger.com and we’ll guide you through the process to ensure everything is set up correctly.

We are actively working to make this integration self-service in the future. Stay tuned for updates!

GUIDES

1. Configuration in Gundi

These steps can only be performed by the development team. We are actively working to make this integration self-service in the future. Stay tuned for updates!

Tasks:

  • Set up a connection using a Custom Webhook.
  • Visit the Connection and take note of its API key, as it will be required in the next step.
  • Configure the webhook using JQ* (requires help from the Gundi Development team).

2. Configuration in The Things Network

  • Log in to The Things Network using your account.
  • Find the “Application” containing the device(s).
  • Navigate to “Webhooks”.
  • Click on +Add webhook.
  • Select Custom webhook.
  • Write a name for your webhook under “Webhook ID” (for example: gundi-webhook).
  • Select JSON as the Webhook format.
  • Type https://hooks.gundiservice.org as the Base URL.
  • Add two header entries:
    • apikey. Value provided by the Gundi Team. 
    • x-gundi-integration-type.  Value: generic_webhooks

Example:

  • Select the box “Uplink message”
  • Click on Add webhook.

3. Configuration in EarthRanger

The following configurations are optional:

3.1. Select the data you want to see in the map.

3.1.1 Log in to EarthRanger as an admin (site.pamdas.org/admin).
3.1.2 Go to Source Providers.
3.1.3 Select the Source Provider created for this integration (e.g., "webhook_the_things_network")

The “Source Provider” is automatically created after Gundi successfully retrieves data from this integration and pushes it to EarthRanger. If you don't find it, please ensure your Connection includes a Destination, and review the Connection Activity Logs for additional details. You should see some records mentioning that Gundi successfully delivered data to EarthRanger.
Important Note:  The integration might take 5 minutes to run. Please verify your connection after this period.

3.1.4 Click on Subject Details Configuration.
3.1.5 Configure the additional information you would like to see on the map.

3.2 Assign your Subjects to a Subject Group.

3.3 Rename your Subjects

Please refer to EarthRanger's documentation or contact Support.

Troubleshooting

If your devices are not showing in the destination system (e.g., EarthRanger), please check if your devices are sending their location to The Things Network.

  • Navigate to the appropriate Application and click on “Message Storage”. Confirm if the decoded payload includes location. Example:
  • Navigate to the appropriate Application and click on “Live Data”. Confirm if the decoded payload includes location. 

    Notice the lack of location data in the following example:

 

Note on Latency

The time it takes for data to appear in your destination system depends on several factors, such as latency introduced by the source, network conditions, and intermediary systems. While these factors may vary, Gundi typically checks for available data at scheduled intervals (approximately every 5 minutes).

If data is not available in your system after this interval, please check the source of the data for its availability. If the issue persists, contact our Support team for assistance.

 

 

 

Movement Data, Push Integration, Webhook, Data Provider
May 13, 2025