核心功能
- 支持直接发送文本、使用模板生成文本或 Markdown、发送文件,以及发送原始 JSON 请求。
- 多个端口可以共用同一个企业微信连接,并分别配置接收人和发送模式。
- 自动获取和缓存访问令牌;令牌失效时刷新并重试一次。
创建自建应用并获取凭据
开始前,需要有企业微信企业账号,并具备管理后台的应用管理权限。已有自建应用时,可直接使用其凭据。- 使用管理员账号登录企业微信管理后台。
- 进入应用管理 → 自建 → 创建应用,填写应用名称、Logo 和说明,并设置可见范围。
- 打开创建好的应用详情页,复制 AgentId,填入端口连接的应用 ID。
- 在同一应用详情页找到 Secret,单击查看,按提示在企业微信客户端完成管理员确认并获取密钥,填入连接的应用密钥。
- 进入我的企业 → 企业信息,复制企业 ID,填入连接的企业 ID。
端口配置
连接
在设置选项卡中选择或创建企业微信连接。以下凭据保存在连接中。
单击测试连接可检查凭据是否能够获取访问令牌。测试不会发送消息,也不验证接收人是否能收到消息。
设置选项卡
高级选项卡
使用方式
发送文本
- 选择企业微信连接并测试连接。
- 将接收人类型设为
User,填写成员 ID,例如user001。 - 将发送模式设为
Text,将 UTF-8 文本消息传入端口。 - 启用自动化中的发送,自动处理到达端口的消息。
2048 字节。
使用模板
将发送模式设为Template,选择消息格式并填写模板。例如,选择 Markdown 后可使用:
2048 字节,Markdown 最多为 4096 字节。
发送文件
将发送模式设为File,输入消息必须带有文件名。端口先上传文件,再使用返回的媒体 ID 发送文件消息;文件大小必须在 5 字节至 20 MiB 之间。
如需附带说明,启用发送附带消息并填写模板。文件和说明分别发送;如果文件已发送而说明失败,重试该输入消息会再次发送文件。
发送原始 JSON
将发送模式设为原始 JSON,输入消息应为企业微信消息请求的 JSON 对象,例如:msgtype,以及 touser、toparty、totag 中至少一个接收人字段。此模式按原始 JSON 发送,忽略端口的接收人、头覆盖和消息格式设置。
端口会自动补充所选连接的 agentid 并提供身份验证。输入不得包含 access_token;如果填写了 agentid,必须与连接中的值一致。其他消息字段应符合企业微信对应消息类型的要求。