概述

Synology Chat 是专为企业用户设计的即时消息服务，可将他们的所有消息历史记录保密。在使用 Chat 时，可配置传入的和发出的 webhook 以促进与多个服务的整合和通信，如聊天机器人或 RSS 源。本文将引导您完成配置 webhook 和斜杠命令所需的过程。

目录

1. 开始之前的准备
2. Webhook 整合
• 2.1 传入的 webhook
• 2.2 发出的 webhook
3. 斜杠命令
• 3.1. 配置和执行

1.开始之前的准备

在 Synology Chat 中设置 webhook 之前，确保您完成了以下操作：

• 已经完成 Synology NAS 设置
• 安装了 DiskStation Manager (DSM)
• 从套件中心安装了 Synology Chat。

2.Webhook 整合

有两种 webhook 可用于与外部资源的整合和通信。要开始在 Chat 在使用 webhook 整合，请进入用户配置文件 > 整合。

2.1 传入的 webhook

webhook 包含有 JSON 格式的有效载荷。

若要创建如上所示的信息，请构建如下所示的 JSON 有效载荷：

{"text": "This is a test"}

将此 JSON 字符串放置在 payload 参数之后，使用 application/x-www-form-urlencoded 向 webhook URL 发送数据。例如：

POST https://DS_IP/webapi/entry.cgi?api=SYNO.Chat.External&XXXXX Content-Type: application/x-www-form-urlencoded payload=%7B%22text%22%3A%22This%20is%20a%20test.%22%7D

此外还提供了一个 CURL 示例：

curl -X POST \ --data-urlencode 'payload={"text": "This is a test"}' \ https://DS_IP/webapi/entry.cgi?api=SYNO.Chat.External&XXXXX

若要添加链接：

若要添加链接，您可直接将链接插入到 text。例如：

payload={"text": "https://www.synology.com"}

或者

payload={"text": "Check this!!  for details!"}

若要上传文件：

文件可通过传入的 webhook 的上传到 Chat。若要上传文件，您的 JSON 有效载荷必须含有 file_url，而且还要有可选文本属性。例如：

payload={"text": "a fun image", "file_url": "http://imgur.com/xxxxx"}

文件将从 file_url 下载，然后上传到 Chat。

2.2 发出的 webhook

发出的 webbook 允许您接收来自 Chat 的信息。简而言之，当信息与定义的触发词和条件匹配时，发出的 webhook 会向您分配的 URL 发送 HTTP POST 请求。

触发词和条件：

当信息与以下一个或两个条件匹配时可以触发发出的 webhook：

• 信息在指定的频道中。
• 信息以其中一个定义的触发词开头。

指定了频道时触发词可选，没有指定频道时触发词必填。如果指定了上述两个条件，则只有信息与两个条件匹配时才会发送发出的 webhook。

发出数据：

当收到的信息与触发条件匹配时，将向所有指定的 URL 发送 POST。数据字段描述如下：

token: bot token channel_id channel_name user_id username post_id: message ID timestamp: message time text: message content trigger_word: trigger words

若要将响应发回 Chat，JSON 必须作为响应正文返回（支持的字段与传入的 webhook JSON 相同）。例如：

{"text": "This is a test"}

3.斜杠命令

与外部资源或应用程序的另一种交互方式是通过斜杠命令。只需在 webhook 整合部分配置发出的 webhook URL，与上述触发条件匹配的信息将通过 HTTP POST 发送到分配的 URL。斜杠命令可在任意频道中执行，只有命令发出者可以看到。

3.1 配置和执行

进入用户配置文件 > 整合 > 斜杠命令以注册斜杠命令整合。若要构建斜杠命令，只需在文本字段中键入正斜杠 “/”，然后输入您的命令。示例如以下屏幕截图中所示：

在执行斜杠命令时，HTTP POST 请求连同下面所列的一些属性一起发送到指定的 URL（过程与发出的 webhook 的过程类似）：

token: bot token user_id username text: message content

外部资源或应用程序可决定是否响应从 Chat 发送的斜杠命令。要响应命令请求，响应中应包含如下的有效的 JSON 有效载荷：

{"text": "Slash command response."}

如下所示的响应信息将只发送给发出了该命令的用户，也只有该用户能看见。

  ---------------------------------------------------------------------------------------------------

 IT解决方案：

   文件共享、私有云盘、企业网盘  解决方案

   存储雷电DAS 、SAN、IPSAN ISCSI 解决方案

    企业级存储解决方案

   备份 容灾解决方案

   防勒索病毒解决方案

  NAS 应用场景：完美解决文件共享/文件分享问题，替代传统文件服务器

                              NAS网络存储 文件NAS存储 。

 群晖备份一体机 适用于的企级备份软件有：

（acronis 安克诺斯 /veeam安盟/veritas华睿泰/commvault 慷孚沃德 /arcserver )

  PHD virtual , Nakivo, IBM spectrum protect , (TSM) HP data protector

  DELL  EMC Networker  RecoverPoint Quest  veritas system recovery 18

 国内备份软件：鼎甲，火星仓，UPM，浪擎，爱数

黑群晖无法升级，易丢失数据，建议用白群晖，黑群晖洗白

synology partner：深圳国亿国际（凯洛蜜） 上海世平伟业

服务区域：四川群晖 成都群晖 西藏群晖  重庆群晖贵州群晖 贵阳群晖 云南群晖  昆明群晖 

 群晖配件：群晖钥匙  群晖网卡  群晖内存 群晖电源 群晖主板

群晖维修：群晖保修保内保外维修 群晖硬盘数据恢复 群晖客服 群晖保修 群晖维修）

群晖数据恢复：  服务器数据恢复 raid数据恢复  nas数据恢复   希捷数据恢复  西数硬盘恢复  seagate 数据恢复  WD数据恢复 

 国行原装正品（国代，总代理，总分销商）方案适用机型：

19-系列

DS1219+ 

18-系列: FS1018、RS3618xs、DS3018xs、RS2818RP+、RS2418(RP)+、RS818(RP)+、DS918+、DS718+、DS418、DS418play、DS218+、、DS218play、DS418j、DS218、DS218j、DS118；

17-系列: FS3017、FS2017、RS18017xs+、RS4017xs+、RS3617xs+、RS3617RPxs、RS3617xs、DS1817+、DS1517+、DS1817、DS1517、RS217；

16-系列: RS18016xs+、RS2416(RP)+、DS916+、DS716+II、DS716+、RS816、DS416、DS416play、DS216+II、DS216+、DS216play、DS416slim、DS416j、DS216、DS216j、DS216se、DS116、NVR216；

15-系列: RC18015xs+、DS3615xs、DS2015xs、RS815(RP)+、DS2415+、DS1515+、DS415+、RS815、DS1515、DS715、DS415play、DS215+、DS215j、DS115、DS115j、DS1815+；

14-系列: RS3614xs+、RS2414(RP)+、RS814(RP)+、RS814、DS414、DS214+、DS214play、RS214、DS414j、DS414slim、DS214、DS214se、DS114、EDS14；

13-系列: RS10613xs+、RS3413xs+、DS2413+、DS1813+、DS1513+、DS713+、DS413、DS213+、DS413j、DS413j、DS213、DS213j、DS213air；

12-系列: DS212j；

早期系列：ds-101 

科汇科技 --- 专业数据备份服务商

无论您的IT架构是 本地化、云端、还是混和云 都能提供一站式数据备份方案。

京东群晖synology  天猫群晖 线下代理售后维修服务站

四川成都群晖官方授权核心代理商（企业级服务商）

四川成都群晖synology解决方案中心

四川成都群晖synology体验中心

四川成都群晖synology售后维修中心

四川成都群晖synology官方授权专卖店

成都科汇科技有限公司

地址：成都市人民南路四段1号时代数码大厦18F

群晖电话：400-028-1235（群晖400）

QQ:     2231749852

手机：138 8074 7621（微信同号）

微信公众号：群晖Synology技术中心