This tutorial provides a step-by-step guide to integrate Actility 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. You can also find a similar document on the Actility webpage.
This document provides a step-by-step guide on how to connect TagoIO with Actility, a LoRaWAN network server provider. 

Prerequisites

Before you begin, ensure you have the following:

• Actility Account: If you don't have one, register here.
• LoRaWAN Device: Ensure your device is connect to Actility 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., Actility-Integration).
   
3. (Optional) Enter your Downlink URL from Actility into the Additional Parameters section.
   
1. You may only be able to generate the Downlink URL in Step 3.
4. Click Save.
   
3. Copy the Authorization Token:
   
1. After creation, copy the authorization token. You will need this in later steps.
   

Only one Authorization per application is necessary. Don't do it for each device.

---

Step 2: Set Up Integration in Actility

Go to your Actility console and create a new Connection. You can create a new connection under the menu Connections > Create > Select HTTPs or TPX > Choose TagoIO as the destination.

Configure the Connection:

Name	Enter a unique identifier (e.g., tagoio-integration).
Authorization Key	Set its value to the TagoIO Authorization token you copied in Step 1.

To set up downlinks for your application integration, follow these steps:

1. Click on the "Open ThingPark X IOT Flow" button on the application integration page.
   
1. This will take you to a page where you can see the Downlink URL of your application.
   
2. Copy the Downlink URL from the Actility page.
3. Go back to the Authorization page at TagoIO and edit the authorization that you created earlier.
1. Click on the pencil button to edit it.
   
4. Paste the Downlink URL into the Additional Params field of the authorization.
   

Step 4: 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 Actility.
2. The Device EUI must match exactly to establish a successful connection between Actility and TagoIO.
2. Select the Appropriate Network and Device Type:
1. Choose the Actility 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.