PHP 介面開發教學課程：實作企業微信外部聯絡人功能
導言：
隨著企業微信（WeCom）的快速普及與發展，越來越多的企業開始利用企業微信建立與外部聯絡人的溝通管道，以便更好地管理客戶、供應商和合作夥伴。本文將介紹如何利用PHP開發接口，實現企業微信外部聯絡人功能，包括建立外部聯絡人、取得外部聯絡人清單以及傳送外部聯絡人訊息等功能。
一、環境準備：
要進行企業微信外部聯絡人功能的開發，首先需要確保以下環境準備：
二、取得access_token：
在進行介面呼叫之前，我們需要先取得一個access_token作為介面呼叫的憑證。 access_token有一定的有效期，過期之後需要重新取得。
介面位址：
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET
（註：將ID和SECRET替換為企業微信自建置應用的ID和Secret）
介面傳回：
{
"errcode": 0, "errmsg": "ok", "access_token": "ACCESS_TOKEN", "expires_in": 7200
}
將access_token儲存在本機，用於後續的介面呼叫。
三、建立外部聯絡人：
現在我們可以開始實現創建外部聯絡人的功能了。以下是建立外部聯絡人的介面呼叫範例：
介面位址：
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/add?access_token=ACCESS_TOKEN
#介面參數：
介面參數使用JSON格式進行傳遞，範例如下：
{
"external_contact": {
"external_userid": "external_userid",
"name": "contact_name",
"nickname": "contact_nickname",
"gender": 1,
"position": "contact_position",
"corp_name": "corporation_name",
"type": 1
},
"follow_user": ["user_id_1", "user_id_2"]}
介面傳回：
{
"errcode": 0,
"errmsg": "ok",
"external_contact": {
"external_userid": "external_userid"
}}
在上述範例中，我們傳遞了外部聯絡人的詳細訊息，包括外部聯絡人ID、姓名、暱稱、性別、職位、公司名稱和聯絡資訊等。同時，我們也可以指定跟進人員，讓相關的企業微信使用者追蹤該外部聯絡人。
四、取得外部聯絡人清單：
接下來，我們來實現取得外部聯絡人清單的功能。以下是取得外部聯絡人清單的介面呼叫範例：
介面位址：
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/list?access_token=ACCESS_TOKEN
介面參數：
{
"userid": "userid", "cursor": "", "limit": 100
}
介面傳回：
{
"errcode": 0,
"errmsg": "ok",
"external_contact_list": [
{
"external_userid": "external_userid_1",
"name": "contact_name_1",
"position": "contact_position_1",
"corp_name": "corporation_name_1",
"type": 1,
"follow_user": ["user_id_1"]
},
{
"external_userid": "external_userid_2",
"name": "contact_name_2",
"position": "contact_position_2",
"corp_name": "corporation_name_2",
"type": 2,
"follow_user": ["user_id_2", "user_id_3"]
}
],
"next_cursor": "next_cursor"}
在上述範例中，我們傳遞了獲取外部聯絡人清單的參數，包括使用者ID、遊標和每次回傳的數量限制等。在介面返回中，我們可以獲得外部聯絡人的清單信息，包括外部聯絡人的ID、姓名、職位、公司名稱、類型以及跟進人員等。如果清單總數超過了每次回傳的數量限制，可以使用next_cursor進行分頁取得。
五、發送外部聯絡人訊息：
最後，我們來實現發送外部聯絡人訊息的功能。以下是傳送外部聯絡人訊息的介面呼叫範例：
介面位址：
https://qyapi.weixin.qq.com/cgi-bin/externalcontact/message/send?access_token=ACCESS_TOKEN
介面參數：
{
"touser": "user_id",
"msgtype": "text",
"text": {
"content": "Hello, world!"
}}
介面傳回：
{
"errcode": 0, "errmsg": "ok"
}
在上述範例中，我們傳遞了發送訊息的參數，包括接收訊息的用戶ID和訊息類型，這裡我們使用了文字訊息類型。在文字訊息類型中，我們可以傳遞要傳送的文字內容。
結束語：
透過本教程，我們學習瞭如何利用PHP開發接口，實現企業微信外部聯繫人功能，包括創建外部聯繫人、獲取外部聯繫人列表以及發送外部聯繫人消息等功能。希望本教學能對您有所幫助，歡迎您在實際應用上嘗試拓展。謝謝閱讀！
以上是PHP 介面開發教學：實作企業微信外部聯絡人功能的詳細內容。更多資訊請關注PHP中文網其他相關文章！
