PHP Class PFinal\Wechat\Service\MessageService

Inheritance: extends BaseService

ファイルを表示 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 )