Rboot 文档--企业微信消息转接器

简介

企业微信基于SDK wxwork 实现。
因为市面上真找不到代码比较清晰的SDK，所以就自己写了一个，精力有限，只实现了部分功能，以后可能会继续开发，已经实现的功能见上面的链接，文档见godoc

请确保你已经了解企业微信相关操作！企业微信帮助中心 https://work.weixin.qq.com/help
确保你的web服务可以被外网访问！

开启API接收消息

企业微信转接器提供了消息接收的api，URI为：wework。

比如你的部署地址为 https://baidu.com:7856，对应消息接收地址为 https://baidu.com:7856/wework

配置好 Token 和 EncodingAESKey。

此api提供了url验证功能，将下面的配置填写完整，运行机器人服务才可进行验证。

配置企业微信机器人

将企业ID，自建应用的AgentId和Secret，消息服务器的Token 和 EncodingAESKey 填入对应配置中：

# 聊天转接器
ROBOT_ADAPTER=wework
# 企业微信 企业ID
WORKWX_CORP_ID=xxxxxxxxx
# 企业微信自建应用agentid
WORKWX_AGENT_ID=xxxxxxxxxxxx
# 企业微信自建应用secret
WORKWX_SECRET=xxxxxxxx
# 企业微信自建应用API接收消息token
WORKWX_RECV_TOKEN=xxxxxxxxxx
# 企业微信自建应用API接收消息EncodingAESKey
WORKWX_RECV_AES_KEY=xxxxxxxxxx

传入消息（Incoming）

当企业微信将消息或事件推送给转接器时，转接器会做以下操作：

记录发送者
记录应用ID AgentId
记录原始数据 Data，原始数据为SDK的wxwork.RecvMessage类型，使用gob进行序列化，脚本可以反序列化后获取原始记录，并做相关处理。

其中发送者记录在消息体中，其他记录在消息体的Header中，最后转接器将消息存入 incoming 通道中，等待机器人获取消息。

传出消息（Outgoing）

消息通过脚本解析执行后会将处理结果发送给用户，脚本可以发送转接器支持的消息类型到客户端。

企业微信支持七种消息类型：

text 文本消息
markdown markdown消息
image 图片消息
voice 语音消息
video 视频消息
file 文件消息
textcard 文本卡片消息

消息类型请查看企业微信开发文档发送应用消息
需要在 Header中设置消息类型 msgtype
在不指定时默认为 markdown 类型消息

同步联系人信息

该转接器同样也提供了同步联系人功能，需要 通讯录同步 权限。获取此权限需要设置 WORKWX_CONTACT_SECRET 的值为 通讯录同步 的 Secret