通常のメッセージを受信する
通常のメッセージを受信する
一般の WeChat ユーザーが公開アカウントにメッセージを送信すると、WeChat サーバーは、開発者が入力した URL にメッセージの XML データ パケットを POST します。
ご注意ください:
1. メッセージの重複を再試行する場合は、msgid を使用してメッセージを重複排除することをお勧めします。
2. WeChat サーバーが 5 秒以内に応答を受信しない場合、接続は切断され、リクエストは合計 3 回再試行されます。サーバーが 5 秒以内に処理して応答することを保証できない場合、
は空の文字列で直接応答できます。これに対して WeChat サーバーは何もせず、再試行も開始しません。詳細については、「メッセージの送信 - メッセージへの受動的返信」を参照してください。
3. 開発者が 5 秒以内にユーザー メッセージに即時に応答する必要がある場合、つまり、「メッセージ送信 - パッシブ応答メッセージ」インターフェイスを使用してユーザーに受動的に応答する場合、
のデベロッパー センターで応答できます。パブリック プラットフォームの公式 Web サイト メッセージの暗号化を設定します。暗号化をオンにすると、ユーザーが送信したメッセージと開発者が返信したメッセージが暗号化されます (ただし、カスタマー サービス
インターフェイスなどの API 呼び出しを通じて開発者が送信したメッセージは影響を受けません)。メッセージの暗号化と復号化の詳細な手順については、「メッセージの送信 - パッシブ応答メッセージの暗号化と復号化の手順」を参照してください。
各メッセージ タイプのプッシュ XML パケット構造は次のとおりです:
テキスト メッセージ
<xml> |
Web デバッグ ツールを使用してこのインターフェイスをデバッグします
ピクチャー メッセージ
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1348831860</CreateTime> <MsgType><![CDATA[image]]></MsgType> <PicUrl><![CDATA[this is a url]]></PicUrl> <MediaId><![CDATA[media_id]]></MediaId> <MsgId>1234567890123456</MsgId> </xml> |
Web デバッグ ツールを使用してインターフェイスをデバッグします
音声メッセージ
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[voice]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <Format><![CDATA[Format]]></Format> <MsgId>1234567890123456</MsgId> </xml> |
お願いします音声アクティベーションが必要であることに注意してください。 認識後、ユーザーが公式アカウントに音声メッセージを送信するたびに、WeChat はプッシュされた音声メッセージ XML パケットに認識フィールドを追加します (注: クライアント キャッシュのため、開発者は、音声認識機能は、新しいフォロワーに影響します。開発者がこのアカウントをテストのために再フォローできるようになるまで、24 時間かかります。音声認識を有効にした後の音声 XML データ パケットは次のとおりです:
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[voice]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <Format><![CDATA[Format]]></Format> <Recognition><![CDATA[腾讯微信团队]]></Recognition> <MsgId>1234567890123456</MsgId> </xml> |
パラメータの説明:
ビデオメッセージ
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[video]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> <MsgId>1234567890123456</MsgId> </xml> |
Webデバッグツールを使用してインターフェイスをデバッグします
小さなビデオメッセージ
りー |
Web デバッグ ツールを使用してこのインターフェイスをデバッグします
地理位置情報メッセージ
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1357290913</CreateTime> <MsgType><![CDATA[shortvideo]]></MsgType> <MediaId><![CDATA[media_id]]></MediaId> <ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId> <MsgId>1234567890123456</MsgId> </xml> |
Web デバッグ ツールを使用してインターフェイスをデバッグします
リンク メッセージ
<xml> <ToUserName><![CDATA[toUser]]></ToUserName> <FromUserName><![CDATA[fromUser]]></FromUserName> <CreateTime>1351776360</CreateTime> <MsgType><![CDATA[location]]></MsgType> <Location_X>23.134521</Location_X> <Location_Y>113.358803</Location_Y> <Scale>20</Scale> <Label><![CDATA[位置信息]]></Label> <MsgId>1234567890123456</MsgId> </xml> |