shopping-guide.getGuideMassendJob

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

获取指定群发任务信息

请求地址

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

请求参数

属性 类型 默认值 必填 说明
access_token string 接口调用凭证
task_id number 任务id

返回值

Object

属性 类型 说明
errcode number 错误码
errmsg string 错误信息
job Object 群发任务

job的结构

属性 类型 说明
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 系统错误

task_status定义

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

errcode 的合法值

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

请求数据示例

{
    "task_id":1332414111522783232
}

返回数据示例

{
    "errcode": 0,
    "errmsg": "OK",
    "job": {
        "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
        }
}