# 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
}