企业微信发送图片 API

「发送图片」接口属于青鸾开放平台的「消息」能力，用于向客户或客户群发送各类消息、并实时接收消息回调。通过语义化 HTTP API 调用，无需对接复杂底层即可快速集成，常用于 SCRM、客服系统、私域运营与营销自动化等场景。

接口地址

POSThttps://api.qingluanbot.com/wecom/messages/send-image

请求示例（cURL）

curl -X POST 'https://api.qingluanbot.com/wecom/messages/send-image' \
  -H 'X-Qingluan-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "instance_guid": "inst_xxxxxxxxxxxxxxxx",
    "fileAesKey": "FILE_AES_KEY",
    "fileId": "FILE_ID",
    "fileKey": "FILE_KEY",
    "fileMd5": "FILE_MD5",
    "fileSize": 10240,
    "filename": "example.png",
    "toId": "RECIPIENT_ID"
  }'

请求参数

响应

统一响应信封 { ok, code, message, request_id, data }，code=0 表示成功，每次响应都带 request_id（ql_ 前缀）便于排查。

如何接入

1. 注册并登录青鸾开发者控制台（注册即自动生成 API Key）。
2. 在「实例与回调」一键扫码上号，获得 instance_guid。
3. 请求头携带 X-Qingluan-Key，调用本接口 POST /wecom/messages/send-image。
4. 如需接收消息/事件，配置 Webhook 回调地址即可。

相关接口