home-assistant.io/source/_components/notify.ciscospark.markdown
andreasfelder 36be41509d Update notify.ciscospark.markdown (#4385)
Creating a bot for the messages will mark messages as new and unread in the room which will create a notification. If the personal token is used no new message notification is triggered.
2018-01-10 10:50:43 +01:00

1.9 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
layout title description date sidebar comments sharing footer logo ha_category ha_release
page Cisco Spark Instructions how to add CiscoSpark notifications to Home Assistant. 2017-02-20 15:00 true false true true ciscospark.png Notifications 0.40

The ciscospark notification platform allows you to deliver notifications from Home Assistant to Cisco Spark.

To use this notification platform you need to get a developer token. To obtain a token visit Spark for Developers

At this time you also need to specify the Cisco Spark roomid. The roomid can also be found at Spark for Developers. Just look in the Documentation under Rooms.

In order to get notified for all new messages in the room you will need to create a bot. This will post the messages from the bot and mark them as new for you which will alert you. If you use your own personal token the messages are added to the room but no notification is triggered. Once you have created the bot through the new App menu you will need to add the bot to the room that you are a member of as well. Now use the bot access token in your configuration below.

To enable the Cisco Spark notification in your installation, add the following to your configuration.yaml file:

# Example configuration.yaml entry
notify:
  - name: NOTIFIER_NAME
    platform: ciscospark
    token: YOUR_DEVELOPER_TOKEN
    roomid: CISCO_SPARK_ROOMID

Configuration variables:

  • name (Optional): Setting the optional parameter name allows multiple notifiers to be created. The default value is notify. The notifier will bind to the service notify.NOTIFIER_NAME.
  • token (Required): Your development token.
  • roomid (Required): The Room ID.

To use notifications, please see the getting started with automation page.