# shopping-guide.addGuideMasssendJob

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

添加群发任务

为指定顾问添加群发任务

# 请求地址

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

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证
guide_account	string	是	顾问微信号（guide_account和guide_openid二选一）
guide_openid	string	是	顾问openid或者unionid（guide_account和guide_openid二选一）
task_name	string	是	群发任务名称,不超过16字
task_remark	string	否	群发任务备注,不超过100字
push_time	number	是	任务下发给顾问的时间, 秒级时间戳, 范围为当前时间开始到最近一个月内
openid	Array.<string>	是	客户openid列表
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	错误信息
task_result	Array.<Object>	群发任务列表

# task_result结构

属性	类型	说明
task_id	number	群发任务id
openid	Array.<string>	此任务包括的openid列表

errcode 的合法值

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

参数错误包含：task_name超长、task_remark超长、push_time超出范围、material超过 3 个、小程序素材appid和title非法等

# 请求数据示例

{
    "guide_account": "xxxxxxxx",
    "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",
  "task_result": [
  	"task_id": 1332519773019865088,
    "openid":[
      "xxxxxx",
      "yyyyyy"
  	]
  ]
}