# How to integrate the CoWork Kit with Actility on akenza

{% hint style="success" %} **The CoWork Kit contains**: * 1x AI Workplace Occupancy Sensor VS121 * 1x Smart Scene Panel WS156 * 1x Magnetic Contact Switch WS301 * 1x PIR & Light Sensor WS202 * 1x Smart Button WS101 * 1x LoRaWAN Gateway UG65 **Application examples**: * Measure people flow of an area, entry or exit (VS121) * Switch the status of your smart workplace between up to six scenes (WS156) * Detect window and door status and its usage (WS301) * Monitor Room usage (WS202) \ **Product Features**: * 98% Occupancy recognition rate (VS121) * Easy NFC-Configuration (all sensors) * Long battery life lasting (depending on the device) **You can purchase the Milesight CoWork Kit in the** [**ThingPark marketplace**](https://market.thingpark.com/milesight-cowork-kit.html) **of Actility.** {% endhint %} In this tutorial, you will learn how to connect the **Milesight CoWork Kit** to akenza. You will achieve the following: 1. Integrating your Actility account to your akenza environment 2. Creating Data Flows and Milesight devices on akenza 3. Creating your individual dashboard for data visualization ### 1. Getting started To get started with akenza, follow [these steps](https://docs.akenza.io/how-to-create-a-working-environment) in order to set up your environment. ### 2. Add an Actility Integration on akenza {% hint style="info" %} In order to proceed with the Actility integration on akenza, make sure to create a [ThingPark community account](https://community.thingpark.org/index.php/sign-up-tpcp/) and pre-commission the Milesight gateway to it as described [here](https://docs.thingpark.com/thingpark-enterprise/7.2/Content/BS-installation-guides/Provision-base-station.htm?tocpath=Using%20ThingPark%20Enterprise%7CManaging%20your%20radio%20access%20network%7CProvisioning%20the%20base%20station%20on%20ThingPark%20GUI%7C_____0). Follow this [link](https://docs.thingpark.com/thingpark-enterprise/7.2/Content/BS-installation-guides/Install-ThingPark-image.htm?tocpath=Using%20ThingPark%20Enterprise%7CManaging%20your%20radio%20access%20network%7CInstalling%20the%20ThingPark%20image%20on%20your%20base%20station%7C_____0) if you need to install Actility's firmware on the gateway. {% endhint %} The integration of Actility will be used to **connect**, **synchronize** and **manage** Assets on akenza. Start with the integration of your Actility account by adding your credentials on the Actility tab within *Integrations*. More details about Integrations (for ThingPark Enterprise only) can be found [here](https://www.actility.com/enterprise-iot-connectivity-solutions/).

If you use the community instance of ThingPark, the required Profile ID is ***community-api***. To find the Profile ID please check out the Actility API documentation of your account. See the example [here](https://community.thingpark.io/thingpark/dx/core/latest/swagger-ui/index.html?shortUrl=tpdx-core-tpe-api-contract.yaml). After successful integration, the Actility-account-integration gets displayed on the Connectivity Integration Overview.

### 3. Create Dataflow As a next step, go to *Data Flows* in your Workspace and choose as device connector *LoRa* and consequently, the Actility integration you have done in step 2. For data parsing continue with the selection in *Device Types* of your specific Milesight device. As an output connector, select the *akenza database*. This will store the data on akenza and allows further use on the dashboard composer. More about Data Flows can be checked [here](https://docs.akenza.io/akenza.io/get-started/your-data-flow). {% hint style="info" %} Data Flows consist of a **device connector**, a **device type,** and an **output connector** and define how device data are processed on akenza. {% endhint %}

Once all specific Data Flows are created for your devices, continue with the creation of your devices. ### 4. Create Assets To add a device to your environment, select *+Create Device* in the tab of *Assets* and fill in the required device parameters. By assigning the appropriate Data Flow, your device will be automatically registered and connected to your Actility account. Upon a join request, the device will turn online. Incoming data are displayed in *Message Logs* and also on the *Data Overview* of your device detail page.

{% hint style="warning" %} Currently, all devices are created with a **generic LoRa device profile**. Do not do any changes on the Actility account. {% endhint %} ### 5. Visualize IoT data with akenza's dashboard composer In order to visualize your data with the dashboard composer, switch to the dashboard composer by selecting *Dashboard* in the side navigation. You will get redirected to the dashboard overview. Select *Create a Dashboard* and start adding the Widgets of your choice. By adding the component *Chart*, the Source Tab allows to select the device of your choice and its data points. Customize the dashboard to your liking.

{% hint style="info" %} **Optional** Try out other akenza features such as the rule engine. The rule engine allows you to apply a business logic to your infrastructure. E.g. inform your teammates about certain conditions by using MS-Teams as notification service. Check out more [here](https://docs.akenza.io/akenza.io/tutorials/create-notifications/how-to-send-notifications-to-microsoft-teams). {% endhint %} {% hint style="success" %} **Support** Reach out to us if you need any further support: * [Actility](https://support.thingpark.org/portal/en/community/recent) * [Akenza](https://akenza.atlassian.net/servicedesk/customer/portal/4/group/-1) * Milesight * * [Technical Support Guidance](https://support.milesight-iot.com/support/solutions/articles/73000514218-milesight-iot-technical-support-guidance) {% endhint %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.akenza.io/akenza.io/tutorials/iot-starter-kits/how-to-integrate-the-cowork-kit-with-actility-on-akenza.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.