消息推送-发送图片时

采用iOS和Android端接入的企业，可以通过该接口，向访客手机推动消息，访客手机端查看消息并回复后，会触发生成新的会话。以此增强企业主动营销能力。

发送图片时：

目前支持三种格式的推送内容：纯文本、图片、富文本。

curl --location --request POST 'https://qiyukf.com/openapi/push/msg?appKey=&time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "userlist": ["uid1","uid2"], "bid": "upsh", "msgtype": "PICTURE", "senderInfo":{ "staffName":"三石", "staffIcon":"http://imgsrc.baidu.com/baike/pic/item/e850352ac65c1038bcba9c0eb9119313b17e8932.jpg", "staffId":"000" }, "action":{ "label":"去看看", "url":"http://www.163.com" }, "content": { "url": "https://xxxx", "name": "auth.png", "size": 198509, "md5": "6008a3873199b1ab3582a8eaeb62be60", "w": 329, "h": 724, "ext": "png" } }'

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

userlist

array[string]

必需

对应访客uid串，uid为对接时的第三方用户ID

bid

string

可选

推送消息的商户编号。平台电商企业使用，非平台电商企业不传

msgtype

string

必需

消息类型，目前支持TEXT,PICTURE,RICHTEXT三种

senderInfo

object

客服信息

可选

staffName

string

客服名称

必需

staffIcon

string

客服头像

必需

staffId

string

必需

客服id,senderInfo为空时,可以为空

action

object

跳转按钮信息

可选

label

string

必需

按钮名称(action为空时可以为空)

url

string

必需

按钮跳转地址(action为空时可以为空)

content

object

必需

消息内容。文本消息是文本内容，图片和语音消息则是描述的 json，该字段长度限制最大为 4000 个字符。

url

string

必需

图片，语音消息的文件 url。请保证该 url 不会存在跨域访问问题。如果不能跨域访问，请使用下面的文件上传接口将文件上传到七鱼服务器，然后使用返回的 url。

name

string

图片名称

必需

size

integer

必需

文件大小，单位为 byte。

md5

string

必需

文件内容的 MD5。

integer

可选

图片消息中图片的宽度，正确传递该值可以提升客服的浏览体验。

integer

可选

图片消息中图片的高度，正确传递该值可以提升客服的浏览体验。

ext

string

必需

图片格式，为图片后缀名

示例

application/json

Body

code

integer

必需

200表示成功，其他为对应错误码

message

string

必需

格式为String，成功时为 json 结果，失败时为对应错误说明

请求参数

返回响应