Partner App Management

Overview of Partner App Center

The Cisco Spaces - Partner Dashboard offers Cisco Spaces partners, a single location to view, update, add, and test their application. Cisco Spaces is seamlessly integrated with the Cisco Spaces - Partner App Center. As a partner, you can access location data that the access points collect and use this data to extend your business apps. Log in to the Cisco Spaces - Partner Dashboard to create and integrate your applications.


Note

This feature is available from Cisco Spaces Extend licenses.

Figure 1. App Center

The combination of the Cisco Spaces platform plus the Partner-led ecosystem provides the ability to work with third-party application developers, to build customized applications for individual businesses and customers, by leveraging the power of Cisco Spaces and the Cisco Spaces - Partner Firehose API.

Application developers use the Partner APIs, also called the Cisco Spaces - Partner Firehose API to create and publish their Apps. The Partner ecosystem allows independent software vendors to enable vertical-relevant, pre-validated, and tested location-based solution applications and to publish their live applications on the Cisco Spaces - Partner App Center. As a registered partner, you can access the Cisco Spaces - Partner App Center.

Your customers can view and activate the applications from the Cisco Spaces - Partner App Center. For example, your customer can click on any available App from the Cisco Spaces - Partner App Center and choose to activate the App for their business use cases. After the app is approved and made live in the Cisco Spaces - Partner App Center, it is available for all the customers of Cisco Spaces for activation. When a customer activates the app, the customer's data starts flowing to your app as events over the Cisco Spaces - Partner Firehose API.

For more information about Partner App Management, refer to Overview of the Cisco Spaces - Partner Ecosystem online help.

Partner Firehose event data and filter scope

For Cisco Meraki-connected customers, IOT_TELEMETRY events can include PM2.5 mass-concentration data when it is available from the source device.

Device-level Firehose events can also include occupancyAnalytics metadata for devices evaluated against Live Occupancy exclusion filters. The metadata indicates whether Cisco Spaces evaluated the device as INCLUDE or EXCLUDE. This behavior applies to the these events:

  • DEVICE_LOCATION_UPDATE

  • DEVICE_PRESENCE

  • DEVICE_ENTRY

  • DEVICE_EXIT

  • DEVICE_ASSOCIATION

Firehose filter APIs support independent event-type scope for MAC, MAC OUI, iBeacon, and Eddystone filters through these optional fields:

  • macFilterEventTypes

  • macOuiFilterEventTypes

  • iBeaconFilterEventTypes

  • eddystoneFilterEventTypes

If a field is omitted or contains an empty list, Cisco Spaces retains the default event scope. GET returns the effective event-type scope for each filter. DELETE clears the configured filters and resets the event-type scopes to their default behavior.

Activate an App

Cisco Spaces partners uses Partner Dashboard to create and publish apps. After app creation and publishing, those customer apps are listed in Cisco Spaces - Partner Dashboard. Cisco Spaces the administrator must approve the new applications and once the app is approved it is listed under Partner Apps tab in Cisco Spaces - Homepage.

You must activate the app from Partner Apps so that your customers can use them. These apps can be activated for selected locations as per the customer requirement. App includes multiple events and partner enable the events for these apps and activate them.

Events are triggered through Firehouse APIs. These APIs checks for the device status and then events are triggered accordingly. For more information, refer to Firehose API.

When a Cisco Spaces partner adds a new event to an already activated app, it will be sent through Firehose APIs only when the customer subscribes to the new event by accepting the permissions. Prior to this enhancement, customer permission was not required for new events.

You are prompted with the following notification message New Permission Required on the app tile and you must click and accept the new app permission to subscribe to these new app events. An email notification is also sent to the customer indicating that a new event is added to the app.

Procedure

Step 1

In the Cisco Spaces - Homepage, click the Partner Apps tab.

The Partner Apps window displays the published apps. The app title displays the name of the application, a brief description and whether the app is hosted on Cloud or On-prem.

Figure 2. App Center

Step 2

(Optional) Use the options in the Filter By section, to filter the applications.

Step 3

Click on the app that you want to activate.

Step 4

Click Activate.

The corresponding app activation window is displayed. Each application will have different activation instructions as per the customer authentication configuration.

Step 5

Complete the Sign Up & Onboarding configurations.

Step 6

Click Continue.

Step 7

In the Permissions section, read location data requirements.

Step 8

Click Accept Permission.

Step 9

Choose the locations you would like to activate the app for. You can select Enable for all locations checkbox to select all location.

Step 10

Click Next.

The specific customer website displays and you must complete the required customer authentication to proceed.

Step 11

Follow the on-screen instructions and complete the app activation steps.