企业微信图文消息推送：结构化内容的进阶呈现

企微支持
4 阅读2分钟

核心功能：发送图文消息（混合文本与链接）

能力介绍

发送图文消息（News/Textcard） 解决了纯文本消息表达单一的问题。它允许开发者将标题、描述、点击链接及封面图片整合在一个消息卡片中。这种“混合”形式不仅能承载更多信息，还能通过视觉引导提高用户的点击率，是实现业务闭环（如点击卡片跳转至 H5 或小程序）的核心能力。

10 分钟接入 Demo

  1. 准备素材：确定卡片的标题（Title）、描述（Description）、跳转链接（Url）及封面图 URL。
  2. 获取 AccessToken：确保已获取有效的 access_token。
  3. 构建消息体：选择 news 类型（含图片）或 textcard 类型（纯文字卡片）。
  4. 发起请求：调用 POST /message/send 接口。
  5. 手机端预览：在企业微信客户端查看卡片渲染效果。

API 示例代码

以下为发送 图文消息 (News) 的标准调用示例：

Python

import requests
import json

def send_news_message(access_token, user_id):
    url = f"https://api.qiweapi.com/cgi-bin/message/send?access_token={access_token}"
    
    payload = {
        "touser": user_id,
        "msgtype": "news",
        "agentid": 1000002,
        "news": {
            "articles": [
                {
                    "title": "中台系统数据周报",
                    "description": "本周新增客户 128 位，点击查看详细分析报告。",
                    "url": "https://yourdomain.com/report/123",
                    "picurl": "https://yourdomain.com/images/cover.jpg" # 封面图地址
                }
            ]
        },
        "enable_id_trans": 0
    }
    
    response = requests.post(url, data=json.dumps(payload))
    return response.json()

# 调用示例
# res = send_news_message("YOUR_TOKEN", "ZhongGong")
# print(res)

使用场景说明

  • 企业新闻推文：向全员推送公司动态，通过图文封面吸引点击阅读。
  • 任务审批卡片：在描述中列出申请人、事由等关键混合信息，引导用户点击链接跳转到审批页面。
  • 活动邀请函：发送带有精美封面的活动通知，直接链接至报名表单。

FAQ

  • Q：图文消息支持发送多条卡片吗？

    • A：支持。articles 数组中可以包含多个对象，首条为大图，后续为小图，建议不超过 8 条。

  • Q：图片显示不出来是什么原因？

    • A：请确保 picurl 是公网可访问的静态资源链接，且格式为 JPG 或 PNG。

  • Q：如果不想要封面图，只想要方块卡片效果怎么办？

    • A：可以将 msgtype 修改为 textcard（文本卡片），其结构包含标题、描述和跳转链接，不含图片。

引导入口

avatar
文章
阅读
粉丝