イベントプッシュを受信する
イベントプッシュを受け取る
WeChatユーザーと公式アカウント間のやり取りの過程で、ユーザーの特定の操作により、WeChatサーバーはイベントプッシュを通じて開発者センターに設定されているサーバーアドレスを開発者に通知し、開発者が取得できるようにします。この情報に。その中には、プッシュ イベントの発生後に開発者がユーザーに返信できるものと、そうでないものがあります。詳細については、このページの最後にある WeChat プッシュ メッセージとイベントの説明を参照してください。
フォロー/フォロー解除イベント
ユーザーが公式アカウントをフォローまたはフォロー解除すると、WeChat は開発者が入力した URL にこのイベントをプッシュします。開発者にとって、ユーザーにウェルカム メッセージを送信したり、アカウントのバインドを解除したりするのに便利です。
WeChat サーバーが 5 秒以内に応答を受信しない場合、接続を切断してリクエストを再開始し、合計 3 回再試行します。
リトライメッセージの重複に関しては、FromUserName + CreateTime を使用してメッセージを重複排除することをお勧めします。
サーバーが 5 秒以内に処理して返信することを保証できない場合は、空の文字列で直接返信できます。WeChat サーバーはこれに対して何もせず、再試行も開始しません。
プッシュ XML パケットの例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[subscribe]]></Event> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、イベント |
| Event | イベントタイプ、subscribe(購読)、unsubscribe(購読キャンセル) |
Web デバッグ ツールを使用してこのインターフェイスをデバッグします
パラメータを使用して QR コード イベントをスキャンします
ユーザーがシーン値を使用して QR コードをスキャンすると、次の 2 つのイベントがプッシュされる可能性があります:
ユーザーが公式アカウントをフォローしていない場合、ユーザーは公式アカウントをフォローすると、WeChat はシーン値を含む次のイベントを開発者にプッシュします。
ユーザーが公式アカウントをフォローしている場合、WeChat はシーン値を含むスキャン イベントを開発者にプッシュします。
1. ユーザーがフォローしていない場合、ユーザーをフォローした後にイベントをプッシュします
Push XML データ パッケージの例:
<xml><ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[subscribe]]></Event> <EventKey><![CDATA[qrscene_123123]]></EventKey> <Ticket><![CDATA[TICKET]]></Ticket> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、event |
| Event | イベントタイプ、subscribe |
| EventKey | イベントKEY値、qrscene_はプレフィックスであり、その後にQRコードのパラメータ値が続きます |
| チケット | QRコードチケットはQRコード画像と交換できます |
2. ユーザーがフォローしたときのイベントプッシュ
プッシュ XML パケットの例:
| <xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></ MsgType> <Event><![CDATA[SCAN]]></Event> <EventKey><![CDATA[SCENE_VALUE]]></EventKey> <Ticket>< ;![CDATA[チケット]]></チケット> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、event |
| Event | イベントタイプ、SCAN |
| EventKey | イベントKEY値は、QRコードQRを作成するときに使用される32ビットの符号なし整数です。 code scene_id |
| チケット | QRコードのチケットでQRコード画像と交換できます |
Web デバッグ ツールを使用してインターフェイスをデバッグします
地理的位置イベントを報告します
ユーザーが地理的位置を報告することに同意した後、公式アカウント セッションに入るたびに、地理的位置はセッション開始時に報告されます、またはセッションに入ってから 5 秒ごと 地理的位置は 1 秒に 1 回報告され、パブリック アカウントはパブリック プラットフォーム Web サイトで上記の設定を変更できます。地理的位置を報告する場合、WeChat は報告された地理的位置イベントを開発者が入力した URL にプッシュします。
プッシュ XML パケットの例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[LOCATION]]></Event> <Latitude>23.137466</Latitude> <Longitude>113.352425</Longitude> <Precision>119.385040</Precision> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、イベント |
| イベント | イベントタイプ、LOCATION |
| 緯度 | 地理的位置 |
| 経度 | 地理的位置の経度 |
| 精度 | 地理位置情報精度 |
このインターフェイスをデバッグするには、Web デバッグ ツールを使用します
カスタム メニュー イベント
ユーザーがカスタム メニューをクリックすると、WeChat はクリック イベントを開発者にプッシュします。メニューをクリックすると、サブメニューがポップアップ表示され、レポートは生成されません。
メニューをクリックしてメッセージをプルするときのイベントプッシュ
プッシュXMLデータパッケージの例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[CLICK]]></Event> <EventKey><![CDATA[EVENTKEY]]></EventKey> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、event |
| Event | イベントタイプ、CLICK |
| EventKey | イベントKEY値、カスタムメニューインターフェースのKEY値に対応 |
Push XMLデータパッケージの例:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[FromUser]]></FromUserName> <CreateTime>123456789</CreateTime> <MsgType><![CDATA[event]]></MsgType> <Event><![CDATA[VIEW]]></Event> <EventKey><![CDATA[www.qq.com]]></EventKey> </xml> |
パラメータの説明:
| パラメータ | 説明 |
|---|---|
| ToUserName | 開発者WeChat ID |
| FromUserName | 送信者アカウント(OpenID) |
| CreateTime | メッセージ作成時間 (タイプ全体) |
| MsgType | メッセージタイプ、event |
| Event | イベントタイプ、VIEW |
| EventKey | イベントKEY値、ジャンプURLの設定 |
Web デバッグ ツールを使用するこのインターフェースをデバッグする
