跳到主要内容

企业微信机器人

企业微信机器人是企业微信提供的一种快速接入方式,可以通过 Webhook URL 接收消息。

配置

{
"channels": {
"wecom": {
"enabled": true,
"token": "YOUR_TOKEN",
"encoding_aes_key": "YOUR_ENCODING_AES_KEY",
"webhook_url": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY",
"webhook_host": "0.0.0.0",
"webhook_port": 18793,
"webhook_path": "/webhook/wecom",
"allow_from": [],
"reply_timeout": 5
}
}
}
字段类型必填描述
tokenstring签名验证代币
encoding_aes_keystring用于解密的 43 字符 AES 密钥
webhook_urlstring用于发送回复的企业微信群聊机器人 Webhook URL
webhook_hoststringHTTP 服务器绑定地址(默认:0.0.0.0)
webhook_portintHTTP 服务器端口(默认:18793)
webhook_pathstringWebhook 端点路径(默认:/webhook/wecom)
allow_fromarray用户 ID 白名单(空值 = 允许所有用户)
reply_timeoutint回复超时时间(单位:秒,默认值:5)

设置流程

  1. 在企业微信群中添加机器人
  2. 获取 Webhook URL
  3. (如需接收消息) 在机器人配置页面设置接收消息的 API 地址(回调地址)以及 Token 和 EncodingAESKey
  4. 将相关信息填入配置文件