Apprise

The Apprise service is an all-in-one solution to open up Home Assistant to just about every Notification platform (such as Amazon SNS, Discord, Telegram, Slack, MSTeams, Twilio, etc.)

Configuration

To use Apprise supported notifications, add the following to your configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] file. 在更改了configuration.yamlconfiguration.yaml 文件是 Home Assistant 的主要配置文件。它列出了要加载的集成及其特定配置。在某些情况下,需要直接在 configuration.yaml 文件中手动编辑配置。大多数集成可以在 UI 中配置。 [Learn more] 文件后,重启 Home Assistant 以应用更改。 该集成现在显示在集成页面的 设置 > 设备与服务 下。其实体在集成卡片上以及实体标签上列出。

# Example configuration.yaml entry using URLs
notify:
  - name: NOTIFIER_NAME
    platform: apprise
    url: YOUR_APPRISE_URLS

You can also predefine your own configuration files while storing them either remotely or locally. Simply just use the config option.

# Example configuration.yaml entry using externally located Apprise
# Configuration Files/Sites:
notify:
  - name: NOTIFIER_NAME
    platform: apprise
    config: YOUR_APPRISE_CONFIG_URLS

There is no restriction on the number of URLs or Apprise Configuration locations you wish to define. You can also use both of the lines in conjunction with one another:

# Example configuration.yaml entry using all options
notify:
  - name: NOTIFIER_NAME
    platform: apprise
    config: YOUR_APPRISE_CONFIG_URLS
    url: YOUR_APPRISE_URLS

Configuration Variables

name string (Optional, default: notify)

The notifier will bind to the action notify.NAME.

url string (Optional)

One or more Apprise URLs

config string (Optional)

One or more Apprise Configuration URLs

Example action

- action: notify.NOTIFIER_NAME
  data:
    message: "A message from Home Assistant"

If you’re using configuration files to store your Apprise URLs in, then you have the added bonus of associating tags with them. By default, Apprise in Home Assistant will only notify the elements that have no tags associated with them. You can optionally focus on only notifying a specific service based on the tag(s) you assigned them like so:

- action: notify.NOTIFIER_NAME
  data:
    message: "A message from Home Assistant"
    target: [
      "tag_name1",
    ]

The tag all is reserved to notify absolutely everything, whether you have a tag associated with a URL or not.

Notes

There are over 50 supported Notification services supported by Apprise. Each has their own tweaks and customizations you can leverage.

  • For instructions on how to construct the URLs, visit here.
  • For instructions on how you can customize your own Apprise configuration files (referenced through the config directive), check out the following: