Rboot 文档--倍洽消息转接器
2020-01-19 本文已影响0人
chca
简介
倍洽类似于墙外的 slack，它提供了Incoming 和 Outgoing 两种自定义机器人，倍洽消息转接器通过这两中机器人实现。
Outgoing机器人负责将消息发送给我们的机器人，Incoming 机器人负责接收我们的机器人发送的消息。
确保你的web服务可以被外网访问！
配置倍洽机器人
在设置里的机器人管理选项配置 Incoming 和 Outgoing 机器人，获取 Incoming 的 Webhook 地址和 Outgoing 的 token，并配置触发词和Post地址。
配置示例：
# 聊天转接器
ROBOT_ADAPTER=bearychat
# Outgoing token
BEARYCHAT_TOKEN=token
# 触发词
BEARYCHAT_TRIGGER_WORD=@rboot
# Incoming webhook
BEARYCHAT_WEBHOOK=webhook
传入消息（Incoming）
监听消息时需要设置Outgoing 机器人的Post地址，转接器提供了相应的API，URI为 beary
比如你的部署地址为 https://baidu.com:7856，对应消息接收地址为 https://baidu.com:7856/beary
当消息被推送到转接器时，转接器做了以下操作：
- 验证token，检查消息是否合法
- 将消息中的触发词删除，真实消息内容
传出消息（Outgoing）
消息通过脚本解析执行后会将处理结果发送给用户，脚本可以发送转接器支持的消息类型到客户端。
倍洽只支持文本和markdown类型的消息，默认为 markdown
消息支持 notification字段，关于它的作用文档只有一行解释，搞不明白啥意思：
-
notification. 可选字段。用于控制消息提醒的内容显示。
支持 attachments 字段，需要在Header中设置 attachments 的值，类型为转接器中的 []Attachment 类型。
