整合
Lark / 飛書 整合設定指南
透過 Lark / 飛書「智慧型機器人」的智慧體應用程式，將 MokenLogic 中的智慧體接入 Lark / 飛書，讓團隊成員可以在單聊或群聊中直接與你的智慧體對話。全流程約 3 分鐘。
開始前的準備
- 一個具備「建立應用程式」權限的 Lark / 飛書帳號。
- 已安裝並完成初始化的 MokenLogic，並至少建立一個智慧體。
- 一台保持運行的 Mac，用於承載長連線（無需公用網路 IP 或網域）。
操作步驟
建立智慧體應用程式
打開 Lark（https://open.larksuite.com/page/launcher?from=backend_oneclick）或飛書（https://open.feishu.cn/page/launcher?from=backend_oneclick）開發人員平台的一鍵建立應用程式頁面，選擇頭像、填寫應用程式名稱，點選「建立」。
複製 App ID 與 App Secret
應用程式建立後會顯示 App ID 與 App Secret，複製並填入 MokenLogic。
請妥善保存 App Secret；如外洩可在應用程式「Credentials & Basic Info」頁面重設。
在 MokenLogic 中註冊機器人
打開 MokenLogic，進入「能力 → 連接器」，在「Lark（國際版）」/「飛書（中國版）」分組點選「新增機器人」。填入 App ID 與 App Secret，選擇要回應訊息的智慧體，可選填顯示名稱，點選「註冊機器人」。註冊成功後，機器人會立即透過長連線接入 MokenLogic —— 在 Lark / 飛書中向該機器人傳送訊息，即可由所選智慧體產生回覆。可在「連接器」頁面隨時點選「重新整理」查看連線狀態，或點選垃圾桶圖示移除機器人。
連接器
- Lark（國際版）已填入 App ID註冊機器人
- 飛書（中國版）未連線新增機器人
- 企業微信未連線新增機器人
開通「使用者基本資訊」
註冊成功後，MokenLogic 會提示「開通使用者基本資訊」——這能讓對話標題正確顯示使用者名稱。點選「Open permissions page」跳轉到 Lark / 飛書的權限設定。
開通使用者基本資訊？
開通後，對話標題才能正確顯示 Lark / 飛書使用者名稱。
新增「取得使用者基本資訊」權限
在權限頁面搜尋並勾選「取得使用者基本資訊（contact:user.base:readonly）」，點選「Add Scopes」新增該權限。
發布應用程式以套用變更
進入「Version Management & Release」，設定可用範圍後點選「Save」建立版本並發布。權限變更會在應用程式發布（管理員審核通過）後才正式生效。
頂部若提示「The changes will take effect after the current version is published」，即表示需要完成這一步。
完成！開始在 Lark / 飛書中使用
應用程式發布並連接成功後，可見範圍內的成員即可在 Lark / 飛書中向機器人傳送訊息，或在群聊中 @ 它，由所選智慧體產生回覆。如需在群聊中使用，請將該機器人加入對應群組。