企业微信
本文介绍如何创建企业微信自建应用，接收企业成员的单聊群聊文本消息，调用腾讯云 EdgeOne Makers 中的 Agent，并将结果作为应用消息返回该成员。
前提条件和适用范围
1. 已注册企业微信企业，测试成员已加入企业；
2. 操作账号具有自建应用管理权限。
3. 已开通 Makers。
4. 已准备公网 HTTPS 回调域名，满足企业微信后台的域名校验要求。后台要求主体相关备案域名时，应使用符合要求的自定义域名。
5. 已取得 Makers 服务调用企业微信 API 的实际出口 IP，可将其配置到应用的 企业可信 IP。
6. 本文只验证企业内部成员与自建应用的文本单聊，不包含群聊、客户联系或外部企业成员。
创建企业自建应用
1. 登录企业微信管理后台。
2. 进入 应用管理 > 应用，在 自建 区域单击 创建应用。
3. 上传应用图标，输入应用名称和介绍，例如 Makers 助手。
4. 在 可见范围 中加入测试成员或测试部门，完成创建。
5. 在应用详情中复制 AgentId，单击 Secret 旁的 查看，完成身份验证后复制应用 Secret。
6. 进入 我的企业 > 企业信息，复制 企业 ID，即 `CorpID`。
准备消息接收凭证
1. 返回当前自建应用详情，进入 接收消息 > 设置API接收。
2. 在接收消息服务器配置中设置 Token，生成 EncodingAESKey，分别复制保存。
3. 暂时保留页面，待 Makers 部署完成后填写 URL 并保存。不要在还没有可用回调服务时反复提交 URL 校验。
经过以上步骤，你可以获得以下配置
凭证 | 来源 | 用途 |
CorpID | 企业信息中的企业 ID | 获取应用访问凭证、核对解密接收方 |
AgentId | 当前自建应用详情 | 指定发送回复的应用 |
Secret | 当前自建应用详情 | 获取应用 access_token |
Token | 接收消息服务器配置 | 校验回调签名 |
EncodingAESKey | 接收消息服务器配置 | 解密消息与 URL 校验字符串 |
注意：五项值必须属于同一企业和应用。`Token` 不是 API 的 `access_token`，不能用通讯录同步 Secret 替代应用 Secret。`access_token` 由模板获取，无需手动创建环境变量。协议字段见企业微信回调配置。
部署 Makers 模板
1. 打开 Makers Agent for IM 模板。
2. 在项目环境变量设置中填写以下变量（负责一份.env.example 为.env）。
环境变量 | 是否必填 | 填写说明 |
WECOM_CORP_ID | 是 | 企业 ID |
WECOM_AGENT_ID | 是 | AgentId |
WECOM_APP_SECRET | 是 | Secret |
WECOM_TOKEN | 是 | Token |
WECOM_ENCODING_AES_KEY | 是 | EncodingAESKey |
3. 保存配置并部署
4. 复制生产环境 HTTPS 域名，在末尾添加 /wecom
5. 注意服务应该部署大陆可用区，企微服务才能正确访问。
保存回调 URL
1. 返回接收消息服务器配置页面。
2. 将完整地址填写到 URL。
3. 核对 Token 和 EncodingAESKey 与 Makers 中配置的值一致，单击 保存。
4. 确认 URL 校验通过，接收消息配置已启用。
发送消息并验证
1. 使用可见范围内的成员账号登录企业微信。
2. 在 工作台 找到创建的应用，进入该应用的消息会话；不要停留在应用主页网页中。
3. 发送消息如： "请用一句话介绍腾讯云 EdgeOne Makers"。
4. 查看 Makers 日志，并确认同一成员的应用会话收到新的 Markdown 回复。
5. 再发送 `请把上一条回答缩短为十个字以内。`，确认第二轮仍能收到回复。
6. 更复杂的 AI 需求，可根据需求自行修改模板代码实现。
