1、群发预览接口
群发消息前,可以使用预览接口进行群发预览,群发预览只会发送至指定微信用户的微信上(已关注),群发的内容只能短暂性有效,逾期将失效。
调用方法:
weixin::wx_material_preview()
相关参数:
共3个必要参数,3个可选参数,具体如下:
1、群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为mpvideo,卡券为wxcard,必选
2、用于群发的消息的腾讯素材id,必选
3、预览的者微信号/QQ号/手机号,必选
4、图文消息被判定为转载时,是否继续群发。 1为继续群发(转载),0为停止群发。 该参数默认为0,可选
5、消息的标题,可选
6、消息的描述,可选
调用实例:
$result = weixin::wx_material_preview('mpnews','abc','wxkyger');
返回结果:
错误码:$result['errcode']
错误信息:$result['errmsg']
消息ID:$result['msg_id']
2、根据标签进行群发
调用方法:
weixin::wx_material_send_by_tagid()
相关参数:
共7个参数,具体如下:
1、群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为mpvideo,卡券为wxcard,必选
2、用于群发的消息的腾讯素材id,必选
3、群发到的标签的tag_id,参见用户管理中用户分组接口,若向所有用户群发,可不填写tag_id,必选
4、用于设定是否向全部用户发送,值为true或false,选择true该消息群发给所有用户,选择false可根据tag_id发送给指定群组的用户,可选
5、图文消息被判定为转载时,是否继续群发。 1为继续群发(转载),0为停止群发。 该参数默认为0,可选
6、消息的标题,可选
7、消息的描述,可选
调用实例:
1、群发给带”tag_guangdong“标签的粉丝
$result = weixin::wx_material_send_by_tagid('mpnews','abc','tag_guangdong');
2、群发给所有粉丝
$result = weixin::wx_material_send_by_tagid('mpnews','abc','',true);
返回结果:
错误码:$result['errcode']
错误信息:$result['errmsg']
媒体文件类型:$result['type'] 图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为news
消息发送任务的ID:$result['msg_id']
消息的数据ID:$result['msg_data_id'] 该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍
3、根据OpenID列表群发
调用方法:
weixin::wx_material_send_by_openid()
相关参数:
共3个必要参数,3个可选参数,具体如下:
1、群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为mpvideo,卡券为wxcard,必选
2、用于群发的消息的腾讯素材id,必选
3、填写图文消息的接收者,OpenID数组,OpenID最少2个,最多10000个,必选
4、图文消息被判定为转载时,是否继续群发。 1为继续群发(转载),0为停止群发。 该参数默认为0,可选
5、消息的标题,可选
6、消息的描述,可选
调用实例:
$openid = array('abc','def','ghi');
$result = weixin::wx_material_send_by_openid('mpnews','mediakyger',$openid);
$result = weixin::wx_material_send_by_openid('mpnews','mediakyger',$openid);
返回结果:
错误码:$result['errcode']
错误信息:$result['errmsg']
媒体文件类型:$result['type'] 图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为news
消息发送任务的ID:$result['msg_id']
消息的数据ID:$result['msg_data_id'] 该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍
4、删除群发
调用方法:
weixin::wx_material_send_del()
相关参数:
共2个参数,具体如下:
1、群发任务id
2、要删除的文章在图文消息中的位置,第一篇编号为1,该字段不填或填0会删除全部文章
调用实例:
1、删除群发任务id为“task_demo”的所有内容
$result = weixin::wx_material_send_del('task_demo');
2、删除群发任务id为“task_demo1”的第二篇图文
weixin::wx_material_send_del('task_demo1',2);
返回结果:
错误码:$result['errcode']
错误信息:$result['errmsg']