企业微信发送小程序 API
「发送小程序」接口属于青鸾开放平台的「消息」能力，用于向客户或客户群发送各类消息、并实时接收消息回调。通过语义化 HTTP API 调用，无需对接复杂底层即可快速集成，常用于 SCRM、客服系统、私域运营与营销自动化等场景。
免费试用本接口 查看完整文档接口地址
POSThttps://api.qingluanbot.com/wecom/messages/send-weapp请求示例（cURL）
curl -X POST 'https://api.qingluanbot.com/wecom/messages/send-weapp' \
-H 'X-Qingluan-Key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"instance_guid": "inst_xxxxxxxxxxxxxxxx",
"appId": "示例值",
"coverFileAesKey": "FILE_AES_KEY",
"coverFileId": "示例值",
"coverFileSize": 10240,
"desc": "示例值",
"pagePath": "示例值",
"thumbUrl": "https://example.com",
"title": "标题",
"username": "示例值",
"toId": "RECIPIENT_ID"
}'请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
instance_guid | string | 必填 | 青鸾实例 ID（标识一个企业微信在线实例） |
appId | string | 必填 | — |
coverFileAesKey | string | 必填 | — |
coverFileId | string | 必填 | — |
coverFileSize | integer | 必填 | — |
desc | string | 必填 | — |
pagePath | string | 必填 | — |
thumbUrl | string | 必填 | — |
title | string | 必填 | — |
username | string | 必填 | — |
toId | string | 必填 | — |
响应
统一响应信封 { ok, code, message, request_id, data }，code=0 表示成功，每次响应都带 request_id（ql_ 前缀）便于排查。
如何接入
- 注册并登录青鸾开发者控制台（注册即自动生成 API Key）。
- 在「实例与回调」一键扫码上号，获得
instance_guid。 - 请求头携带
X-Qingluan-Key，调用本接口POST /wecom/messages/send-weapp。 - 如需接收消息/事件，配置 Webhook 回调地址即可。