## 简介
倍洽类似于墙外的 `slack`,它提供了`Incoming` 和 `Outgoing` 两种自定义机器人,倍洽消息转接器通过这两中机器人实现。
`Outgoing`机器人负责将消息发送给我们的机器人,`Incoming` 机器人负责接收我们的机器人发送的消息。
> 确保你的web服务可以被外网访问!
## 配置倍洽机器人
在设置里的机器人管理选项配置 `Incoming` 和 `Outgoing` 机器人,获取 `Incoming` 的 `Webhook` 地址和 `Outgoing` 的 `token`,并配置`触发词`和`Post地址`。
配置示例:
```env
# 聊天转接器
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` 类型。