カスタムメニュー作成インターフェース

カスタマイズされたメニューは、公式アカウントのインターフェースを強化し、ユーザーが公式アカウントの機能をより良く、より早く理解できるようにするのに役立ちます。カスタム メニューをオンにすると、公式アカウントのインターフェイスは次の図のようになります:

注意:

1 カスタム メニューには、最大 3 つの第 1 レベルのメニューと、各第 1 レベルのメニューを含めることができます。最大 5 つの 第 2 レベルのメニュー メニュー を含めることができます。
2. 第 1 レベルのメニューには最大 4 文字、第 2 レベルのメニューには最大 7 文字の中国語を含めることができます。余分な部分は「...」に置き換えられます。
3. カスタム メニューを作成した後、ユーザーが公式アカウントの会話ページまたは公式アカウントのプロフィール ページにアクセスしたときに、メニューを取得する最後のリクエストが 5 分前に見つかった場合、メニューが更新されます。メニューが 更新 されている場合、クライアントのメニューが更新されます。テストする場合は、公開アカウントのフォローを解除してから再度フォローしてみると、作成後の効果を確認できます。

カスタム メニュー インターフェイス は、次のように複数のタイプの ボタン を実装できます:

1. クリック: クリック プッシュ イベント ユーザーがクリック タイプ ボタンをクリックした後、WeChat サーバーはメッセージ タイプをプッシュします。イベントの構造は、メッセージ インターフェイスを通じて開発者に提供され (メッセージ インターフェイス ガイドを参照)、開発者がボタンに key 値を入力すると、開発者はカスタマイズされたキーを介してユーザーと対話できます。値;

2. ビュー: ジャンプ URL 転送ユーザーがビュー タイプ ボタンをクリックすると、WeChat クライアントは、開発者がボタンに入力した Web ページ URL を開きます。これは、Web ページ認証インターフェイスと組み合わせることができます。ユーザーの基本情報を取得する ユーザーの基本情報を取得します。

3. scancode_push: ユーザーがスキャン コード プッシュ イベントのボタンをクリックすると、WeChat クライアントはスキャン コード操作の完了後にスキャン ツールを起動します (URL の場合)。 URL が入力されます)、スキャンされたコードが表示され、コードの結果が開発者に渡され、開発者はメッセージを送信できます。

4. scancode_waitmsg: コードをスキャンしてイベントをプッシュし、ユーザーがボタンをクリックすると、コードのスキャン操作が完了すると、WeChat クライアントがスキャン ツールを起動します。スキャンコードの結果が開発者に送信され、同時にスキャンツールをしまうと、「メッセージ受信中」プロンプトボックスが表示され、開発者からメッセージを受け取ることがあります。

5. pic_sysphoto: ユーザーが写真を撮ってシステムに写真を送信するボタンをクリックすると、写真操作が完了すると、WeChat クライアントがシステム カメラを呼び出し、撮影した写真が開発者に送信されます。イベントは開発者にプッシュされ、システム カメラをしまうと、開発者からメッセージが届く場合があります。

6. pic_photo_or_album: ユーザーが写真を撮るかアルバムに写真を送信するボタンをクリックすると、WeChat クライアントはユーザーが「写真を撮る」または「モバイルから選択」を選択するためのセレクターをポップアップします。電話アルバム」。ユーザーが選択した後、他の 2 つのプロセスを実行します。

7. pic_weixin: ユーザーがポップアップ WeChat フォト アルバム送信者のボタンをクリックすると、選択操作が完了すると、WeChat クライアントは WeChat フォト アルバムを呼び出し、選択された写真が開発者のものに送信されます。サーバーとイベントが開発者にプッシュされ、同時にフォト アルバムを閉じると、後で開発者からメッセージが届く場合があります。

8. location_select: ユーザーがポップアップ地理的場所セレクターのボタンをクリックすると、選択操作が完了すると、WeChat クライアントは地理的場所選択ツールを呼び出し、選択された地理的場所が に送信されます。開発者のサーバーにアクセスすると、その場所が閉鎖されます。ツールを選択すると、開発者からメッセージが届く場合があります。

9. media_id: メッセージを送信します (テキスト メッセージを除く)。ユーザーが media_id タイプのボタンをクリックすると、WeChat サーバーは開発者によって入力された永続的なマテリアル ID に対応するマテリアルをユーザーに送信します。マテリアルのタイプは、写真、オーディオ、ビデオ、グラフィックメッセージです。注意してください: 永久マテリアル ID は、アップロード後に「マテリアル管理/追加永久マテリアル」インターフェースを通じて取得した法的 ID である必要があります。

10. view_limited: 画像とテキスト メッセージの URL にジャンプします。ユーザーが view_limited タイプのボタンをクリックすると、WeChat クライアントは、開発者が入力した永続的なマテリアル ID に対応する画像とテキスト メッセージの URL を開きます。ボタン。永続的なマテリアル タイプは画像とテキスト情報のみをサポートします。注意: 永久マテリアル ID は、「マテリアル管理/永久マテリアルの追加」インターフェースを介してアップロードした後に取得した法的 ID である必要があります。

3 から 8 までのすべてのイベントは WeChat iPhone 5.4.1 以降のみをサポートしており、古いバージョンの Android 5.4 以降の WeChat ユーザーはクリックしても応答せず、開発者はイベント プッシュを正常に受信できないことに注意してください。 。 9 と 10 は、WeChat によって認定されていないサードパーティ プラットフォームのサブスクリプション アカウント (具体的には、資格認定に合格しなかったアカウント) のために特別に用意されたイベント タイプであり、イベント プッシュがなく、その機能は比較的限定されています。他の種類の公開アカウント 使用する必要はありません。

インターフェース呼び出しリクエストの説明

http リクエストメソッド: POST (https プロトコルを使用してください) api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN

クリックしてリクエストの例を表示します

{
     "button":[
     {
          "type":"click",
          "name":"今日歌曲",
          "key":"V1001_TODAY_MUSIC"
      },
      {
           "name":"菜单",
           "sub_button":[
           {
               "type":"view",
               "name":"搜索",
               "url":"http://www.soso.com/"
            },
            {
               "type":"view",
               "name":"视频",
               "url":"http://v.qq.com/"
            },
            {
               "type":"click",
               "name":"赞一下我们",
               "key":"V1001_GOOD"
            }]
       }]
 }

その他 Newボタンタイプリクエスト例

{
    "button": [
        {
            "name": "扫码", 
            "sub_button": [
                {
                    "type": "scancode_waitmsg", 
                    "name": "扫码带提示", 
                    "key": "rselfmenu_0_0", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "scancode_push", 
                    "name": "扫码推事件", 
                    "key": "rselfmenu_0_1", 
                    "sub_button": [ ]
                }
            ]
        }, 
        {
            "name": "发图", 
            "sub_button": [
                {
                    "type": "pic_sysphoto", 
                    "name": "系统拍照发图", 
                    "key": "rselfmenu_1_0", 
                   "sub_button": [ ]
                 }, 
                {
                    "type": "pic_photo_or_album", 
                    "name": "拍照或者相册发图", 
                    "key": "rselfmenu_1_1", 
                    "sub_button": [ ]
                }, 
                {
                    "type": "pic_weixin", 
                    "name": "微信相册发图", 
                    "key": "rselfmenu_1_2", 
                    "sub_button": [ ]
                }
            ]
        }, 
        {
            "name": "发送位置", 
            "type": "location_select", 
            "key": "rselfmenu_2_0"
        },
        {
           "type": "media_id", 
           "name": "图片", 
           "media_id": "MEDIA_ID1"
        }, 
        {
           "type": "view_limited", 
           "name": "图文消息", 
           "media_id": "MEDIA_ID2"
        }
    ]

パラメータ説明

戻り結果

正しい場合の戻りJSONデータパケットは以下の通り:

{"errcode":0,"errmsg":"ok"}

間違っている場合の戻りJSONデータパケットは以下の通り(例は無効なメニュー名の長さです):

{"errcode":40018,"errmsg":"invalid button name size"}

【関連する推奨事項】

1. 特別な推奨事項: 「php Programmer Toolbox」V0.1 バージョンのダウンロード

2. WeChat パブリック アカウント プラットフォームのソース コードのダウンロード

3 .

Alizi注文システムのソースコード

以上がカスタムメニュー作成インターフェースの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。