前提條件

• 已開通阿里云百煉服務。

• 已獲取WorkspaceID：獲取Workspace ID。

• 已獲取AccessKey ID和AccessKey Secret：獲取 AccessKey 與 AgentKey。

• 已在析言GBI的數據表管理中授權連接了數據庫。具體操作，請參見數據庫連接。

• 已注冊釘釘企業。

• 已注冊釘釘開發者。

步驟1：創建釘釘應用

1. 登錄釘釘開放平臺后臺。

2. 創建企業內部應用。

   

3. 添加應用能力 > 機器人。

4. 設置機器人的消息接收模式為Stream模式。

   

5. 開通權限、調用企業API基礎權限、企業內機器人發送消息權限、互動卡片實例寫權限、AI卡片流式更新權限。

   

6. 將事件訂閱 > 推送方式設置為Stream模式推送，保存后完成接入驗證。

   

7. 將版本管理與發布 > 發布應用，創建新版本并發布。

   

步驟2：創建卡片模板

1. 登錄釘釘卡片平臺。

2. 單擊模板管理 > 新建模板。

   

3. 單擊導入模板，導入模板文件并保存。

   

   

步驟3：開發釘釘機器人后端應用

此步驟基于Java語言，實現釘釘后端機器人、析言問答服務SDK、釘釘卡片的集成。

1. 提供兩種獲取項目代碼方式。

   1. 參考釘釘官方文件，自行修改代碼。

   2. 直接使用析言提供的測試文件。

2. 如果您使用析言提供的測試文件，您需要替換Properties中的關鍵參數，client-id和client-secret，以及代碼中的templateId。

   dingtalk.app.client-id=xx
   dingtalk.app.client-secret=xx
   openApiHost=https://api.dingtalk.com

3. 運行Java項目，檢查應用初始化和網絡連接是否正常。

   2024-12-26 15:30:04.004  INFO 48685 --- [ection-pool-2-1] .d.o.a.s.n.w.WebsocketTransportConnector : [DingTalk] start websocket connection, uri=wss://wss-open-connection.dingtalk.com:443/connect
   2024-12-26 15:30:04.472  INFO 48685 --- [           main] o.s.b.a.e.web.EndpointLinksResolver      : Exposing 2 endpoint(s) beneath base path '/actuator'
   2024-12-26 15:30:04.556  INFO 48685 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8080 (http) with context path ''
   2024-12-26 15:30:04.589  INFO 48685 --- [           main] com.aliyun.xiyan.demo.Application        : Started Application in 5.972 seconds (JVM running for 6.717)
   2024-12-26 15:30:04.984  INFO 48685 --- [ection-pool-2-1] c.d.o.a.s.n.core.DefaultSessionPool      : [DingTalk] connection is established, connectionId=xxxx-xxx-xxx-xxx-xxx

步驟4：效果驗證

1. 登錄釘釘App，在消息框中@機器人進行問答。在Java應用日志中確認，是否有收到事件通知。

   2024-12-26 15:31:32.758  INFO 48685 --- [lk-Consumer-1-1] com.aliyun.xiyan.demo.ChatBotHandler     : received message: 每月訪客人數趨勢

2. 您可以在釘釘App聊天窗，查看卡片渲染情況。

相關文檔

如果您想參考析言GBI使用，請參見使用指南。

如果您想應用析言GBI，請參見析言GBI最佳實踐。