Google Hangouts

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.


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  
    platform: hangouts
      - id: CONVERSATION_ID1
      - id: CONVERSATION_ID2

Configuration Variables


(string)(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.


(map)(Required)The conversations all messages will be sent to, when no other target is given.


(string)(Required)Specifies the id of the conversation. The conversation id can be obtained from the hangouts.conversations entity.

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": [

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.