この記事では、主に WeChat パブリック プラットフォームでのマス メッセージングの開発について説明します。詳細な情報は、WeChat パブリック プラットフォームでのマス メッセージングのプロセスを説明するためにまとめられています。
1. WeChatパブリックアカウントで完了 グループメッセージを送信します。ここで簡単なテキスト送信を完了するだけです。音声画像なども送信できますが、データ形式が異なります。データタイプのデータ送信形式を問い合わせるには、以下のリンクがあります。
2. グループテキストメッセージを送信するプロセス
テスト公開アカウントを取得します(アカウントをお持ちの方はテストアカウントは必要ありませんが、公式アカウントにはさらに制限があります)
1)、パブリック テスト アカウント
上のリンクにアクセスして、「インターフェイス テスト アカウント アプリケーション」を選択します。 http://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index を直接開くことで取得できます。 . WeChat クライアントで QR コードをスキャンしてログインできます。 ログイン後、テスト公開アカウントの情報を取得できます。公式アカウントを一意に識別するパラメータは主にappIdとappsecretの2つで、ユーザーの情報を取得するためのパラメータとして使用する必要があります。 ,2) インターフェース情報の設定
このステップについては、WeChat のアクセス手順を参照してください。基本的には、カスタム TOKEN を変更して検証を行うだけです。ページ 自分のサーバーに置きます。ここでは、私が行っている例を示します。 準備リソース: ドメイン名 + スペース (私のものは SAE スペース + 10,000 のネットワーク ドメイン名)、および検証済みの PHP ファイルのみ A wx_sample.phpwx_sample.php<?php /** * wechat php test */ //define your token define("TOKEN", "weixin"); $wechatObj = new wechatCallbackapiTest(); $wechatObj->valid(); class wechatCallbackapiTest { public function valid() { $echoStr = $_GET["echostr"]; //valid signature , option if($this->checkSignature()){ echo $echoStr; exit; } } public function responseMsg() { //get post data, May be due to the different environments $postStr = $GLOBALS["HTTP_RAW_POST_DATA"]; //extract post data if (!empty($postStr)){ /* libxml_disable_entity_loader is to prevent XML eXternal Entity Injection, the best way is to check the validity of xml by yourself */ libxml_disable_entity_loader(true); $postObj = simplexml_load_string($postStr, ‘SimpleXMLElement‘, LIBXML_NOCDATA); $fromUsername = $postObj->FromUserName; $toUsername = $postObj->ToUserName; $keyword = trim($postObj->Content); $time = time(); $textTpl = "<xml> <ToUserName><![CDATA[%s]]></ToUserName> <FromUserName><![CDATA[%s]]></FromUserName> <CreateTime>%s</CreateTime> <MsgType><![CDATA[%s]]></MsgType> <Content><![CDATA[%s]]></Content> <FuncFlag>0</FuncFlag> </xml>"; if(!empty( $keyword )) { $msgType = "text"; $contentStr = "Welcome to wechat world!"; $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr); echo $resultStr; }else{ echo "Input something..."; } }else { echo ""; exit; } } private function checkSignature() { // you must define TOKEN by yourself if (!defined("TOKEN")) { throw new Exception(‘TOKEN is not defined!‘); } $signature = $_GET["signature"]; $timestamp = $_GET["timestamp"]; $nonce = $_GET["nonce"]; $token = TOKEN; $tmpArr = array($token, $timestamp, $nonce); // use SORT_STRING rule sort($tmpArr, SORT_STRING); $tmpStr = implode( $tmpArr ); $tmpStr = sha1( $tmpStr ); if( $tmpStr == $signature ){ return true; }else{ return false; } } } ?>
その後、送信するだけです
プロンプトが失敗した場合は、トークンと URL を確認してください [独自のドメイン名とスペースの場合は、Baidu sae と Sina sae が自分で申請して認証を受ける必要があります (つまり、ID を持っている自分の写真を撮ってアップロードします)。 、非常に簡単で、最短 2 日で完了できます o)、このステップは必要です】
3) JS インターフェイスのセキュリティ ドメイン名を設定します
このドメイン名を入力するときは、プロトコルを含めないように注意してください。例 http://www.sagosoft.com/; 間違っています、これは URL であり、ドメイン名ではありません ドメイン名は www.sagosoft.com のようにする必要があります [そうしないと、無効な URL ドメインが表示されます。 WeChat js-sdk へのアクセス]4) 公開アカウントをフォローする
ユーザーがこの公式アカウントをフォローしている場合にのみ、公式アカウント情報とのリンクを開いて第三者がログインしてユーザー情報を取得することを許可できます。したがって、WeChat ID をフォローするためにも WeChat を使用する必要があります。 操作は次のとおりです。
ログインに成功した後、ページに QR コードがあることがわかります。フォローに成功すると、右側の「ユーザーリスト」にもう1人のユーザーの情報が表示されます。以下の図に示すように:
5) コールバック関数を構成します
WeChat クライアントでサードパーティの Web ページ (つまり、独自の Web ページ) にアクセスすると、WeChat Web ページを使用できます。取得した appid と appsecret には、認証メカニズムだけでなく、ユーザーが認証した後のコールバック、つまりユーザーが認証した後にページがジャンプする場所のドメイン名も設定する必要があります。具体的な設定は次のとおりです。
先ほどのページに「基本的なユーザー情報を取得する Web ページの承認」があるので、後ろの変更をクリックします
コールバック ドメイン名を入力します:
ドメイン名は、上記の「インターフェイス構成情報」に入力した URL が zcr.sinaaappc.com/wx_sample.php である場合、入力する必要があるのは、上で設定したルート ドメイン名だけです。ここのzcr.sinaaappc.comで。
URL がブラックリストに登録されていない場合は、上部に表示されます
注:
1. ここに入力するのはドメイン名 (文字列) です。 URL なので、http:// などのプロトコル ヘッダーを追加しないでください。
2. 認証コールバック ドメイン名の構成仕様は、Web ページの認証が必要なドメイン名です。たとえば、www.qq.com です。設定後、このドメイン名のページは http://www.qq.com/music.html と http://www.qq.com/login.html の両方で OAuth2.0 認証を実行できます。ただし、ttp://pay.qq.com、http://music.qq.com、http://qq.comはOAuth2.0認証を行うことができません
この時点で公開アカウントのテストアカウントの取得は完了です設定してユーザーが WeChat 公式アカウントをフォローしていることを確認します。
4. appid と appsecret を通じて access_token を取得します
Access_token は、公式アカウントのグローバルに固有のチケットであり、公式アカウントは各インターフェースを呼び出すときに access_token を使用する必要があります。開発者はそれを適切に保存する必要があります。 access_token ストレージ用に少なくとも 512 文字のスペースを予約する必要があります。 access_token の有効期間は現在 2 時間であり、定期的に取得を繰り返すと最後の access_token が無効になります。
Getメソッド:
httpリクエストメソッド: GET
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
パラメータの説明
パラメーター | は必須ですか? | 説明 |
---|---|---|
grant_type | Yes | Get access_token client_credential を入力します |
appid | Yes | サードパーティ ユーザーの唯一の認証情報 |
秘密 | は | サードパーティ ユーザーです 固有の資格情報キー、つまり appsecret です |
返送手順
通常の状況では、WeChat は次の JSON データ パケットを公式アカウントに返します:
{"access_token":" ACCESS_TOKEN","expires_in":7200}
Parameter | Description |
---|---|
access_token | 取得したバウチャー |
expires_in | クーポンの有効時間、単位: 秒 |
错误时微信会返回错误码等信息,JSON数据包示例如下(该示例为AppID无效错误):
{"errcode":40013,"errmsg":"invalid appid"}
例子:
获取access_token:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wx41cb8dbd827a16e9&secret=d4624c36b6795d1d99dcf0547af5443d
返回数据:
{ "access_token": "qR5UK2vMf5aTHV8e-uB10FZW0caTZm_1kbkUe4OPK2ILVvNaoa7pLzYWqLUAmx6Sjq1E7pKHrVAtuG0_1MPkqmDfOkm2750kaLWNk59DS-iDOpjjxompJtXa3WhbN5FKRWNhADAVAR", "expires_in": 7200 }
5、通过access_token群发短信
在公众平台网站上,为订阅号提供了每天一条的群发权限,为服务号提供每月(自然月)4条的群发权限。而对于某些具备开发能力的公众号运营者,可以通过高级群发接口,实现更灵活的群发能力。
请注意:
1、对于认证订阅号,群发接口每天可成功调用1次,此次群发可选择发送给全部用户或某个分组;
2、对于认证服务号虽然开发者使用高级群发接口的每日调用限制为100次,但是用户每月只能接收4条,无论在公众平台网站上,还是使用接口群发,用户每月只能接收4条群发消息,多于4条的群发将对该用户发送失败;
3、具备微信支付权限的公众号,在使用群发接口上传、群发图文消息类型时,可使用标签加入外链;
4、开发者可以使用预览接口校对消息样式和排版,通过预览接口可发送编辑好的消息给指定用户校验效果。
1)根据分组进行群发【订阅号与服务号认证后均可用】
调用接口:
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=ACCESS_TOKEN 在body添加如下数据(以JSON格式数据发送)——发送其他格式数据,只需要改里面参数信息即可,具体可查看微信官方文档:
{ "filter":{ "is_to_all":false, "group_id":2 }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
filter | 是 | 用于设定图文消息的接收者 |
is_to_all | 否 | 用于设定是否向全部用户发送,值为true或false,选择true该消息群发给所有用户,选择false可根据group_id发送给指定群组的用户 |
group_id | 否 | 群发到的分组的group_id,参加用户管理中用户分组接口,若is_to_all值为true,可不填写group_id |
mpnews | 是 | 用于设定即将发送的图文消息 |
media_id | 是 | 用于群发的消息的media_id |
msgtype | 是 | 群发的消息类型,图文消息为mpnews,文本消息为text,语音为voice,音乐为music,图片为image,视频为video,卡券为wxcard |
title | 否 | 消息的标题 |
description | 否 | 消息的描述 |
thumb_media_id | 是 | 视频缩略图的媒体ID |
例子:发送给所有人
url:
https://api.weixin.qq.com/cgi-bin/message/mass/sendall?access_token=KBoNONaJZ4-KhafQVJoQ6VBX0F-bls7nAsJBn8Fy7GLwav4Be1lRJcob1RHH6wW35IxxFwkJnZfnc-On9EQITg3oxEWUw7O2YyVW9naDknu6PQX9fnSmQcr8ojTK8Ug-HDTcAAABXN
发送的json数据:发送给所有人
{ "filter":{ "is_to_all":true }, "text":{ "content":"CONTENT" }, "msgtype":"text" }
返回数据:
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 1000000003 }
参数意义:
参数 | 说明 |
---|---|
type | 媒体文件类型,分别有图片(image)、语音(voice)、视频(video)和缩略图(thumb),图文消息为news |
errcode | 错误码 |
errmsg | 错误信息 |
msg_id | 消息发送任务的ID |
msg_data_id | 消息的数据ID,该字段只有在群发图文消息时,才会出现。可以用于在图文分析数据接口中,获取到对应的图文消息的数据,是图文分析数据接口中的msgid字段中的前半部分,详见图文分析数据接口中的msgid字段的介绍。 |
错误码及其以及查询:
使用postman模拟https请求发送如下图所示:
2)根据OpenID列表群发【订阅号不可用,服务号认证后可用】
发送的http请求url:(注意:和上面的不同)
http请求方式: POST
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=ACCESS_TOKEN
数据格式:
{ "touser":[ "OPENID1", "OPENID2" ], "msgtype": "text", "text": { "content": "hello from boxer."} }
其中 OPENID1和OPENID2是我们要发送的微信用户openId(用户的唯一标示)。
例子:
发送"oF3PcsnsrMiJzEwalZZbAfWQpxCI","oF3PcshH1CUIhR_WYau6swUiPzlw" 两个用户。
内容为:hello from boxer.欢迎来到百度
url:
https://api.weixin.qq.com/cgi-bin/message/mass/send?access_token=wRyTbnsiu18ssEhMPLf4bDfeT-Bt6e6tgR4CQGVLBipRcyJPkdAKPYfM6-qkKuHUN8uRKJh6Xvm0OuAdFgqOo8Ru8hoDxl-cGc9bh-ezJb2ZUcJSnQk2s416zI8kbEOfOGYdAFARJB
json数据:
{ "touser":[ "oF3PcsnsrMiJzEwalZZbAfWQpxCI", "oF3PcshH1CUIhR_WYau6swUiPzlw" ], "msgtype": "text", "text": { "content": "hello from boxer.<a href=‘http://www.php.cn/‘>欢迎希沃学院</a>"} }
返回数据:
{ "errcode": 0, "errmsg": "send job submission success", "msg_id": 3147483654 }
使用postman模拟发送请求如下:
微信号接收到的内容:
更多WeChat パブリック プラットフォームの開発 - グループ メッセージング相关文章请关注PHP中文网!