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 on 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.

{% linkable_title Configuration %}

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.yaml entry
sensor:
  - platform: gitter
    api_key: YOUR_API_TOKEN

{% configuration %} api_key: description: Your Gitter.im API token. required: true type: string room: description: Gitter room to monitor. required: false type: string default: home-assistant/home-assistant {% endconfiguration %}