给七鱼发送消息-图片消息

POST

https://qiyukf.com/openapi/message/send

目前仅支持开发者服务器替用户向客服发送消息。

发送消息时，如果用户尚未分配过客服，该消息将自动转给机器人，由机器人回答。如果需要发送消息给人工客服，可以先调用请求分配客服，等分配到一个客服后再发送消息。

为了防止因网络延时造成的错误，如果用户在上一次会话结束后的10秒内又发了消息，这条消息将会自动发给上一个会话的客服。

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://qiyukf.com/openapi/message/send?appKey=&time=&checksum=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "uid":"user1",
    "msgType":"PICTURE",
    "content":
    {
    	"url": "http://url_of_image",
        "size": 10000,
        "md5": "xxxx",
        "w": 200,
        "h":200
    }
}'

响应示例

{
  "code": 0
}

请求参数

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

uid

string

必需

开发者的应用里的用户ID。

msgType

string

必需

消息类型。（目前仅支持 TEXT, PICTURE, AUDIO 三种，分别是文本，图片和语音消息）。

content

object

必需

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

url

string

必需

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

size

integer

必需

文件大小，单位为 byte。

md5

string

必需

文件内容的 MD5。

integer

可选

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

integer

可选

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

示例

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码。200表示发送成功。

修改于 2022-01-28 04:20:37

给七鱼发送消息-文本消息

给七鱼发送消息-语音消息