2023年微信小程序API 发送客服消息
作者: --时间: 2025-06-16 23:34:45
阅读量：
微信小程序API 发送客服消息
当用户与小程序客服通过特定动作进行交互时（具体动作列表见下文），微信会将消息数据推送给开发者。开发者可以在一段时间内（目前为48小时）调用客服接口，通过POST一个JSON数据包来向普通用户发送消息。该接口主要用于客服等有人工消息处理环节的功能，方便开发者向用户提供更好的服务。
1. 动作列表及允许下发条数和时限
目前允许的动作列表如下，不同动作触发后，允许的客服接口下发消息条数和下发时限不同。达到下发条数上限后，API会返回错误码，请注意查看返回码说明页：
| 用户动作 | 允许下发条数限制 | 下发时限 |
|---|---|---|
| 用户通过客服消息按钮进入会话 | 1条 | 1分钟 |
| 用户发送信息 | 5条 | 48小时 |
2. 客服接口-发消息
接口调用请求如下：
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
以下是各种消息类型所需的JSON数据包：
2.1 发送文本消息
{
"touser":"OPENID",
"msgtype":"text",
"text": {
"content":"Hello World"
}
}
2.2 发送图片消息
{
"touser":"OPENID",
"msgtype":"image",
"image": {
"media_id":"MEDIA_ID"
}
}
2.3 发送图文链接
每次只能发送一个图文链接。
{
"touser":"OPENID",
"msgtype":"link",
"link":
{
"title":"Happy Day",
"description":"Is Really A Happy Day",
"url":"URL",
"thumb_url":"THUMB_URL"
}
}
立即扫码关注
多用户商城平台系统