Send WeChat Card

Product Q&A Agent
,
1

Applicable Scenarios:

  • Sending links to activity pages, article pages, case study pages, etc., to users

  • When you want the message to be a card with a title, description, and cover image, rather than a plain text link

API Endpoint: https://s.apifox.cn/84f4186f-8b20-4779-9fd4-da9ecad098ee/315430966e0

1. Configuration Methods

1.1 MCP Tool Configuration

2544×1336 263 KB

  1. URL: https://ae-bg.ddregion.com/hub-api/api/v2/message/send?token=Enterprise Token

  2. Request Body

{
  "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": "Selected Cases",
    "summary": "Click to view real medical stories and witness life-saving hope across borders.",
    "imageUrl": "https://www.medebound.com/assets/oss/img/1.png"
  }
}

Parameter Descriptions:

imContactId is the accountId,
"messageType": 12
sourceUrl: Redirect URL
title: Title
summary: Description
imageUrl: Cover image URL

1.2 AI SKILL Configuration

After setting up the trigger conditions, refer to the following configuration in the execution action:

1978×392 17.3 KB

2. Display Effect

1866×550 47.1 KB

3. Frequently Asked Questions

3.1 Why isn’t the message appearing as a card?

First, check the following points:

1. Is messageType set to 12?
2. Is the payload complete?
3. Is the sourceUrl a valid link?
4. Is the imageUrl accessible from the public internet?
5. Is the token correct?
6. Is imContactId set to the accountId?

3.2 The card is sent, but the cover image doesn’t show?

Most likely, check the imageUrl:

  • Is the image URL directly accessible?

  • Are there any authentication restrictions?

  • Is the link entered incorrectly?

3.3 The card opens but the link doesn’t work?

Focus on checking the sourceUrl:

  • Is the link valid?

  • Is access restricted by the target platform?

  • Does it require login or a specific environment to open?