shopping-guide.getGuideMassendJobList

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

获取群发任务列表

请求地址

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

请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
guide_account string 顾问微信号,guide_account和guide_openid二选一
guide_openid string 顾问openid或者unionid,guide_account和guide_openid二选一
task_status Array.<number> 任务状态,为空则表示拉取所有状态
offset number 0 偏移位置
limit number 50 条数

task_status定义

属性 说明
1 任务未执行
2 已执行
3 执行完成
4 任务取消

返回值

Object

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
list Array.<Object> 群发任务列表
total_count number 总任务数

list的结构

属性 类型 说明
task_id number 任务id
guide_openid string 顾问openid
create_time number 任务创建时间
update_time number 任务最后修改时间
push_time number 任务下发时间
finish_time number 任务完成时间
task_name string 任务名称
task_remark string 任务备注
task_status number 任务状态
material Array.<Object> 素材
buyer_info Array.<Object> 粉丝列表

material的结构

属性 类型 说明
type number 素材类型,1.文本,3.图片,49.小程序卡片
title string 小程序卡片标题
path string 小程序卡片路径
appid string 小程序卡片appid,需要关联到公众号
word string 文本类型素材的内容,不超过10240字节
pic_url string 图片url

buyer_info结构

属性 类型 说明
openid string 粉丝openid
send_status number 消息发送状态

send_status定义

属性 说明
1 未发送
2 发送成功
3 未关注公众号
4 没有quota
5 系统错误

errcode 的合法值

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

请求数据示例

{
    "guide_account": "xxxxxxxx",
    "offset":0,
    "limit":1
}

返回数据示例

{
    "errcode": 0,
    "errmsg": "OK",
    "list": [
        {
            "task_id": 1332519773019865088,
            "create_time": 1589016638,
            "update_time": 1589016638,
            "push_time": 1589010582,
            "finish_time": 0,
            "task_name": "testtask_name111",
            "task_remark": "testtask_remark111",
            "material": [
                {
                    "type": 1,
                    "word": "testword"
                },
                {
                    "type": 3,
                    "pic_url": "http://mmbiz.qpic.cn/mmbiz_png/pHhTMtqk90rHY17p2cOXN9uhxMLpugicrGmYpljlNuoMbEjDib1S1nAcib3CC4qHOBqHtlOPYGP6OCuQpL5NDyUUA/0"
                },
                {
                    "type": 49,
                    "title": "test_title",
                    "path": "",
                    "appid": "xxxxxxxx",
                    "pic_url": "http://mmbiz.qpic.cn/mmbiz_png/pHhTMtqk90rHY17p2cOXN9uhxMLpugicrGmYpljlNuoMbEjDib1S1nAcib3CC4qHOBqHtlOPYGP6OCuQpL5NDyUUA/0"
                }
            ],
            "buyer_info": [
                {
                    "openid": "xxxxxxxxxx",
                    "send_status": 1
                }
            ],
            "task_status": 1
        }
    ],
    "total_count": 4
}