zulip/zerver/webhooks/homeassistant/doc.md

1. {!create-stream.md!}

2. {!create-an-incoming-webhook.md!}

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