From 3f94f67e6fe4106df1519071b0051f364dc32029 Mon Sep 17 00:00:00 2001
From: Rucheng Tang <tangrucheng@gmail.com>
Date: Sat, 19 Dec 2015 13:28:21 +0800
Subject: [PATCH] =?UTF-8?q?=E7=BE=A4=E5=8F=91=E6=B6=88=E6=81=AF=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 群发消息.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 群发消息.md

diff --git a/群发消息.md b/群发消息.md
new file mode 100644
index 0000000..1cbf549
--- /dev/null
+++ b/群发消息.md
@@ -0,0 +1,38 @@
+微信的群发消息接口有各种乱七八糟的注意事项及限制，具体请阅读微信官方文档：http://mp.weixin.qq.com/wiki/15/5380a4e6f02f2ffdc7981a8ed7a40753.html
+
+本 SDK 由 `Overtrue\Wechat\Broadcast` 提供微信群发相关服务。
+
+### 获取实例
+
+```php
+<?php
+
+use Overtrue\Wechat\Broadcast;
+
+$appId  = 'wx3cf0f39249eb0e60';
+$secret = 'f1c242f4f28f735d4687abb469072a29';
+
+$broadcast = new Broadcast($appId, $secret);
+```
+
+### API
+
++ `$broadcast->send($message)->to();` 群发消息给所有粉丝
++ `$broadcast->send($message)->to($groupId);` 群发消息给指定组
++ `$broadcast->send($message)->to(array($openId1, $openId2));` 群发消息给指定用户，可以是一个用户，也可以使多个用户，但必须是数组
++ `$broadcast->send($message)->preview($groupId);` 发送预览群发消息给指定的openid用户
++ `$broadcast->send($message)->preview($wxname, Broadcast::PREVIEW_BY_WXH);` 发送预览群发消息给指定的微信号用户
++ `$broadcast->delete($msgId);` 删除群发消息
++ `$broadcast->status($msgId);` 查询群发消息发送状态
+
+这里的 `$message` 可以是：
+
++ `$message = Message::make('mp_news')->media_id('123dsdajkasd231jhksad');` 图文
++ `$message = Message::make('text')->content('CONTENT');` 文本
++ `$message = Message::make('voice')->media_id('123dsdajkasd231jhksad');` 语音
++ `$message = Message::make('image')->media_id('123dsdajkasd231jhksad');` 图片
++ `$message = Message::make('mp_video')->media_id('IhdaAQXuvJtGzwwc0abfXnzeezfO0NgPK6AQYShD8RQYMTtfzbLdBIQkQziv2XJc');` 群发视频消息给组或预览群发视频消息给用户
++ `$message = Message::make('video')->media_id('123dsdajkasd231jhksad')->title('TITLE')->description('DESCRIPTION');` 群发视频消息给指定用户
++ `$message = Message::make('wxcard')->card_id('123dsdajkasd231jhksad');` 卡券
+
+有关群发信息的更多细节请参考微信官方文档：http://mp.weixin.qq.com/wiki/15/5380a4e6f02f2ffdc7981a8ed7a40753.html