MCP/API发送企微消息_以转人工通知为例

[nct_liuhaonan]

发送企微消息 API

API 地址

https://c2.xinheyun.com/api/open/v2/coze/workflow/run

该地址是调用我们已封装功能的接口。
通过请求体中"workflowId"字段定位到功能，"发送企微消息"功能的"workflowId"是7561281801097592842。

执行逻辑：

执行逻辑

• imBotId 为空：
  由于通过 MCP 发送的参数无法直接携带 imBotId，将通过输入的 wx_post_msg_token 获取当前企业下所有托管帐号 ID（imBotId），
  然后对所有 imBotId + imContactId 组合循环发送消息（终止条件：发送成功）。若所有帐号均未发送成功，输出每个帐号发送失败的 errmsg（示例见上）。

• imBotId 不为空：
  通过指定的 imBotId + imContactId 发送消息。

---

请求内容：

token

由OAuth客户端生成token，详见 OAuth客户端获取调用C2_API的token

请求体&请求体字段说明

{
  "workflowId": "7561281801097592842",
  "parameters": {
    "imContactId": "788...",
    "msg": "测试消息...",
    "wx_post_msg_token": "c2c1..."
  }
}

字段名	是否必填	说明	获取方式
workflowId	必填	调用[发送企微消息功能]的 ID	固定为 7561281801097592842
imContactId	必填	对应好友联系人的聊天 ID	在“联系人”中，取对应联系人的 accountId 字段
wx_post_msg_token	必填	发送微信消息的 token	在「微信互通–API事件配置」中复制 token 作为 wx_post_msg_token
msg	必填	发送的文本消息	自行配置要发送的文本内容
imBotId	非必填	对应绑定帐号的 ID	在「微信互通–连接企业微信」中复制“托管帐号”字段下微信名后的括号中的“1688…”

---

返回响应：

API返回

• 成功：ok
• 失败：报错详情*n（例如："invalid imContactId | invalid imContactId | invalid imContactId"）

---

CASE 1：通过 MCP 实现“转人工”微信通知

先获取并配置MCP工具调用此API接口的 token，配置见「OAuth 客户端获取调用 C2_API 的 token」。

1. 为MCP配置token

1. 进入 3Chat Agent → MCP 授权访问 → 新建
   

   

2. 在弹出的页面中填写信息：

   • 配置名称
   • 配置备注
   • 配置 Token（粘贴刚才生成的令牌）
     
     

2. AI 任务配置

1. 按图示配置：

转人工通知
---
当客户有以下任一情况时：
当客户想要退款时
当客户想要投诉时
---
必须调用"发送转人工通知"工具

2. 点击【保存】→【运行】

3. MCP 配置

(1) 基本信息

notify_human
---
发送转人工通知

(2) 请求配置

https://c2.xinheyun.com/api/open/v2/coze/workflow/run
---
msg   对话上下文
name  联系人的姓名
---
{
  "workflowId": "7561281801097592842",
  "parameters": {
    "imContactId": "【这里要替换为接收消息的企微好友id，见文章开头:必要参数--imContactId】",
    "msg": "【重要信息】客户{{name}}：{{msg}}",
    "wx_post_msg_token": "【这里要替换为，见文章开头:必要参数--wx_post_msg_token】"
  }
}

(3) 接口测试
出现如下反馈时，表示成功；同时对应的个人微信应收到通知：

(4) 下一步
点击【保存】。

效果展示：