Skip to main content
WeCom 端口通过企业微信自建应用向成员、部门或标签发送消息,可用于业务通知和文件交付。

核心功能

  • 支持直接发送文本、使用模板生成文本或 Markdown、发送文件,以及发送原始 JSON 请求。
  • 多个端口可以共用同一个企业微信连接,并分别配置接收人和发送模式。
  • 自动获取和缓存访问令牌;令牌失效时刷新并重试一次。

创建自建应用并获取凭据

开始前,需要有企业微信企业账号,并具备管理后台的应用管理权限。已有自建应用时,可直接使用其凭据。
  1. 使用管理员账号登录企业微信管理后台
  2. 进入应用管理 → 自建 → 创建应用,填写应用名称、Logo 和说明,并设置可见范围。
  3. 打开创建好的应用详情页,复制 AgentId,填入端口连接的应用 ID
  4. 在同一应用详情页找到 Secret,单击查看,按提示在企业微信客户端完成管理员确认并获取密钥,填入连接的应用密钥
  5. 进入我的企业 → 企业信息,复制企业 ID,填入连接的企业 ID
以上操作可参考腾讯官方指南中的应用创建和凭据查询步骤。企业 ID、应用 ID 和应用密钥应来自同一企业及所选自建应用。 在应用详情页的开发者接口 → 企业可信 IP中,按后台要求配置运行端口的服务器访问公网时使用的出口 IP;通过代理访问时填写代理的出口 IP。相关后台操作可参阅腾讯官方配置指南 自建应用的可见范围应包含消息接收成员。消息发送权限和参数要求可参阅企业微信官方发送应用消息文档。

端口配置

连接

设置选项卡中选择或创建企业微信连接。以下凭据保存在连接中。 单击测试连接可检查凭据是否能够获取访问令牌。测试不会发送消息,也不验证接收人是否能收到消息。

设置选项卡

高级选项卡

使用方式

发送文本

  1. 选择企业微信连接并测试连接。
  2. 将接收人类型设为 User,填写成员 ID,例如 user001
  3. 将发送模式设为 Text,将 UTF-8 文本消息传入端口。
  4. 启用自动化中的发送,自动处理到达端口的消息。
文本模式将输入内容直接作为文本发送,不进行模板渲染。内容不能为空,端口按 UTF-8 字节数检查长度,文本最多为 2048 字节。

使用模板

将发送模式设为 Template,选择消息格式并填写模板。例如,选择 Markdown 后可使用:
每条输入消息都会触发模板渲染。模板模式发送渲染后的内容,渲染结果不能为空;文本最多为 2048 字节,Markdown 最多为 4096 字节。

发送文件

将发送模式设为 File,输入消息必须带有文件名。端口先上传文件,再使用返回的媒体 ID 发送文件消息;文件大小必须在 5 字节至 20 MiB 之间。 如需附带说明,启用发送附带消息并填写模板。文件和说明分别发送;如果文件已发送而说明失败,重试该输入消息会再次发送文件。

发送原始 JSON

将发送模式设为原始 JSON,输入消息应为企业微信消息请求的 JSON 对象,例如:
请求必须包含 msgtype,以及 tousertopartytotag 中至少一个接收人字段。此模式按原始 JSON 发送,忽略端口的接收人、头覆盖和消息格式设置。 端口会自动补充所选连接的 agentid 并提供身份验证。输入不得包含 access_token;如果填写了 agentid,必须与连接中的值一致。其他消息字段应符合企业微信对应消息类型的要求。

处理结果

发送成功后,输入消息标记为成功。配置、上传或发送失败时,输入消息标记为错误,可在交易日志中查看原因,并使用端口的重试设置重新处理。