易信公众账号CRM服务发送客服消息
为满足用户客户服务需求,公众平台提供了发送客服消息,主要场景用于CRM服务
当用户主动发消息给公众号的时候(包括发送信息、点击自定义菜单click事件、订阅事件、扫描二维码事件),易信将会把消息数据推送给开发者,开发者在一段时间内(目前为24小时)可以调用客服消息接口,通过POST一个JSON数据包来发送消息给普通用户,在24小时内不限制发送次数。开发者发送消息给用户有文本,图片,语音,视频,链接,名片,图文消息
目录
[隐藏]1请求说明
2接口范例
3请求参数
4返回说明
5返回参数
6异常返回说明
请求说明
http请求方式:POST(请使用https协议)
https://api.yixin.im/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN
接口范例
发送文本
{
"touser":"OPENID",
"msgtype":"text",
"text":{
"content":"HelloWorld"
}
}
发送图片
{
"touser":"OPENID",
"msgtype":"image",
"image":{
"media_id":"MEDIA_ID"
}
}
发送语音
{
"touser":"OPENID",
"msgtype":"voice",
"voice":{
"media_id":"MEDIA_ID"
}
}
发送视频
{
"touser":"OPENID",
"msgtype":"video",
"video":{
"media_id":"MEDIA_ID"
}
}
发送链接消息
{
"touser":"OPENID",
"msgtype":"link",
"link":{
"title":"title",
"description":"description",
"url":"http://www.163.com/"
}
}
发送名片
{
"msgtype":"card",
"card":{
"card":"YIXINID"
}
}
发送图文消息(支持1-10条图文展示)
{
"touser":"OPENID",
"msgtype":"news",
"news":{
"articles":[
{
"title":"HappyDay",
"description":"IsReallyAHappyDay",
"url":"URL",
"picurl":"PIC_URL"
}
]
}
}
请求参数
参数是否必须描述
access_token是调用接口凭证
touser是普通用户openid
msgtype是消息类型,支持文本(text)、图片(image)、语音(voice)、视频(video)、链接(link)、名片(card)、图文(news)
media_id是image,voice,video必须媒体文件id
title是link,news必须消息标题
description是link,news必须消息描述
url否点击链接跳转地址
picurl否图片链接,支持JPG、PNG格式,较好的效果为大图640*320,小图80*80
返回说明
{"errcode":0,"errmsg":"请求成功"}
返回参数
参数描述
errcode接口返回码,0成功,其他都为失败
errmsg接口返回信息,若成功,返回返"请求成功",否则回具体失败原因
异常返回说明
{"errcode":40004,"errmsg":"invalidmediatype"}