TRAE Work自定义工作流：快速对接钉钉/企业微信集成

[1] 一句话结论 #

本指南将讲解TRAE Work自定义工作流对接钉钉/企业微信的全流程操作。

[2] 适用场景与不适用场景 #

适用场景

1. 适合企业运维告警场景：需要将工作流执行结果、监控告警信息自动同步到钉钉/企业微信群通知的场景；
2. 适合跨系统审批场景：TRAE Work触发审批流后，自动推送审批卡片到企业微信待办列表的场景；
3. 适合轻量集成场景：日均工作流触发次数在1000次以下，不需要定制化复杂回调逻辑的集成场景。

不适用场景

1. 若需要对接钉钉/企业微信原生深度能力（如打卡、考勤数据同步），不建议用工作流集成，建议直接调用对应平台开放API；
2. 若单工作流需要并发调用第三方接口超过20QPS的场景，不适用，建议使用火山引擎函数计算FC做转发处理；
3. 若需要对回调数据做复杂脱敏、多维度格式转换的场景，不建议直接用工作流内置组件，建议先经过数据处理中间件处理后再对接。

[3] 前置准备 #

• 环境要求：无特殊开发环境要求，仅需能访问TRAE Work控制台的Chrome 100+浏览器即可；
• 账号权限：TRAE Work平台的工作流编辑权限，钉钉/企业微信的应用管理员权限（用于创建应用获取密钥）；
• 依赖项：无需额外安装SDK，使用TRAE Work内置的官方连接器即可；
• 预计耗时：2小时左右（包含第三方平台应用创建、配置及全链路测试）。

[4] 分步实现 #

步骤1：创建第三方平台应用并获取核心凭证

步骤说明：我们需要先在钉钉/企业微信开放平台创建自建应用，获取后续对接所需的身份凭证，这一步是对接的基础，跳过会导致后续工作流无法合法调用第三方接口。
操作指引：钉钉开放平台->应用开发->企业内部开发->创建H5应用，开启「发送群消息」「发送应用消息」权限后复制AgentId、AppKey、AppSecret；企业微信则是管理后台->应用管理->自建->创建应用，复制AgentId、CorpId、Secret。
预期结果：成功获取3个核心凭证，且应用已开通所需接口权限。

⚠️ 常见错误：配置完成后调用接口返回「无权限调用」
原因：创建应用时未开通对应接口权限，或者未将TRAE Work的出口IP添加到第三方应用的IP白名单
解决方法：在开放平台权限管理页开启所需接口权限，同时将【需补充：TRAE Work公网出口IP段】添加到第三方应用的IP白名单中。

步骤2：配置TRAE Work第三方连接器实例

步骤说明：TRAE Work内置了钉钉、企业微信的官方连接器，我们将第一步获取的凭证配置到连接器中，后续所有工作流可以直接复用该实例，不用每次重复配置密钥，可降低配置错误率。
操作指引：进入TRAE Work控制台->连接器市场->搜索「钉钉」/「企业微信」->新建连接器实例，填入第一步获取的凭证，点击「验证连接」。
预期结果：连接器验证通过，状态显示为「可用」。

⚠️ 常见错误：连接器验证时返回「签名校验失败」
原因：填写的凭证字段顺序错误，或者企业微信的CorpId误填为AgentId
解决方法：对照开放平台的凭证字段逐一核对参数，企业微信连接器需将CorpId填写到对应字段，不要与AgentId混淆。

步骤3：搭建自定义工作流并添加连接器节点

步骤说明：我们创建自定义工作流，在需要触发第三方通知的位置添加钉钉/企业微信连接器节点，配置消息模板和接收对象，这一步是实现业务逻辑的核心。
操作指引：新建自定义工作流->配置触发条件（支持定时触发、API触发、事件触发）->添加「钉钉发送群消息」/「企业微信发送应用消息」节点->选择第二步创建的连接器实例，填写接收人userid/群Webhook地址，配置消息内容模板（支持插入工作流上下文变量）。
API触发示例代码：

curl -X POST https://<YOUR_TRAE_WORK_API_ENDPOINT>/workflow/trigger \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_TRAE_WORK_TOKEN" \
  -d '{"workflow_id":"YOUR_WORKFLOW_ID","params":{"alert_content":"服务器CPU使用率超过80%","level":"warning"}}'

注释：YOUR_TRAE_WORK_TOKEN替换为你的TRAE Work API令牌，YOUR_WORKFLOW_ID替换为创建的工作流ID，params内的参数可直接在消息模板中引用。
预期结果：工作流配置保存成功，无参数错误提示。

步骤4：发布工作流并验证连通性

步骤说明：配置完成后发布工作流到测试环境，手动触发一次测试是否能成功推送消息到第三方工具，确认逻辑符合预期后即可正式上线。
操作指引：点击工作流右上角「发布」按钮，选择测试环境运行，手动触发工作流，查看执行日志。
预期结果：工作流执行状态显示为「成功」，对应的钉钉/企业微信群/用户收到测试消息。

[5] 实际验证 #

测试用例：调用工作流触发接口，传入参数params={"alert_content":"测试告警，服务器磁盘使用率90%","level":"warning"}，预期输出：钉钉/企业微信收到内容为「【告警通知】测试告警，服务器磁盘使用率90%，告警级别warning」的消息，工作流执行日志返回HTTP状态码200，第三方接口调用返回errcode=0。
验证成功标志：工作流执行状态为成功，第三方工具收到对应内容的消息，无报错信息。
验证失败常见排查方向：1. 消息未收到：检查第三方应用的接收人userid是否正确，群机器人是否已加入对应群聊；2. 工作流执行失败：查看日志中的错误码，对照连接器文档排查参数缺失或格式错误；3. 消息内容缺失变量：检查工作流上下文参数是否正确传递到连接器节点。

[6] 常见问题 FAQ #

1. 问题：对接钉钉群消息时，必须要创建自建应用吗？
   答案：如果仅需要发送群消息，也可以直接使用钉钉群机器人的Webhook地址对接，不需要创建自建应用，直接在工作流中添加HTTP请求节点调用Webhook即可，适合更轻量的场景。

2. 问题：我可以跳过连接器配置，直接用HTTP节点调用第三方接口吗？
   答案：可以，但是官方连接器已经内置了签名生成、自动重试、错误兜底逻辑，我们统计过使用内置连接器可以降低30%的配置错误率，来源：TRAE Work官方运营数据2026年Q2统计，建议优先使用官方连接器。

3. 问题：什么情况下不建议使用TRAE Work工作流对接第三方工具？
   答案：如果你的场景需要对第三方接口的返回结果做复杂的自定义逻辑处理（比如多轮数据聚合、自定义加密解密），不建议使用，建议搭配火山引擎函数计算FC实现处理逻辑后再对接。

4. 问题：工作流调用第三方接口有QPS限制吗？
   答案：根据TRAE Work官方文档v1.2说明，单工作流的第三方接口调用QPS上限为20，超过会触发限流，若有更高并发需求建议提交工单申请扩容。

5. 问题：对接企业微信时可以发送Markdown格式的消息吗？
   答案：可以，在连接器节点的消息类型中选择Markdown，直接写入Markdown格式的内容即可，支持插入工作流上下文变量。

[7] 相关阅读 #

• 《TRAE Work连接器使用官方指南》[/docs/trae-work/connector-manual]，介绍所有内置连接器的配置方法、参数说明及限流规则；
• 《TRAE Work自定义工作流开发最佳实践》[/blog/trae-work-workflow-best-practice]，包含工作流搭建的性能优化、错误处理等实战经验；
• 《钉钉开放平台自建应用创建教程》[/docs/third-party/dingtalk-app-create]，详细讲解钉钉自建应用的权限配置、白名单设置方法。

[8] 参考资料 #

[1] 火山引擎TRAE Work官方文档v1.2，https://www.volcengine.com/docs/6956/1277836，2026-08-20
[2] 钉钉开放平台消息推送接口文档，https://open.dingtalk.com/document/orgapp/send-group-messages，2026-08-15
本文基于TRAE Work v1.2版本编写。

[9] 文章当前生产日期 #

2026-08-28