zulip/zerver/webhooks/homeassistant/doc.md

1. {!create-stream.md!}

2. Next, on your {{ settings_html|safe }}, create a bot and note its email and API key.

3. In Home Assistant, you need to add the notify service to your configuration.yaml file. This should look something like this:

   

4. The api_key parameter should correspond to your bot's key. The stream parameter is not necessarily required; if not given, it will default to the homeassistant stream.

5. And the URL under resource should start with:

   {{ api_url }}/v1/external/homeassistant

6. Finally, you need to configure a trigger for the service by adding an automation entry in the HomeAssistant configuration.yaml file.

   

   The data object takes at least a message property and an optional title parameter which will be the conversation topic and which defaults to homeassistant if not given.

{!congrats.md!}