home-assistant.io/source/_components/sensor.gitter.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Gitter Sensor	Instructions how to integrate a Gitter room sensor with Home Assistant	2017-06-11 09:00	true	false	true	true	gitter.png	Sensor	0.47

This gitter sensor allows one to monitor a Gitter.im chatroom for unread messages.

Visit Gitter Developer Apps to retrieve your "Personal Access Token".

To use a Gitter sensor in your installation, add the following to your configuration.yaml file:

# Example configuration.yml entry
sensor:
  - platform: gitter
    api_key: YOUR_API_TOKEN

Configuration variables:

• api_key (Required): Your Gitter.im API token.
• room (Optional): Gitter room to monitor. Defaults to home-assistant/home-assistant