微信模板消息

该接口用于将企业发送给用户的资料，以微信模板消息的形式发出。使用该接口前，需要企业的公众号已添加相应的模板，且企业需要按照指定格式提供访问接口，供七鱼获取对应的数据。通过该接口，七鱼提供了特定业务支持的数据源集。企业设置的模板中支持哪些数据，将对应数据的在模板中的key填入请求中即可完成设置。当用户查询时，七鱼会访问企业提供数据的接口，然后会将对应的数据根据模板配置填入，最后发给用户。

该接口目前仅支持设置物流类的模板信息。

示例：某个公众号添加了ID为 s8BlawhJMXO4YWEvvsrBiBrxuBJzYwpk-HchuAa9jbc 的模板，其格式为：

{{first.DATA}}
订单编号：{{keyword1.DATA}}
取件公司：{{keyword2.DATA}}
{{remark.DATA}}

调用设置接口的内容如下：

{
    "appId": "wxcxxxxxxx",
    "logistic": {
        "template_id":"s8BlawhJMXO4YWEvvsrBiBrxuBJzYwpk-HchuAa9jbc",
        "top":"first",
        "bottom":"remark",
        "id": "keyword1",
        "name":"keyword2"
    }
}

curl --location --request POST 'https://qiyukf.com/openapi/settings/wxTemplates?appKey=&time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "appId":"wxcxxxxxxxxx", "logistic": { "template_id":"s8BlawhJMXO4YWEvvsrBiBrxuBJzYwpk-HchuAa9jbc", "top":"first", "bottom":"remark", "id": "keyword1", "name":"keyword2", "last_state": "keyword3", "update_time": "keyword4", "sender":"keyword5", "sender_site":"keyword6", "sender_phone":"keyword7", "receiver":"keyword8", "receiver_site":"keyword9", "receiver_phone":"keyword10", "order_id":"keyword11", "order_time":"keyword12", "price":"keyword13", "status":"keyword14", "good_name":"keyword15" } }'

请求参数

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

appId

string

必需

公众号的appId，可在公众号后台查看。

logistic

object

可选

物流类模板信息，物流类必须，其他类无需设置。

template_id

string

必需

该模板的ID, 可在公众号后台看到

top

string

可选

显示在模板消息第一行的内容的key

bottom

string

可选

显示在模板消息最后一行的内容的key

string

可选

物流运单ID的key

name

string

可选

快递公司名称的key

last_state

string

运单的最新状态

可选

update_time

string

最新状态的更新时间

可选

sender

string

寄件人的key

可选

sender_site

string

寄出地址的key

可选

sender_phone

string

可选

寄件人联系电话的key

receiver

string

收件人的key

可选

receiver_site

string

收件地址的key

可选

receiver_phone

string

收件人电话的key

可选

order_id

string

可选

与运单关联的商品订单ID的key

order_time

string

可选

商品下单时间或者寄件时间的key

price

string

可选

商品价格或者快递单价格的key

status

string

可选

商品订单状态或者运单状态的key

good_name

string

商品名称的key

可选

示例

请求参数

返回响应