文档中心 商家相关 发送通知

发送通知

1.使用场景

商家多渠道通知关爱通用户,包括给到显示,短信发送,邮件发送(用户在关爱通需绑定了手机或邮箱,才能收到对应信息).

商家需提前联系关爱通技术,进行模板配置,给出对应模板编号/code.

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/seller/msg/sendTplMsg

HTTP请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
open_id string 32 员工唯一标识
code string 模板编号,需提前配置
language string 固定 语言,cn(中文) 或者 en(英文)
channels string 固定 发送渠道 json格式 [1,2,3] 渠道:1.站内信,2.邮件,3.短信,5.app推送; 如:[1,2].默认发送所有渠道
parameters string [0,1000] 模板内的通配符,json格式:{"employeeNo":952777,"employeeName":"9527订单77"}
请求示例
POST /seller/msg/sendTplMsg HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache

access_token=a827580daf73c364b64cabd8303496d4&sign=420607330f3105ba980e65aaf431aecae985b73e&
timestamp=1529489716&language=cn&open_id=555f80990ba173b95ddad6e83796e9c5&channels=[1,2,3]&
parameters={"test":"你好","testSec":"测试"}&code=20110697_test_sms
                    
返回参数说明
参数名称 描述
code 返回码。详见错误返回码
msg 如果错误,返回错误信息。
data 如果没有错误,返回发送结果true/false
正确返回示例
{
    "code": 0,
    "data": true,
    "msg": "OK"
}
错误返回示例
{
    "code": 1000210001,
    "msg": "timestamp check failed!",
    "data": null
}