PHP Class PFinal\Wechat\Service\MessageService

Inheritance: extends BaseService
Exibir arquivo Open project: pfinal/wechat Class Usage Examples

Public Methods

Method Description
delete ( $msgId ) : array 删除群发
previewWithOpenid ( $openid, PFinal\Wechat\Contract\MassMessage $message ) : array 预览(发给某个openid)
previewWithWxname ( $wxname, PFinal\Wechat\Contract\MassMessage $message ) : array 预览(发给某个微信号)
send ( $openid, PFinal\Wechat\Contract\SendMessage $message, null $account = null ) : array 客服消息接口,主动给粉丝发消息。当用户和公众号产生特定动作的交互的48小时内有效。
sendAll ( integer $groupId, PFinal\Wechat\Contract\MassMessage $message, boolean $is_to_all = false ) : array 高级群发 根据分组进行群发 【订阅号与服务号认证后均可用】 对于认证订阅号,群发接口每天可成功调用1次,此次群发可选择发送给全部用户或某个分组; 对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次,但是用户每月只能接收4条,无论在公众平台网站上, 还是使用接口群发,用户每月只能接收4条群发消息,多于4条的群发将对该用户发送失败; 具备微信支付权限的公众号,在使用群发接口上传、群发图文消息类型时,可使用标签加入外链; 可以使用预览接口校对消息样式和排版,通过预览接口可发送编辑好的消息给指定用户校验效果。
sendAllWithOpenids ( array $openids, PFinal\Wechat\Contract\MassMessage $message ) : array 根据OpenID列表群发
status ( $msgId ) : array 查询群发消息发送状态
template ( string $openid, string $templateId, array $data, string $url = '', string $topColor = '#FF0000', string $defaultItemColor = '#173177' ) : array 发送模板消息

Method Details

delete() public static method

删除群发
public static delete ( $msgId ) : array
$msgId
return array

previewWithOpenid() public static method

预览(发给某个openid)
public static previewWithOpenid ( $openid, PFinal\Wechat\Contract\MassMessage $message ) : array
$openid
$message PFinal\Wechat\Contract\MassMessage
return array

previewWithWxname() public static method

预览(发给某个微信号)
public static previewWithWxname ( $wxname, PFinal\Wechat\Contract\MassMessage $message ) : array
$wxname
$message PFinal\Wechat\Contract\MassMessage
return array

send() public static method

客服消息接口,主动给粉丝发消息。当用户和公众号产生特定动作的交互的48小时内有效。
public static send ( $openid, PFinal\Wechat\Contract\SendMessage $message, null $account = null ) : array
$openid
$message PFinal\Wechat\Contract\SendMessage
$account null 客服帐号(显示客服自定义头像)
return array

sendAll() public static method

关于群发时使用is_to_all为true使其进入公众号在微信客户端的历史消息列表: 1、使用is_to_all为true且成功群发,会使得此次群发进入历史消息列表。2、为防止异常,认证订阅号在一天内,只能使用is_to_all为true进行群发一次,或者在公众平台官网群发(不管本次群发是对全体还是对某个分组)一次。以避免一天内有2条群发进入历史消息列表。 3、类似地,服务号在一个月内,使用is_to_all为true群发的次数,加上公众平台官网群发(不管本次群发是对全体还是对某个分组)的次数,最多只能是4次。 4、设置is_to_all为false时是可以多次群发的,但每个用户只会收到最多4条,且这些群发不会进入历史消息列表。
public static sendAll ( integer $groupId, PFinal\Wechat\Contract\MassMessage $message, boolean $is_to_all = false ) : array
$groupId integer
$message PFinal\Wechat\Contract\MassMessage
$is_to_all boolean
return array

sendAllWithOpenids() public static method

根据OpenID列表群发
public static sendAllWithOpenids ( array $openids, PFinal\Wechat\Contract\MassMessage $message ) : array
$openids array OpenID最少2个,最多10000个
$message PFinal\Wechat\Contract\MassMessage
return array

status() public static method

查询群发消息发送状态
public static status ( $msgId ) : array
$msgId
return array

template() public static method

发送模板消息
public static template ( string $openid, string $templateId, array $data, string $url = '', string $topColor = '#FF0000', string $defaultItemColor = '#173177' ) : array
$openid string
$templateId string 模板ID
$data array 详细内容 比如:保养过期通知 详细内容如下: {{first.DATA}} 保养到期时间:{{keynote1.DATA}} 上次保养时间:{{keynote2.DATA}} 上次保养里程:{{keynote3.DATA}} {{remark.DATA}} 对应data数据为: $data = array( 'first' => '尊敬的车主,您的爱车保养以过期' 'keynote1'=> '2014年12月12日', 'keynote2'=> '2013年12月12日', 'keynote3'=> '555KM', 'remark'=> '点击保养,惊喜不断!', ); 如果需要指定每项颜色: $data = array( 'first' => array( 'value' => '尊敬的车主,您的爱车保养以过期' 'color' => '#FC5C48' ), 'keynote1' => array( 'value' => '2014年12月12日' 'color' => '#173177' ), 'keynote2' => array( 'value' => '2014年12月12日' 'color' => '#173177' ), 'keynote3' => array( 'value' => '2013年12月12日' 'color' => '#173177' ), 'remark' => array( 'value' => '点击保养,惊喜不断!' 'color' => '#173177' ), );
$url string
$topColor string
$defaultItemColor string
return array array( 'errcode' => int 0 'errmsg' => string 'ok' (length=2) 'msgid' => int 413100638 )