View Source WeChat.CustomMessage (wechat v0.16.0)
消息管理 - 客服消息
同时支持 公众号 & 小程序 官方文档
Summary
Functions
客服消息接口 - 发送图文消息 by ArticleID (点击跳转到图文消息页面) - 官方文档
客服消息接口 - 发送卡券 - 官方文档
客服消息接口 - 发送图片消息 - 官方文档
客服消息接口 - 发送菜单消息 - 官方文档
客服消息接口 - 发送小程序卡片(要求小程序与公众号已关联) - 官方文档
客服消息接口 - 发送图文消息(点击跳转到图文消息页面) - 官方文档
客服消息接口 - 官方文档
客服消息接口 - 发送音乐消息 - 官方文档
客服消息接口 - 发送图文消息(点击跳转到外链) - 官方文档
客服消息接口 - 发送图文消息(点击跳转到外链) - 官方文档
客服消息接口 - 发送文本消息 - 官方文档
客服消息接口 - 发送文本消息 - by某个客服帐号 - 官方文档
客服消息接口 - 发送视频消息 - 官方文档
客服消息接口 - 发送语音消息 - 官方文档
Types
Functions
@spec send_article(WeChat.client(), WeChat.openid(), WeChat.Publish.article_id()) :: WeChat.response()
客服消息接口 - 发送图文消息 by ArticleID (点击跳转到图文消息页面) - 官方文档
使用通过 “发布” 系列接口得到的 article_id
@spec send_card(WeChat.client(), WeChat.openid(), WeChat.Card.card_id()) :: WeChat.response()
客服消息接口 - 发送卡券 - 官方文档
@spec send_image(WeChat.client(), WeChat.openid(), WeChat.Material.media_id()) :: WeChat.response()
客服消息接口 - 发送图片消息 - 官方文档
@spec send_mini_program_page(WeChat.client(), WeChat.openid(), map()) :: WeChat.response()
客服消息接口 - 发送小程序卡片(要求小程序与公众号已关联) - 官方文档
Example
WeChat.CustomMessage.send_mini_program_page(client, openid, {
title: "title",
appid: "appid",
pagepath: "pagepath",
thumb_media_id: "thumb_media_id"
})
@spec send_mp_news(WeChat.client(), WeChat.openid(), WeChat.Material.media_id()) :: WeChat.response()
客服消息接口 - 发送图文消息(点击跳转到图文消息页面) - 官方文档
客服消息接口 - 官方文档
@spec send_music(WeChat.client(), WeChat.openid(), map()) :: WeChat.response()
客服消息接口 - 发送音乐消息 - 官方文档
Example
WeChat.CustomMessage.send_music(client, openid, {
title: "MUSIC_TITLE",
description: "MUSIC_DESCRIPTION",
musicurl: "MUSIC_URL",
hqmusicurl: "HQ_MUSIC_URL",
thumb_media_id: "THUMB_MEDIA_ID"
})
@spec send_news(WeChat.client(), WeChat.openid(), article :: map()) :: WeChat.response()
客服消息接口 - 发送图文消息(点击跳转到外链) - 官方文档
@spec send_news( WeChat.client(), WeChat.openid(), title(), description(), url(), pic_url() ) :: WeChat.response()
客服消息接口 - 发送图文消息(点击跳转到外链) - 官方文档
Example
WeChat.CustomMessage.send_news(client, openid, {
title: "Happy Day",
description: "Is Really A Happy Day",
url: "URL",
picurl: "PIC_URL"
})
@spec send_text(WeChat.client(), WeChat.openid(), content()) :: WeChat.response()
客服消息接口 - 发送文本消息 - 官方文档
发送文本消息时,支持插入跳小程序的文字链
文本内容<a href="http://www.qq.com" data-miniprogram-appid="appid" data-miniprogram-path="pages/index/index">点击跳小程序</a>
说明:
data-miniprogram-appid
项,填写小程序appid
,则表示该链接跳小程序;data-miniprogram-path
项,填写小程序路径,路径与app.json
中保持一致,可带参数;- 对于不支持
data-miniprogram-appid
项的客户端版本,如果有herf
项,则仍然保持跳href
中的网页链接; data-miniprogram-appid
对应的小程序必须与公众号有绑定关系。
@spec send_text( WeChat.client(), WeChat.openid(), content(), WeChat.CustomService.kf_account() ) :: WeChat.response()
客服消息接口 - 发送文本消息 - by某个客服帐号 - 官方文档
@spec send_video(WeChat.client(), WeChat.openid(), map()) :: WeChat.response()
客服消息接口 - 发送视频消息 - 官方文档
Example
WeChat.CustomMessage.send_video(client, openid, {
media_id: "MEDIA_ID",
thumb_media_id: "MEDIA_ID",
title: "TITLE",
description: "DESCRIPTION"
})
@spec send_voice(WeChat.client(), WeChat.openid(), WeChat.Material.media_id()) :: WeChat.response()
客服消息接口 - 发送语音消息 - 官方文档
@spec typing(WeChat.client(), WeChat.openid(), is_typing :: boolean()) :: WeChat.response()
客服输入状态 - 官方文档
开发者可通过调用“客服输入状态”接口,返回客服当前输入状态给用户。
此接口需要客服消息接口权限。
- 如果不满足发送客服消息的触发条件,则无法下发输入状态。
- 下发输入状态,需要客服之前30秒内跟用户有过消息交互。
- 在输入状态中(持续15s),不可重复下发输入态。
- 在输入状态中,如果向用户下发消息,会同时取消输入状态。