shopping-guide.updateGuideMasssendJob

本接口应在服务器端调用,详细说明参见服务端API

修改群发任务

无法修改已经执行的任务,返回参数错误。

请求地址

POST https://api.weixin.qq.com/cgi-bin/guide/updateguidemassendjob?access_token=ACCESS_TOKEN

请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
task_id number 任务id
task_name string 群发任务名称,不超过16字
task_remark string 群发任务备注,不超过100字
push_time number 下发时间, 秒级时间戳, 范围为当前时间开始到最近一个月内
openid Array.<string> 不超过5000个客户
material Array.<Object> 不超过3个素材

material的结构

属性 类型 说明
type number 素材类型,1.文本,3.图片,49.小程序卡片
media_id string 图片类型素材或者卡片类型素材的封面,只能用《素材管理获取media_id》
title string 小程序卡片标题,最多35字
path string 小程序卡片路径
appid string 小程序卡片appid,需要关联到公众号
word string 文本类型素材的内容,不超过300字节

返回值

Object

属性 类型 说明
errcode number 错误码
errmsg string 错误信息

errcode 的合法值

说明 最低版本
0 成功
-1 系统失败
40097 参数错误
40003 无效的openid
43004 没有关注该服务号
9300801 无效的微信号
9300804 该微信号不是顾问
9300806 客户和顾问不存在绑定关系
9300807 标签值无效,不是可选标签值
9300819 media_id无效
40168 小程序卡片appid没有和公众号关联

请求数据示例

{
    "task_id": 1332414111522783232,
    "task_name":"testtask_name111",
    "task_remark":"testtask_remark111",
    "push_time": 1589010582,
    "openid":[
        "yyyyyyyy"
    ],
    "material": [
        {
            "type":1,
            "word":"testword"
        },
        {
            "type":3,
            "media_id": "xxxxxxxxxxxxxx"
        },
        {
            "type":49,
            "media_id": "xxxxxxxxxxxxxx",
            "title":"test_title",
            "path":"page/index/index",
            "appid":"wxzzzzzzzzzzzz"
        }
    ]
}

返回数据示例

{
  "errcode": 0,
  "errmsg": "ok"
}