說明文件
企業微信整合設定指南
透過企業微信「智慧型機器人」的 API 模式，將 MokenLogic 中的智慧體接入企業微信，讓團隊成員可以在單聊或群聊中直接與你的智慧體對話。全流程約 3 分鐘。
開始前的準備
- 一個企業微信「超級管理員」帳號，或擁有「管理工具」權限的子管理員帳號。
- 已安裝並完成初始化的 MokenLogic，並至少建立一個智慧體。
- 一台保持執行的 Mac，用於承載長連線（無需公網 IP 或網域）。
操作步驟
進入企業微信「智慧型機器人」管理頁面
使用管理員帳號登入企業微信管理後台，依序點選左側導覽列的「安全與管理」→「管理工具」，在右側「智慧專區 AI」分類下點選「智慧型機器人」卡片。
需要使用企業微信「超級管理員」或擁有「管理工具」權限的子管理員帳號。 · 管理後台網址：https://work.weixin.qq.com/wework_admin/
選擇「手動建立」
在「智慧型機器人」頁面點選「建立機器人」按鈕。在彈出的「你需要一個什麼樣的機器人」對話方塊左下角，選擇「手動建立」。
請勿使用對話方塊中的「AI 自動產生」方式，否則不會出現後續 API 模式所需的設定項目。
切換到「API 模式建立」
進入「建立智慧型機器人」設定頁後，將右側設定面板捲動到最底部，在「儲存 / 取消」按鈕上方找到提示文字，點選「API 模式建立」連結。
API 模式下機器人將由 Moken 接管對話產生，因此頁面上的「外掛」「工作流程」「歡迎語」等設定無需填寫。
選擇長連線並複製 Bot ID 與 Secret
在「API 設定」區域，「連線方式」選擇「使用長連線」（無需設定網域或公網 IP）。然後複製下方自動產生的「Bot ID」，並點選「Secret」右側的「點選取得」產生金鑰並複製。
請將 Secret 妥善保存，關閉頁面後將無法再次檢視，只能重新產生。 · 記得在頁面頂部為機器人設定「可見範圍」並點選「儲存」，否則成員無法在企業微信中與機器人對話。
在 MokenLogic 中新增企業微信機器人
打開 MokenLogic，進入「能力 → 整合」頁面，找到「企業微信」連接器並點選「+ 新增機器人」。在對話方塊中將上一步複製的內容分別填入「機器人 ID」（Bot ID）與「機器人金鑰」（Secret），選擇要回應訊息的「智慧體」，可選填一個便於識別的「顯示名稱」，最後點選「註冊機器人」即可完成接入。
整合
- 企業微信已填入 Bot ID註冊機器人
- Lark未連線新增機器人
- Teams未連線新增機器人
註冊成功後，機器人會立即透過長連線接入 MokenLogic —— 在企業微信中向該機器人傳送訊息，即可由所選智慧體產生回覆。 · 可在「整合」頁面隨時點選「重新整理」查看連線狀態，或點選垃圾桶圖示移除機器人。
完成！下一步
註冊成功後，可見範圍內的成員即可在企業微信中向機器人傳送訊息，由所選智慧體接管回覆。如需讓機器人回應群聊，請在企業微信群組中點選右上角「···」→「群機器人」，將該機器人加入群組。
- 修改可見範圍、回覆智慧體或顯示名稱：返回 MokenLogic「整合」頁面進行調整。
- Secret 洩漏或遺失：回到企業微信管理後台對應機器人的「API 設定」區域重新產生 Secret，再在 MokenLogic 中更新即可。
- 機器人無回應：確認 Mac 已啟動 MokenLogic 且未休眠，並在「整合」頁點選「重新整理」檢查連線狀態。