美文网首页
Rboot 文档--企业微信消息转接器

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

作者: chca | 来源:发表于2020-01-19 21:17 被阅读0次

简介

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

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

开启API接收消息

企业微信转接器提供了消息接收的api,URI为:wework

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

配置好 TokenEncodingAESKey

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

配置企业微信机器人

企业ID,自建应用的AgentIdSecret,消息服务器的TokenEncodingAESKey 填入对应配置中:

# 聊天转接器
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

相关文章

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

    简介 企业微信基于SDK wxwork 实现。因为市面上真找不到代码比较清晰的SDK,所以就自己写了一个,精力有限...

  • Rboot 文档--微信消息转接器

    简介 微信消息转接器是基于微信网页版的API实现的消息转接器,它是基于wechat包开发的。 使用微信消息转接器需...

  • Rboot 文档--消息转接器Adapter

    简介 rboot 内置了五个开箱即用的转接器 命令行(cli) 微信网页版(wechat) 企业微信(wework...

  • Rboot 文档--钉钉消息转接器

    简介 钉钉提供了自定义的webhook机器人和企业机器人,钉钉消息转接器就是通过这两个功能实现的。 请确保你已经了...

  • Rboot 文档--倍洽消息转接器

    简介 倍洽类似于墙外的 slack,它提供了Incoming 和 Outgoing 两种自定义机器人,倍洽消息转接...

  • Rboot 文档--消息Message

    Rboot 消息 rboot 的消息类似于邮件消息,它包含了接收者 消息来源 发送者 消息头信息 消息主体。 消息...

  • 企业微信微文档使用记录

    企业微信微文档使用记录 微文档简介 微文档是企业微信推出的在线文档和表格。你可以用微文档来完成个人创作,或与同事共...

  • Rboot 文档--简介

    Rboot 助手机器人 介绍 Rboot是一个使用golang编写的,简单、高效的聊天机器人框架,易于扩展,它可以...

  • Rboot 文档--安装

    开始创建你自己的机器人 你需要安装 golang 1.3+ 或者更新的版本 源码安装 推荐使用 go module...

  • Rboot 文档--配置

    配置 rboot 的配置使用的是ENV环境变量,在机器人启动时,会自动加载项目目录下的.env文件,当然你也可以设...

网友评论

      本文标题:Rboot 文档--企业微信消息转接器

      本文链接:https://www.haomeiwen.com/subject/xaldzctx.html