松弛


松弛平台允许您从家庭助理传达通知必威是什么松弛

设置

机器人作为您的发布

  1. 创建一个新应用在您的Slack.com帐户下。
  2. 点击Oauth&许可在侧边栏中的链接,在特征标题下。
  3. 在“范围”部分中,添加聊天:写范围,作为用户发送消息。如果你得到丢失_scope尝试发送消息时,错误,请检查这些权限。
  4. 滚动到Oauth令牌和重定向URL然后单击添加到工作区
  5. 复制您的Oauth访问令牌并将该钥匙放入您的configuration.yaml文件 - 请参见下文。

应用程序的基本设置上有一个应用程序验证令牌。这是不是您想要的API键。

机器人以自己的用户的身份发布

也可以使用Slack Bot作为用户。只需在https:// [your_team] .slack.com/apps/build/custom-Integration上创建一个新的机器人,然后使用提供的令牌。您可以从前端添加家庭助理的图标,并给机器人一个有意义的名称。必威是什么

不要忘记将机器人邀请到您想要获取通知的房间。

配置

要启用安装中的松弛通知,请将以下内容添加到您的configuration.yaml文件:

#示例Configuration.yaml条目通知-姓名notifier_name平台松弛api_keyyour_api_keyDEFAULT_CHANNEL#一般的”

配置变量

姓名 细绳 ((可选的,默认:通知

设置此参数允许创建多个通知器。通知者将绑定到服务notify.notifier_name

api_key 细绳 必需的

Slack API令牌用于发送松弛消息。

DEFAULT_CHANNEL 细绳 必需的

在发送通知消息时,如果未明确指定频道,则发布的默认频道。可以指定通道,并在与“消息”相同的级别上添加目标属性。

用户名 细绳 ((可选的

必威是什么家庭助理将使用指定的用户名发布。

默认:

您生成API键的用户帐户或botname。

图标 细绳 ((可选的

使用一个松弛的表情符号作为提供的用户名的图标。Slack使用标准的表情符号集这里。另外,可以使用公共访问的URL。

请注意,为了修改Slack Bot的用户名和图标,您必须确保Slack应用具有聊天:write.customizeOauth范围。看Slack API文档了解更多信息。

松弛服务数据

以下属性可以放置在数据服务键要求扩展功能:

属性 可选的 描述
用户名 是的 Slack Bot的用户名。
图标 是的 松弛机器人的图标。
文件 是的 包含消息的文件;见下文。
是的 数组松弛块笔记:如果使用,他们显示代替信息(请注意信息仍然需要)。
blocks_template 是的 ,但能够支持模板

请注意使用文件会忽略所有用法blocks_template(因为Slack不支持上传文件随附的消息中的这些框架)。

要包含带有松弛消息的本地文件,请在下面使用这些属性文件钥匙:

属性 可选的 描述
小路 一个本地的filepath白名单

要包含带有Slack消息的远程文件,请在其下方使用这些属性文件钥匙:

属性 可选的 描述
URL 一个已经过去的URL白名单
用户名 是的 如果URL受HTTP Basic Auth的保护,则可选用户名。
密码 是的 如果URL受HTTP Basic Auth的保护,则可选密码。

例子

从本地路径发送文件:

信息将添加为文件的消息。标题文件的标题。数据文件小路/path/to/file.ext

从远程路径发送文件:

信息将添加为文件的消息。标题文件的标题。数据文件URLhttp://site.com/image.jpg“

从远程路径发送文件,该文件受HTTP Basic Auth的保护:

信息将添加为文件的消息。标题文件的标题。数据文件URLhttp://site.com/image.jpg“用户名用户密码经过

使用块框架:

信息后备消息以防块不显示任何内容。标题文件的标题。数据-类型部分文本类型mrkdwn文本'丹尼托伦斯剩下下列的审查为了您的财产:'-类型部分block_id第567节文本类型mrkdwn文本酒店>\ n:星星:\ n许多斧头孔,来宾房间237曾是远的罗迪,所有的地方毛毡卡住1920年代。”配饰类型图片Image_urlhttps://is5-ssl.mzstatic.com/image/thumb/purple3/v4/d3/d3/72/5c/d3725c/d3725c8f-c642-5d69-1904-aa36e429788855/source/source/source/256x256bb.jpgalt_text鬼酒店的形象-类型部分block_id第789节字段-类型mrkdwn文本|  -*平均评分*1.0

通过将目标设置为其成员ID,直接向用户发送消息。这是指示获取会员ID。

信息你好那里!”目标U12345”标题你好”数据[]

将消息发送到提到的频道(@username,以黄色以黄色的名字突出显示用户名)。这是指示获取会员ID。

信息<@u12345>您的预约开始很快”目标#一般的”标题提醒”数据[]