C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(16)-微信企業(yè)號(hào)的配置和使用

2019-11-17 02:52:02

字體：大中小

供稿：網(wǎng)友

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(16)-微信企業(yè)號(hào)的配置和使用

在本系列隨筆的前面，主要就是介紹微信公眾號(hào)的門(mén)戶應(yīng)用開(kāi)發(fā)，最近把整個(gè)微信框架進(jìn)行了擴(kuò)展補(bǔ)充，增加了最新的企業(yè)號(hào)的API封裝和開(kāi)發(fā)，后續(xù)主要介紹如何利用C#進(jìn)行微信企業(yè)號(hào)的開(kāi)發(fā)工作，本篇作為微信企業(yè)號(hào)的開(kāi)發(fā)的起步篇，介紹微信企業(yè)號(hào)的配置和使用。

1、微信企業(yè)號(hào)的注冊(cè)和登陸

企業(yè)號(hào)是繼公眾號(hào)、訂閱號(hào)的另外一種微信類型，它主要是面對(duì)企業(yè)的。企業(yè)號(hào)是微信為企業(yè)客戶提供的移動(dòng)應(yīng)用入口?？梢詭椭髽I(yè)建立員工、上下游供應(yīng)鏈與企業(yè) IT 系統(tǒng)間的連接。利用企業(yè)號(hào) ，企業(yè)或第三方合作伙伴可以幫助企業(yè)快速、低成本的實(shí)現(xiàn)高質(zhì)量的移動(dòng)輕應(yīng)用，實(shí)現(xiàn)生產(chǎn)、管理、協(xié)作、運(yùn)營(yíng)的移動(dòng)化。

個(gè)人覺(jué)得企業(yè)號(hào)最大的亮點(diǎn)是可以不限數(shù)量的消息發(fā)送，也就是可以在企業(yè)員工之間暢通交流。相對(duì)于公眾號(hào)和訂閱號(hào)，發(fā)送消息的謹(jǐn)慎程度，微信企業(yè)號(hào)可謂給人眼前一亮的感覺(jué)。不過(guò)微信企業(yè)號(hào)是需要內(nèi)部建立好通訊錄，關(guān)注者需要匹配通訊錄的微信號(hào)、郵箱、電話號(hào)碼任一個(gè)通過(guò)才可以關(guān)注，也就是可以防止其他外來(lái)人員的自由關(guān)注了，另外如果為了安全考慮，還可以設(shè)置二次驗(yàn)證，也就是一個(gè)審核過(guò)程。

企業(yè)號(hào)的認(rèn)證和公眾號(hào)一樣，需要提供相關(guān)的企業(yè)資質(zhì)文件，并且認(rèn)證每年都要收取費(fèi)用，否則可能有人員和功能的一些限制。覺(jué)得微信真是想著方法賺錢(qián)，目前已有的收費(fèi)模式有，訂閱號(hào)、公眾號(hào)、企業(yè)號(hào)、開(kāi)放平臺(tái)，好像都有認(rèn)證收費(fèi)的了，而且微信小店也還需要收2萬(wàn)的押金，一切都是錢(qián)呀。

好了，其他不多說(shuō)，微信的注冊(cè)地址是：https://qy.weixin.QQ.com，一個(gè)郵箱不能同時(shí)注冊(cè)微信公眾號(hào)和微信企業(yè)號(hào)。

對(duì)于企業(yè)開(kāi)通企業(yè)號(hào)并開(kāi)始使用需要四步

1)企業(yè)到微信官網(wǎng)（http://qy.weixin.qq.com）申請(qǐng)開(kāi)通；

2)開(kāi)通后，企業(yè)在企業(yè)號(hào)管理后臺(tái)導(dǎo)入成員，發(fā)布二維碼；

3)企業(yè)調(diào)用企業(yè)號(hào)api與企業(yè)自有系統(tǒng)對(duì)接開(kāi)發(fā)；

4)員工關(guān)注，收到微信信息，在微信中與企業(yè)交互

注冊(cè)好企業(yè)號(hào)，就可以通過(guò)微信掃一掃，掃描企業(yè)二維碼進(jìn)行登錄了，掃描的時(shí)候，需要微信進(jìn)行確認(rèn)，才可以繼續(xù)輸入密碼進(jìn)行登錄，操作界面如下所示（左邊是手機(jī)截圖，右邊是網(wǎng)頁(yè)截圖）。

登錄后我們就可以看到對(duì)應(yīng)的電腦端的管理界面了。

2、設(shè)置開(kāi)發(fā)回調(diào)模式

如果開(kāi)發(fā)過(guò)微信公眾號(hào)，那么我們就知道，如果需要在微信服務(wù)器和網(wǎng)站服務(wù)器之間建立連接關(guān)系，實(shí)現(xiàn)消息的轉(zhuǎn)發(fā)和處理，那么就應(yīng)該設(shè)置一個(gè)回調(diào)模式，需要配置好相關(guān)的參數(shù)。然后在自己網(wǎng)站服務(wù)器里面建立一個(gè)處理微信服務(wù)器消息的入口。

進(jìn)入配置后，我們需要修改相關(guān)的URL、Token、EncodingAESKey等參數(shù)，主要是URL，這個(gè)就是和公眾號(hào)的入口處理一樣的，需要我們發(fā)布到網(wǎng)站服務(wù)器上的處理入口。

Token和AESKey可以根據(jù)提示動(dòng)態(tài)生成一個(gè)即可，AESKey好像必須是23位的，所以這個(gè)一般是讓它自己生成的，這個(gè)主要用來(lái)加密解密使用的。

URL、Token、EncodingAESKey三個(gè)參數(shù)說(shuō)明。

1）URL是企業(yè)應(yīng)用接收企業(yè)號(hào)推送請(qǐng)求的訪問(wèn)協(xié)議和地址，支持http或https協(xié)議。

2）Token可由企業(yè)任意填寫(xiě)，用于生成簽名。

3）EncodingAESKey用于消息體的加密，是AES密鑰的Base64編碼。

驗(yàn)證URL、Token以及加密的詳細(xì)處理請(qǐng)參考后續(xù) “接收消息時(shí)的加解密處理” 的部分。

我公司的企業(yè)號(hào)配置后的界面如下所示。

這個(gè)URL里面指向的頁(yè)面功能，需要對(duì)數(shù)據(jù)進(jìn)行解析并返回給微信服務(wù)器，因此我們需要在服務(wù)器上預(yù)先部署好這個(gè)處理功能入口。

除了上面的幾個(gè)函數(shù)，還有一個(gè)CorpID的參數(shù)需要使用，我們可以在后臺(tái)主界面-設(shè)置里面查看到。

然后我們?yōu)榱朔奖憔W(wǎng)站后臺(tái)使用，我們和公眾號(hào)的配置一樣，把它放到了Web.Config里面，如下所示。

3、實(shí)現(xiàn)回調(diào)頁(yè)面的功能開(kāi)發(fā)

前面介紹了幾個(gè)配置項(xiàng)，需要在回調(diào)頁(yè)面里面使用的，本小節(jié)繼續(xù)介紹如何實(shí)現(xiàn)企業(yè)號(hào)信息的回發(fā)，使之通過(guò)回調(diào)測(cè)試的操作。

由于回調(diào)測(cè)試的數(shù)據(jù)是通過(guò)Get方式發(fā)送的，因此我們的處理邏輯代碼如下所示，和公眾號(hào)的類似處理，只是實(shí)現(xiàn)部分不太一樣而已。

    /// <summary>    /// 企業(yè)號(hào)回調(diào)信息接口。統(tǒng)一接收并處理信息的入口。    /// </summary>    public class corpapi : IHttpHandler    {        /// <summary>        /// 處理企業(yè)號(hào)的信息        /// </summary>        /// <param name="context"></param>        public void PRocessRequest(HttpContext context)        {            string postString = string.Empty;            if (HttpContext.Current.Request.HttpMethod.ToUpper() == "POST")            {                using (Stream stream = HttpContext.Current.Request.InputStream)                {                    Byte[] postBytes = new Byte[stream.Length];                    stream.Read(postBytes, 0, (Int32)stream.Length);                    postString = Encoding.UTF8.GetString(postBytes);                }                if (!string.IsNullOrEmpty(postString))                {                    Execute(postString);                }            }            else            {                Auth();            }        }        /// <summary>        /// 成為開(kāi)發(fā)者的第一步，驗(yàn)證并相應(yīng)服務(wù)器的數(shù)據(jù)        /// </summary>        private void Auth()        {            #region 獲取關(guān)鍵參數(shù)            string token = ConfigurationManager.AppSettings["CorpToken"];//從配置文件獲取Token            if (string.IsNullOrEmpty(token))            {                LogTextHelper.Error(string.Format("CorpToken 配置項(xiàng)沒(méi)有配置！"));            }            string encodingAESKey = ConfigurationManager.AppSettings["EncodingAESKey"];//從配置文件獲取EncodingAESKey            if (string.IsNullOrEmpty(encodingAESKey))            {                LogTextHelper.Error(string.Format("EncodingAESKey 配置項(xiàng)沒(méi)有配置！"));            }            string corpId = ConfigurationManager.AppSettings["CorpId"];//從配置文件獲取corpId            if (string.IsNullOrEmpty(corpId))            {                LogTextHelper.Error(string.Format("CorpId 配置項(xiàng)沒(méi)有配置！"));            }             #endregion            string echoString = HttpContext.Current.Request.QueryString["echoStr"];            string signature = HttpContext.Current.Request.QueryString["msg_signature"];//企業(yè)號(hào)的 msg_signature            string timestamp = HttpContext.Current.Request.QueryString["timestamp"];            string nonce = HttpContext.Current.Request.QueryString["nonce"];            string decryptEchoString = "";            if (new CorpBasicApi().CheckSignature(token, signature, timestamp, nonce, corpId, encodingAESKey, echoString, ref decryptEchoString))            {                if (!string.IsNullOrEmpty(decryptEchoString))                {                    HttpContext.Current.Response.Write(decryptEchoString);                    HttpContext.Current.Response.End();                }            }        }

具體的處理代碼如下所示，里面的一個(gè)加解密處理的類是微信企業(yè)號(hào)附錄里面提供的，我使用了C#版本的SDK而已。

    /// <summary>    /// 企業(yè)號(hào)基礎(chǔ)操作API實(shí)現(xiàn)    /// </summary>    public class CorpBasicApi : ICorpBasicApi    {        /// <summary>        /// 驗(yàn)證企業(yè)號(hào)簽名        /// </summary>        /// <param name="token">企業(yè)號(hào)配置的Token</param>        /// <param name="signature">簽名內(nèi)容</param>        /// <param name="timestamp">時(shí)間戳</param>        /// <param name="nonce">nonce參數(shù)</param>        /// <param name="corpId">企業(yè)號(hào)ID標(biāo)識(shí)</param>        /// <param name="encodingAESKey">加密鍵</param>        /// <param name="echostr">內(nèi)容字符串</param>        /// <param name="retEchostr">返回的字符串</param>        /// <returns></returns>        public bool CheckSignature(string token, string signature, string timestamp, string nonce, string corpId, string encodingAESKey, string echostr, ref string retEchostr)        {            WXBizMsgCrypt wxcpt = new WXBizMsgCrypt(token, encodingAESKey, corpId);            int result = wxcpt.VerifyURL(signature, timestamp, nonce, echostr, ref retEchostr);            if (result != 0)            {                LogTextHelper.Error("ERR: VerifyURL fail, ret: " + result);                return false;            }            return true;            //ret==0表示驗(yàn)證成功，retEchostr參數(shù)表示明文，用戶需要將retEchostr作為get請(qǐng)求的返回參數(shù)，返回給企業(yè)號(hào)。            // HttpUtils.SetResponse(retEchostr);        }

如果對(duì)這個(gè)《C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用》系列感興趣，可以關(guān)注我的其他文章，系列隨筆如下所示：

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(25)-微信企業(yè)號(hào)的客戶端管理功能

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(24)-微信小店貨架信息管理

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(23)-微信小店商品管理接口的封裝和測(cè)試

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(22)-微信小店的開(kāi)發(fā)和使用

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(21)-微信企業(yè)號(hào)的消息和事件的接收處理及解密

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(20)-微信企業(yè)號(hào)的菜單管理

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(19)-微信企業(yè)號(hào)的消息發(fā)送（文本、圖片、文件、語(yǔ)音、視頻、圖文消息等）

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(18)-微信企業(yè)號(hào)的通訊錄管理開(kāi)發(fā)之成員管理

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(17)-微信企業(yè)號(hào)的通訊錄管理開(kāi)發(fā)之部門(mén)管理

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(16)-微信企業(yè)號(hào)的配置和使用

C#開(kāi)發(fā)微信門(mén)戶及應(yīng)用(15)-微信菜單增加掃一掃、發(fā)圖片、發(fā)地理位置功能