External provider - Meraki

Cisco Meraki Wireless Access Points with Bluetooth capabilities can be integrated with Kontakt.io Location Engine platform as external data providers, similarly to Kontakt.io Gateways. In order to make your Meraki devices available in Location Engine, a short setup is required.

Instructions available below assume you already have a Cisco Meraki Wireless Access Point set up and properly configured with Cisco Meraki account. For more information on how to do that, please refer to Meraki support.

Enable Cisco Meraki Dashboard API

Integration with Meraki devices requires enabling access to Cisco Meraki Dashboard API. Please log in to your Cisco Meraki Dashboard, select Organization and click on Settings. Scroll down and make sure that Enable access to the Cisco Meraki Dashboard API is selected.

Generate Meraki API Key

Click on the link in the description below the Enable access to the Cisco Meraki Dashboard API checkbox or in the top right corner click on your email address and select My Profile. Once you're on your profile settings page, scroll down to the API access section and click on Generate new API key button. This API key needs at least read-only access to your Meraki organization.

Copy the newly generated key since you will need it for later.

Get Validator

Go to Network-wide section in Dashboard's sidebar and select General from the Configure column. Scroll down to Location and scanning section on the newly opened page. Make sure that Analytics and Scanning API is enabled. Then, same as with the API key, copy the Validator value for later use.

Add a new provider

Keep the Cisco Meraki Dashboard open and in a new tab/window log in to your Kontakt.io Panel account. Once there, please (1) go to Gateways section, (2) select External providers and (3) click the Start Meraki Integration button.

Configure your Meraki integration

On the next screen enter the (1) Cisco Meraki Dashboard API key and (2) Validator in their respective form fields. Then enter your own (3) Secret or just click the (4) Generate Secret button to if you want us to generate a secure value for you.

Copy the Secret, since it will be needed later, same as the (5) API endpoint that Meraki will use to send collected data. Once everything is filled and copied, click the (6) Enable Meraki Integration button.

Add Meraki devices

In the next step a new form will appear where you should enter a MAC address that identifies your Meraki device, and then (1) press the Add Device button. Repeat this process for all Meraki access points you want to add as Location Engine sources.

Once you have added all devices, (2) press the Finish Integration button.

Configure data destination

Before precessing with this step, please wait In Cisco Meraki Dashboard go to Network-wide section in Dashboard's sidebar and select General from the Configure column, then scroll down to Location and scanning section. In this section add (1) a Post URL that you've copied from Kontakt.io Panel and (2) enter your Secret. Make sure the (3) API Version is set to 2.0 and click the Save button that will appear in the bottom-right corner of the page.

IMPORTANT - Meraki infrastructure needs few minutes to process the integration request and start sending data to our backend, so you won't see new data in our MQTT/WebSocket streams right away. You can check the when everything is working by (4) clicking the Validate button.

Remove Meraki integration

To completely remove integration with Meraki, go to the External providers section and click the Remove integration button.

Remove a single Meraki device

If you don't want to completely disable your Meraki integration, but want to remove just some of your Meraki Access Points, you can go to Gateway list section, and click the trashcan icon that will appear next to the Edit button when you hover on the line with a Meraki device you want to remove.