php WeChat開発カスタムメニュー

13286 ワード

現在、WeChatサービス番号のカスタムメニューは最大3つの1級メニューを含み、各1級メニューは最大5つの2級メニューを含みます。一級メニューは最大4つの漢字、二級メニューは最大7つの漢字で、多く出る部分は「…」で代替されます。カスタマイズメニューを作成した後、WeChatクライアントのキャッシュのため、24時間のWeChatクライアントが現れます。テスト時に公衆アカウントをキャンセルして再度注目すると、作成後の効果が見られます。
現在カスタムメニューインターフェースでは、次のような2種類のボタンが可能です。
click:
ユーザがclickタイプボタンをクリックすると、WeChatサーバはメッセージインタフェースを通じてイベントをプッシュします。の構造は開発者（参照メッセージインターフェースガイド）に与えられ、開発者が作成したkey値をボタンで持ち、開発者はユーザーとユーザーをカスタマイズしたkey値でインタラクティブにすることができる。
ビュー:
ユーザーがviewタイプのボタンをクリックすると、WeChatクライアントが開発者がボタンに記入したurl値を開きます。（ウェブリンク）は、ウェブページを開く目的を達成し、ウェブページの授権とユーザー基本情報インターフェースを結合し、ユーザーの登録個人情報を取得することを提案します。
インターフェース呼び出し要求の説明
http要求方式：POST（httpsプロトコルを使用してください）https://api.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN
要求例（JSONデータはUTF-8で符号化してください。）


 {
 "button":[
  {"type":"click","name":"    ","sub_button":[
   {"type":"click","name":"    ","key":"BUTTON_1"},
  {"type":"click","name":"    ","key":"BUTTON_2"},
  {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXX"}]
 },
  {"type":"click","name":"    ","key":"BUTTON_3"},
  {"name":"    ","sub_button":[
   {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXXX"},
   {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXXX"},
   {"type":"click","name":"     ","key":"BUTTON_ZAN"}]
  }
 ]
}

パラメータの説明

結果を返します
正しい場合のJSONバックは以下の通りです。
{"errrceode"：0，"errmsg":"ok"
エラー時のJSONバックは以下の通りです。
{"errrceode":40018"，"errmsg":"invalid button name size"
以下はコード例（PHP）です。


 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="zh-CN">
 <head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  <meta name="author" content="Chris Mao" />
 </head>
 <body>
 <?php
  $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET";

  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_HEADER, 0);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_POST, 0);
  curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
  curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

  $output = curl_exec($ch);
  curl_close($ch);
  if (empty($output)) { var_dump($output); exit; }
  $result = json_decode($output);
  $token = $result->access_token;
   
  //    
  $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=$token";
  $jsonData = file_get_contents("menu.json");
  $ch = curl_init($url);
  curl_setopt($ch, CURLOPT_HEADER, 0);
  curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
  curl_setopt($ch, CURLOPT_POST, 1);
  curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
  curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']);
  curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
  curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
  $output = curl_exec($ch);
  curl_close($ch); 
  var_dump($output);
 ?>
 </body>
</html>

menu.json


{
 "button":[
  {"type":"click","name":"    ","sub_button":[
   {"type":"click","name":"    ","key":"BUTTON_1"},
  {"type":"click","name":"    ","key":"BUTTON_2"},
  {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXX"}]
 },
  {"type":"click","name":"    ","key":"BUTTON_3"},
  {"name":"    ","sub_button":[
   {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXXX"},
   {"type":"view","name":"    ","url":"http://XXXXXXXXXXXXXXXXXX"},
   {"type":"click","name":"     ","key":"BUTTON_ZAN"}]
  }
 ]
}

カスタムメニューイベントに応答


 $wechatObj = new wechatCallbackAPI();
 if (isset($_GET["echostr"])) { 
  $wechatObj->valid(); 
 } else { 
  $wechatObj->responseMsg();
 }


 class wechatCallbackAPI {

  private $token = "WEIXIN";

  private $appId = "APPID";

  private $appSecret = "APPSECRET";
  
  private function checkSignature() {
   $signature = $_GET["signature"];
   $timestamp = $_GET["timestamp"];
   $nonce = $_GET["nonce"]; 
     
   $tmpArr = array($this->token, $timestamp, $nonce);
   sort($tmpArr);
   $tmpStr = implode($tmpArr);
   $tmpStr = sha1($tmpStr);
   
   if($tmpStr == $signature) {
    return true;
   } else {
    return false;
   }
  }

  private function getAccessToken() {
   $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=$this->appId&secret=$this->appSecret";

   $ch = curl_init($url);
   $curl_setopt($ch, CURLOPT_HEADER, 0);
   $curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
   $curl_setopt($ch, CURLOPT_POST, 0);
   $curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
   $curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);

   $output = curl_exec($ch);
   curl_close($ch);
   if (empty($output)) { return ""; }

   $result = json_decode($result);
   return $result->access_token;
  }

  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"];
   if (empty($postStr)){
    echo "";
    exit;
   }

   //extract post data
   $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
   $fromUsername = $postObj->FromUserName;
   $toUsername = $postObj->ToUserName;
   $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>";
   
   switch (strtolower(trim($postObj->MsgType))) {
    case "text": //    
     $keyword = trim($postObj->Content);
     if(!empty($keyword)) {
      $msgType = "text";
      $contentStr = "$fromUsername,         : $keyword ";
      if (strtolower($keyword) == "time") {
       $contentStr = date("Y-m-d H:i:s", $time);
      }
      $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     } else {
      $resultStr = "Input something...";
     }
     break;
    case "image": //    
     $msgType = "text";
     $contentStr = "$fromUsername,         ";
     $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     break;
    case "voice": //    
     $msgType = "text";
     $contentStr = "$fromUsername,         ";
     $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     break;
    case "video": //    
     $msgType = "text";
     $contentStr = "$fromUsername,         ";
     $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     break;
    case "location": //    
     $msgType = "text";
     $contentStr = "$fromUsername,         ";
     $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     break;
    case "link": //    
     $msgType = "text";
     $contentStr = "$fromUsername,         ";
     $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
     break;
    case "event": //  
     switch (strtolower(trim($postObj->Event))) {
      case "subscribe": //    
       $msgType = "text";
       $contentStr = "     XXXXXXX";
       $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
       break;
      case "unsubscribe": //      
       break;
      case "scan": //             
       $msgType = "text";
       $contentStr = "$fromUsername,        ";
       $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
       break;
      case "location": //        
       $msgType = "text";
       $contentStr = "$fromUsername,        ";
       $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
       break;
      case "click": //       
       $msgType = "text";
       $contentStr = "$fromUsername,           $postObj->EventKey ";
       if ("BUTTON_ZAN" == $postObj->EventKey) {
        $contentStr = "     ，             。";
       }
       $resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
       ;
       break;
      default:
       $resultStr = "";
     }
     break;
    default:
     $resultStr = "";
   }
   echo $resultStr;
  }
 }
?>

カスタムメニュークエリ
インターフェースを使ってカスタマイズメニューを作成すると、開発者はユーザー定義メニューの構造をインターフェースで問い合わせることもできます。
説明を求める
http要求方式：GET
https://api.weixin.qq.com/cgi-bin/menu/get?access_token=ACCESS_TOKEN
説明に戻ります
インターフェースの作成に対応して、正しいJsonは結果を返します。

{"menu":{"button":[{"name":"    ","sub_button":[{"type":"click","name":"    ","key":"BUTTON_1","sub_button":[]},{"type":"click","name":"    ","key":"BUTTON_2","sub_button":[]},{"type":"view","name":"    ","url":"http:\/\/XXXXXXXX","sub_button":[]}]},{"type":"click","name":"    ","key":"BUTTON_3","sub_button":[]},{"name":"    ","sub_button":[{"type":"view","name":"    ","url":"http:\/\/XXXXXXXX","sub_button":[]},{"type":"view","name":"    ","url":"http:\/\/XXXXXXXX","sub_button":[]},{"type":"click","name":"     ","key":"BUTTON_ZAN","sub_button":[]}]}]}}

カスタムメニューの削除
インターフェースを使ってカスタマイズメニューを作成すると、開発者は現在使用しているカスタムメニューをインターフェースで削除することもできます。
説明を求める
http要求方式：GET
https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=ACCESS_TOKEN
説明に戻ります
インターフェースの作成に対応して、正しいJsonは結果を返します。
｛errceode”：0、“errmsg”：“ok”｝
以上が本文の全部です。皆さんの勉強に役に立つように、私たちを応援してください。