接入概述

接入微信小程序消息服務，開發者需要按照如下步驟完成：

1、填寫服務器配置

2、驗證服務器地址的有效性

3、依據接口文檔實現業務邏輯

下面詳細介紹這3個步驟。

第一步：填寫服務器配置

登錄微信小程序官網后，在小程序官網的“設置-消息服務器”頁面，管理員掃碼啟用消息服務，填寫服務器地址（URL）、Token 和 EncodingAESKey。

URL是開發者用來接收微信消息和事件的接口URL。Token可由開發者可以任意填寫，用作生成簽名（該Token會和接口URL中包含的Token進行比對，從而驗證安全性）。EncodingAESKey由開發者手動填寫或隨機生成，將用作消息體加解密密鑰。

同時，開發者可選擇消息加解密方式：明文模式、兼容模式和安全模式。可以選擇消息數據格式：XML格式或JSON格式。加密方式的默認狀態是明文格式，而數據格式的默認狀態是XML格式。

模式的選擇與服務器配置在提交后都會立即生效，請開發者謹慎填寫及選擇。切換加密方式和數據格式需要提前配置好相關代碼，詳情請參考消息加解密說明。

第二步：驗證消息的確來自微信服務器

開發者提交信息后，微信服務器將發送GET請求到填寫的服務器地址URL上，GET請求攜帶參數如下表所示：

開發者通過檢驗signature對請求進行校驗（下面有校驗方式）。若確認此次GET請求來自微信服務器，請原樣返回echostr參數內容，則接入生效，成為開發者成功，否則接入失敗。加密/校驗流程如下：1、將token、timestamp、nonce三個參數進行字典序排序；2、將三個參數字符串拼接成一個字符串進行sha1加密；3、開發者獲得加密后的字符串可與signature對比，標識該請求來源于微信

檢驗signature的PHP示例代碼：

private function checkSignature()
{
    $signature = $_GET["signature"];
    $timestamp = $_GET["timestamp"];
    $nonce = $_GET["nonce"];

    $token = TOKEN;
    $tmpArr = array($token, $timestamp, $nonce);
    sort($tmpArr, SORT_STRING);
    $tmpStr = implode( $tmpArr );
    $tmpStr = sha1( $tmpStr );

    if( $tmpStr == $signature ){
        return true;
    }else{
        return false;
    }
}

PHP示例代碼下載：下載

第三步：依據接口文檔實現業務邏輯

驗證URL有效性成功后即接入生效，成為開發者。至此用戶向小程序客服發送消息、或者進入會話等情況時，開發者填寫的服務器配置URL將得到微信服務器推送過來的消息和事件，開發者可以依據自身業務邏輯進行響應。

另請注意，開發者所填寫的URL必須以 http:// 或 https:// 開頭，分別支持80端口和443端口。