Skip to content

Cisco Spark Action

Tom Deckers edited this page Feb 15, 2017 · 2 revisions

Documentation of the Cisco Spark Action


Cisco Spark is a simple and secure way for collaborating with individuals and groups across the cloud. This Action plugin allows you to send messages to rooms and individuals when certain events take place in openHAB. Messages in the Cisco Spark action plugin support Markdown text.


Configuration is very easy and only required an access token. To obtain this token, first log in to Spark for Developers and add a new App. Make sure to select 'Create a Bot' and fill in the required fields. Once completed, you will be presented with an access token.

Next, configure openHAB with the access token by adding following line to the file services/ciscospark.cfg:

accessToken= << access token from Spark for Developers >>

There's an optional convenience configuration option that allows you to set a default room to which you want Spark to send messages so you don't have to include it in each action request.

defaultRoomId= << UUID of the default room >>

Note: you can find the uuids for rooms when using the web client for Cisco Spark. When you navigate to a room, the uuid can be copied from the browsers location bar. The uuid looks like this: 24c617f0-fbe4-11e5-be0f-2fe93bbeddd9


Send a message to a specific room

sparkMessage('message', 'roomId') 

Send a message to the default room (from config)


Send a direct message to a person

sparkPerson('message', 'personEmail')

feature overview


Setup intro

Linux and OS X





User Interfaces



(link to openHAB forum)



Application Integration



A good source of inspiration and tips from users gathered over the years. Be aware that things may have changed since they were written and some examples might not work correctly.

Please update the wiki if you do come across any out of date information.

Binding configurations

Use case examples

Item definition examples

Sitemap definition examples

Collections of Rules on a single page

Single Rules


Syntax highlighting for external editors

Release Notes

Clone this wiki locally
You can’t perform that action at this time.