Home Assistant

Synology Chat

The synology_chat notification integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] allows you to deliver notifications to your Synology Chat install as a Synology Chat bot.

To configure a Synology Chat bot, first you must create a Synology Chat Integration Incoming Webhook. After this is complete, you will have a Webhook URL. This is what will be required in the Home Assistant configuration.

To enable the Synology Chat notification in your installation, add the following to your configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI.[Learn more] file. After changing the configuration.yamlThe configuration.yaml file is the main configuration file for Home Assistant. It lists the integrations to be loaded and their specific configurations. In some cases, the configuration needs to be edited manually directly in the configuration.yaml file. Most integrations can be configured in the UI.[Learn more] file, restart Home Assistant to apply the changes. To view the changes, go to Settings > Devices & services > Entities.

# Example configuration.yaml entry
notify:
  - platform: synology_chat
    name: hass_synchat
    resource: https://example.your.synology.com/webapi/entry.cgi?api=SYNO.Chat.External&method=incoming&version=1&token=ABCDEFG

Configuration Variables

Looking for your configuration file?
name string Required

Setting the parameter name allows multiple notifiers to be created. The notifier will bind to the service notify.NOTIFIER_NAME.

verify_ssl boolean (Optional, default: true)

If SSL/TLS verification for HTTPS resources needs to be turned off (for self-signed certs, etc.).

resource string Required

The incoming webhook URL.

To use notifications, please see the getting started with automation page.

A full example of a service call:

{"message": "This is a test message", 
 "data":{
     "file_url":"https://example.com/wp-content/uploads/sites/14/2011/01/cat.jpg"
     }
 }

Related topics