如何釘釘接入第三方

本文將從以下多個方面對釘釘接入第三方進行詳細闡述，包括：

• 開發者註冊
• 創建企業應用
• 獲取access_token
• 推送消息
• 接受回調

一、開發者註冊

在使用釘釘的開發者平台時，首先需要註冊為開發者。註冊成功後，可以登錄釘釘開發者平台進行下一步操作。

// 註冊鏈接示例
https://open-dev.dingtalk.com/#/login

// 登錄鏈接示例
https://open-dev.dingtalk.com/#/index

二、創建企業應用

釘釘提供了企業內開發者應用和服務窗兩種類型的企業應用。如果是想要向企業用戶發送消息，則需要創建企業內開發者應用，如果想要向服務窗用戶發送消息，則需要創建服務窗應用。應用創建成功後，可以獲取到appKey和appSecret。

// 創建企業內開發者應用
https://open-dev.dingtalk.com/#/index/createApp

// 創建服務窗應用
https://open-dev.dingtalk.com/#/index/createServiceWindowApp

三、獲取access_token

開發者獲取access_token後，就可以對當前企業進行操作了。獲取access_token的請求需要使用企業應用的appKey和appSecret，並且每個企業對應的access_token是不同的。獲取access_token的詳細步驟可參考以下API調用示例。

// API調用示例
https://oapi.dingtalk.com/gettoken?appkey=appKey&appsecret=appSecret

四、推送消息

一般而言，推送消息分為兩種形式，分別為：主動推送和被動回調。主動推送是指開發者向釘釘服務端推送消息，服務器再將消息推送給用戶。被動回調是指當用戶發生某些操作時，釘釘服務器會主動向開發者的服務器發送消息，這種方式需要開發者的服務器有一個公網IP，或通過ngrok等映射工具實現內網穿透。推送消息的詳細步驟可參考以下API調用示例。

// 推送消息API調用示例
https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN

五、接受回調

如果需要在被動回調的方式下接收釘釘的推送消息，需要在開發者中心的「開發管理」模塊下進行回調URL的設置。當用戶進行某些操作時，釘釘服務器會向開發者的服務器發送相關的消息，開發者的服務器需要對請求進行驗證並進行相應的處理。接受回調的詳細步驟可參考以下API調用示例。

// 接受回調API調用示例
https://oapi.dingtalk.com/call_back/register_call_back?access_token=ACCESS_TOKEN