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