home-assistant.io/source/_integrations/gitter.markdown

title, description, ha_category, ha_release, ha_codeowners, ha_domain

title	description	ha_category	ha_release	ha_codeowners	ha_domain
Gitter	Instructions on how to integrate a Gitter room sensor with Home Assistant	Sensor	0.47	@fabaff	gitter

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

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 %}