发送微信卡片

智能体
,
1

适用场景：

- 给用户发送活动页、文章页、案例页等链接

- 希望消息不是纯文本链接，而是带有标题、描述、封面图的卡片

接口地址：https://s.apifox.cn/84f4186f-8b20-4779-9fd4-da9ecad098ee/315430966e0

1. 配置方式

1.1 MCP工具配置

2544×1336 263 KB

  1. URL：https://ae-bg.ddregion.com/hub-api/api/v2/message/send?token=企业级token

  2. 请求体

{
  "imBotId": "{{var.visitor.imBotId}}",
  "imContactId": "{{var.visitor.accountId}}",
  "messageType": 12,
  "payload": {
    "sourceUrl": "https://mp.weixin.qq.com/mp/appmsgalbum?action=getalbum&__biz=MzI0OTAyNjQzNQ==&scene=1&album_id=1458907349816918016&count=3#wechat_redirect",
    "title": "精选案例",
    "summary": "点击查看真实诊疗故事，见证跨越国界的生命希望。",
    "imageUrl": "https://www.medebound.com/assets/oss/img/1.png"
  }
}

部分参数说明：

imContactId即为accountid，
"messageType": 12
sourceUrl：跳转地址
title：标题
summary：描述
imageUrl：封面地址

1.2 AI SKILL配置

设置好触发条件后，在执行操作中参考如下配置即可

1978×392 17.3 KB

2. 呈现效果

1866×550 47.1 KB

3. 常见问题

3.1 为什么发出去不是卡片？

先检查这几个点：

1. messageType 是否为 12
2. payload 是否完整
3. sourceUrl 是否是有效链接
4. imageUrl 是否能被公网访问
5. token 是否正确
6. imContactId 是否传的是 accountId

3.2 卡片能发出，但封面不显示？

大概率先看 imageUrl：

  • 图片地址是否可直接访问

  • 是否有鉴权限制

  • 是否填错链接

3.3 点击卡片后打不开？

重点检查 sourceUrl：

  • 链接是否有效

  • 是否被目标平台限制访问

  • 是否需要登录或特定环境才能打开