Home Assistant

Synology Chat

The synology_chat notification platform 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.yaml file:

# 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"
     }
 }