企业微信客服收到的用户消息中的返回参数sender_id是微信用户的id吗？

[qazxswaaa]

目前在Dify工作流中使用，能够接收到微信用户发给客服的消息，现在要把工作流中大模型的回复返给指定用户，不太清楚在使用触发器接收到的一些参数是代表什么
{
"adapter_name": "WecomCSAdapter",
"bot_uuid": "98588d86-0ed8-47b1-9edb-975abf32dcae",
"message": [
{
"id": "AjoSgZBnm8bHRKFZ7TGyzqd64G",
"timestamp": 1768903197,
"type": "Source"
},
{
"text": "膝关节疼痛",
"type": "Plain"
}
],
"plain_text": "膝关节疼痛",
"raw_event": {
"data": {
"adapter_name": "WecomCSAdapter",
"bot_uuid": "98588d86-0ed8-47b1-9edb-975abf32dcae",
"message": [
{
"id": "AjoSgZBnm8bHRKFZ7TGyzqd64G",
"timestamp": 1768903197,
"type": "Source"
},
{
"text": "膝关节疼痛",
"type": "Plain"
}
],
"sender": {
"id": "uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA",
"name": ""
},
"timestamp": 1768903194
},
"event_type": "bot.person_message",
"uuid": "0b69d365-20ba-4326-ad6d-856578f2619b"
},
"sender": {
"id": "uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA",
"name": ""
},
"sender_id": "uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA",
"sender_name": "",

[dosubot]

是的，企业微信客服收到的消息中的 sender_id（比如你看到的 "uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA"）就是微信用户的唯一标识 ID，一般对应企业微信开放平台返回的微信用户 OpenID，用于在 Dify 工作流中识别和回复指定用户。你可以直接用这个 sender_id 作为回复目标，无需做额外的映射或转换，适用于企业微信客服与微信用户的对话场景。sender_name 是显示名称，如果为空可以只用 sender_id。参考

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[qazxswaaa]

@dosu 尝试了使用sender_id作为external_userid来给微信用户返回消息，但是显示id是错误的
报错如下
{
"output": "failed:40096:invalid string value uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA. invalid external userid, hint: [1768979428560333475200962], from ip: , more info at https://open.work.weixin.qq.com/devtool/query?e=40096"
}

[dosubot]

你遇到 40096 错误的原因是：企业微信客服 API 发送消息时，要求 external_userid 必须是企业微信官方事件推送里带的 external_userid 字段，而不是 Dify 工作流参数中的 sender_id。虽然 sender_id 在 Dify 里用于标识消息发送者，但它未必等同于企业微信 API 需要的 external_userid，两者在部分场景下并不一致。

在 LangBot 的 WecomCSAdapter 实现中，真正用于回复的 external_userid 是从原始企业微信事件 payload 的 external_userid 字段获取的（见 代码实现 和 WecomCSEvent.user_id）。如果 Dify 工作流触发器没有把原始 external_userid 透传出来，而你用 sender_id 代替，就会导致 API 校验失败，报 40096。

建议：

1. 检查 Dify 工作流触发参数里是否有原始事件的 external_userid 字段（通常在 raw_event.data.external_userid 或类似字段里）。
2. 如果没有，需要调整触发器或中间处理逻辑，把 WeCom 事件 payload 里的 external_userid 作为参数传递到后续流程，作为回复目标。
3. 切勿直接用 sender_id 作为 external_userid，否则会一直报错。

如需参考代码细节，可见 WecomCSAdapter.reply_message 和 WecomCSEvent.user_id。

如还有疑问，可以贴下 raw_event 的完整内容，帮你定位 external_userid 字段。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[qazxswaaa]

@dosu raw_event内容如下
{
"data": {
"adapter_name": "WecomCSAdapter",
"bot_uuid": "98588d86-0ed8-47b1-9edb-975abf32dcae",
"message": [
{
"id": "AvYWcxB5LV2HpFen2X2pk544Xa",
"timestamp": 1768981328,
"type": "Source"
},
{
"text": "11111",
"type": "Plain"
}
],
"sender": {
"id": "uwmmWKKYwAAhvS-f-Gy8gp70MACAOE2hA",
"name": ""
},
"timestamp": 1768981323
},
"event_type": "bot.person_message",
"uuid": "716f19f5-3cf9-4f7a-838c-4a06f00b2860"
},

[dosubot]

你的 raw_event 里确实没有 external_userid 字段，这也是你用 sender_id 作为 external_userid 时会报 40096 错误的根本原因。企业微信客服 API 回复消息时，必须用官方事件推送 payload 里的 external_userid 字段，而不是 sender_id 或 sender.id。LangBot 的 WecomCSAdapter 也是直接用 external_userid 字段来做回复目标的（见代码实现，WecomCSEvent.user_id）。

你现在的 raw_event 结构是 Dify 或中间件二次封装后的内容，已经丢失了原始 external_userid 字段。要解决这个问题，需要让 workflow 触发参数里包含原始企业微信事件 payload 的 external_userid 字段（通常在 raw_event.data.external_userid 或 raw_event.data.message.external_userid 里，具体取决于事件结构）。如果没有，需要调整触发器或中间处理逻辑，把 external_userid 透传到后续流程，作为回复目标。

总结：不能用 sender_id 作为 external_userid，必须用企业微信事件里的 external_userid 字段。建议排查下事件链路，确保 external_userid 能被完整传递到 workflow 触发参数里，否则无法正确回复微信用户。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}

  

[qazxswaaa]

@dosu 我使用的是Dify市场中你们官方发布的触发器插件，为什么会这样呢？有没有可能改进

[dosubot]

这是因为 Dify 官方触发器插件在构造 workflow 参数时，没有把企业微信原始事件中的 external_userid 字段透传出来，只保留了 sender_id 等字段。实际上，WecomCSAdapter 回复消息时必须用 external_userid（见 代码实现），sender_id 不是有效的 external_userid，所以会导致 40096 错误。

这个问题本质上是插件参数传递的疏漏，并非有意为之。完全可以改进：只要让触发器插件在 workflow 参数中增加 external_userid 字段（从原始企业微信事件 payload 里获取），后续流程就能直接用它作为回复目标，避免 API 报错。你可以反馈给插件维护者，建议他们在参数构造时补充 external_userid 字段即可。

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}