能力介绍
该接口为企业提供了主动触达用户能力。开发者可以通过 API 向指定成员、部门或群聊发送即时消息。不仅支持基础文本,还支持 Markdown 格式(如卡片、高亮文字)、图片、视频、文件以及模板卡片消息,满足各类通知和运营需求。
10分钟接入 Demo
-
获取 Token :调用
/gettoken接口获取全局唯一票据。 -
构造 JSON :按照文档要求封装消息体,指定
touser或chatid。 -
发起请求:通过 HTTPS POST 协议向发送接口提交数据。
-
确认结果 :根据返回的
errcode判断是否发送成功。

API 示例代码 (Python 简示)
python
import requests
url = "https://api.qiweapi.com/cgi-bin/message/send?access_token=ACCESS_TOKEN"
payload = {
"touser": "UserID123",
"msgtype": "text",
"text": { "content": "您有一条新的待处理订单,请及时查看。" }
}
response = requests.post(url, json=payload)
print(response.json())
使用场景说明
-
系统监控告警:运维服务器出现异常时,通过企微 API 秒级推送到管理员手机。
-
营销活动通知:向私域客户定向发送个性化的活动邀请卡片。
-
OA 审批提醒:员工提交申请后,自动向审批人发送带链接的确认消息。
FAQ
-
Q:发送频率有限制吗?
- A:基础消息发送频率较高,但建议大批量推送时增加时间间隔,避免触发反垃圾机制。
-
Q:可以发送复杂的图文卡片吗?
- A:可以,支持
template_card消息类型,可配置按钮、状态标签等。
- A:可以,支持
更多资源