home-assistant.io/source/_components/notify.hangouts.markdown
Marcel Hoppe 05fdd225d7 Add documentation for hangouts and notify.hangouts components (#6044)
* Add documentation for hangouts and notify.hangouts components

* use {% configuration %}

* name is not required

* Update hangouts.markdown

remove email and password from config
add integrations description

* Update hangouts.markdown

Add notice for 2fa

* Typo

* More fixes

* Update notify.hangouts.markdown

* Update notify.hangouts.markdown

add hint to hangouts.conversations

* cleaner doc removing name option from conversations entries
2018-08-27 22:45:39 +02:00

1.8 KiB

layout, title, description, date, sidebar, comments, sharing, footer, logo, ha_category, ha_release
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 %}

The conversations has to be precreated, the conversation id can be obtained from the hangouts.conversations entity. 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.