ユーザーが公式アカウントにメッセージを送信するとき (または、特定のユーザー操作によってイベントがプッシュされるとき)、POST リクエストが生成され、開発者は、応答パッケージ (Get) 、メッセージに応答します (応答テキスト、画像、グラフィックス、音声、ビデオ、音楽をサポートするようになりました)。厳密に言えば、受動的応答メッセージの送信は実際にはインターフェイスではなく、WeChat サーバーによって送信されたメッセージに対する応答です。
WeChat サーバーがユーザーのメッセージを公式アカウントの開発者サーバー アドレス (開発者センターで構成) に送信した後、WeChat サーバーが 5 秒以内に応答を受信しない場合、接続が切断され、リクエストが再開始されます。合計 3 回の再試行が行われます。デバッグ中にユーザーが応答メッセージを受信できないことが判明した場合は、メッセージ処理がタイムアウトしたかどうかを確認できます。再試行メッセージの重複排除に関しては、msgid を使用してメッセージを重複排除することをお勧めします。重複を排除するために、イベント タイプのメッセージには FromUserName + CreateTime を使用することをお勧めします。
開発者がセキュリティを強化したい場合は、デベロッパー センターでメッセージの暗号化を有効にすることができます。これにより、ユーザーが公式アカウントに送信したメッセージと、公式アカウントからのユーザー メッセージに対する受動的な返信は引き続き暗号化されます。詳細については、パッシブ返信メッセージ暗号化復号化手順を参照してください。
サーバーが 5 秒以内に処理して返信することを保証できない場合は、WeChat サーバーが何もせず、再試行を開始しないように、次の返信を行う必要があります (この場合、カスタマー サービスを使用できます)メッセージ インターフェイスは非同期応答を実行します）、そうでない場合は、重大なエラー メッセージが表示されます。詳細については、以下の手順を参照してください:
1. 成功に直接応答する (推奨される方法) 2. 空の文字列に直接応答する (XML 構造内の空のコンテンツ フィールドではなく、バイト長 0 の空の文字列を参照する) |
次の状況が発生すると、WeChat は公開アカウント セッションでユーザーに「この公開アカウントは一時的にサービスを提供できません。後でもう一度お試しください」というシステム プロンプトを発行します:
| 1 . 開発者 5 秒以内にコンテンツが返信されませんでした 2. 開発者が JSON データなどの異常なデータを返信しました |
また、写真などのマルチメディアメッセージに返信する場合は、事前に素材管理インターフェースを通じて一時素材をWeChatサーバーにアップロードする必要があることにご注意ください。一時素材は素材管理で使用することも、永久素材を使用することもできます。
テキストメッセージに返信
<xml> <ToUserName><![CDATA [toUser]]></ToUserName> <FromUserName> lt;! CDATA [fromUser]]></FromUserName> <CreateTime>12345678</CreateTime> <MsgType><![CDATA[text]]></MsgType> <Content& g t; <![CDATA[Hello]]></Content> </xml> |
| パラメータ | は必須ですか? | の説明 |
|---|
| ToUserName | は | 受信者アカウント(受信したOpenID)です |
| From UserName | は、 | 開発者の WeChat アカウント |
です。 | CreateTime | は | メッセージ作成時間(整数)です |
| MsgType | は | text |
| Content | は返信のメッセージコンテンツです(改行:コンテンツ内)回線変更機能、WeChat クライアントは行の折り返し表示をサポートしています) | |
画像メッセージに返信
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<Image>
<MediaId><![CDATA[media_id]]></MediaId>
</Image>
</xml> |
| パラメータ | は必須ですか? | 説明 |
|---|
| ToUserName | は | 受信者アカウント(受信したOpenID)です |
| From UserName | は | 開発者の WeChat アカウント |
です| CreateTime | は | メッセージ作成時間(整数)です |
| MsgType | は | image |
| MediaId | は | を通してマテリアルです管理インターフェイスはマルチメディア ファイルをアップロードし、ID を取得します。 |
ボイスメッセージに返信
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<Voice>
<MediaId><![CDATA[media_id]]></MediaId>
</Voice>
</xml> |
| パラメータ | は必須ですか? | 説明 |
|---|
| ToUserName | は | 受信者アカウント(受信したOpenID)です |
| From UserName | は | 開発者の WeChat アカウント |
です| CreateTime | は | メッセージ作成タイムスタンプ(整数)です |
| MsgType | は | voice、voice |
| MediaId | は | を通じてアップロードされました素材管理マルチメディア ファイルのインターフェイス、ID を取得します |
ビデオメッセージに返信
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<Video>
<MediaId><![CDATA[media_id]]></MediaId>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
</Video>
</xml> |
| パラメータ | は必須ですか? | 説明 |
|---|
| ToUserName | は | 受信者アカウント(OpenIDを受信しました) |
| FromUserName | は | WeChat IDを開発しました |
| CreateTime | は | メッセージ作成時刻 (整数) |
| MsgType | は | video |
| MediaId | は | 素材管理のインターフェイスを通じてマルチメディア ファイルをアップロードし、ID を取得します |
| タイトル | いいえ | ビデオメッセージのタイトル |
| 説明 | いいえ | ビデオメッセージの説明 |
音楽メッセージに返信
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[music]]></MsgType>
<Music>
<Title><![CDATA[TITLE]]></Title>
<Description><![CDATA[DESCRIPTION]]></Description>
<MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
<HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
<ThumbMediaId><![CDATA[media_id]]></ThumbMediaId>
</Music>
</xml> |
| パラメータ | は必須ですか? | 説明 |
|---|
| ToUserName | は | 受信者アカウント(OpenIDを受信しました) |
| FromUserName | は | WeChat IDを開発しました |
| CreateTime | はい | メッセージ作成時刻 (整数) |
| MsgType | はい | 音楽 |
| タイトル | いいえ | 音楽タイトル |
| 説明 | いいえ | 音楽の説明 |
| 音楽URL | いいえ | 音楽リンク |
| HQMusicUrl | いいえ | 高品質の音楽リンク、WIFI環境では、このリンクを使用して音楽を再生することが優先されます |
| ThumbMediaId | は | サムネイルのメディアIDであり、マテリアルのインターフェースを通じてマルチメディアファイルをアップロードします管理者に問い合わせてIDを取得してください |
テキストメッセージに返信してください
<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>12345678</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<ArticleCount>2</ArticleCount>
<Articles>
<item>
<Title><![CDATA[title1]]></Title>
<Description><![CDATA[description1]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
<item>
<Title><![CDATA[title]]></Title>
<Description><![CDATA[description]]></Description>
<PicUrl><![CDATA[picurl]]></PicUrl>
<Url><![CDATA[url]]></Url>
</item>
</Articles>
</xml> |
| パラメータ | は必須ですか? | 説明 |
|---|
| ToUserName | は | 受信者アカウント(OpenIDを受信しました) |
| FromUserName | は | WeChat IDを開発しました |
| CreateTime | は | メッセージ作成時間 (整数) |
| MsgType | は | ニュース |
| ArticleCount | は | グラフィックおよびテキストメッセージの数、10 に制限されています |
| 記事 | はい | 複数の画像とテキストメッセージ。デフォルトの最初の項目は大きな画像です。画像とテキストの数が 10 を超える場合は応答がありませんのでご注意ください。 |
| タイトル | いいえ | 写真とテキストメッセージのタイトル |
| 説明 | いいえ | 写真とテキストメッセージの説明 |
| PicUrl | いいえ | 写真のリンク、JPGをサポートPNG形式、より良い効果は大きい画像は360*200、小さい画像は200*200です |
| URL | いいえ | 画像とテキストメッセージをクリックするとリンクにジャンプします |
