home-assistant.io/source/_components/notify.hangouts.markdown

layout	title	description	date	sidebar	comments	sharing	footer	logo	ha_category	ha_release
page	Google Hangouts	Instructions on how to add Google Hangouts notifications to Home Assistant.	2018-08-18 20:00	true	false	true	true	hangouts.png	Notifications	0.77

The hangouts platform allows you to deliver notifications from Home Assistant to Google Hangouts conversations. Conversations can be both direct as well as group chats.

{% linkable_title Configuration %}

To enable Hangouts notifications in your installation, you first need to configure the Hangouts component. Then, add the following to your configuration.yaml file:

# Example configuration.yaml entry  
notify:
  - name: NOTIFIER_NAME
    platform: hangouts
    default_conversations:
      - id: CONVERSATION_ID1
      - id: CONVERSATION_ID2

{% configuration %} name: description: "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." required: false type: string default_conversations: description: "The conversations all messages will be sent to, when no other target is given." required: true type: [map] keys: id: description: "Specifies the id of the conversation. The conversation id can be obtained from the hangouts.conversations entity." required: true type: string {% endconfiguration %}

{% linkable_title Finding the conversation ID %}

The conversations has to be precreated, the conversation id can be obtained from the hangouts.conversations entity, this can be found in with the states developer tool that is shown as this icon in the side bar. Using your web browsers search tool to find the hangouts.conversations entity. You will find something like below.

0: {
  "id": "<Hangout ID>",
  "name": "A simple hangout",
  "users": [
    "Steve",
    "Jo"
  ]
}

This may have more if the account is in multiple hangout conversations, for configuring the bot to be in a conversation you will need the ID that would be where <Hangout ID> is in that example. Make sure to use quotes around the conversation id or alias to escape special characters (!, and #) in YAML.

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