小精靈建單助手

功能描述

本外掛支援使用者透過與機器人對話，快捷建立Meegle工單。

使用場景

• ITR 問題管理場景
• 日常業務溝通群快速記錄需求、Bug

飛書應用配置

首先需要建立（或使用存在的）飛書企業應用進行配置

進入飛書開放平臺

建立一個應用

檢視App ID、App Secret

配置事件與回撥

安裝外掛

事件回撥、獲取Verification Token

1. 在Meegle外掛配置裡複製webhook地址

1. 配置飛書應用事件訂閱與回撥。此處不需要生成Encrypt Key，開啟會導致驗證失敗。

新增事件

機器人許可權開通

配置的飛書機器人需要至少開通以下許可權

新增一個機器人

以上有些許可權已失效，請參考以下

可直接一鍵批次匯入

應用釋出

應用釋出時，是否需要稽核及稽核流程由飛書企業管理員進行管理配置

外掛配置

飛書機器人配置可參考上面獲取指南

工單配置

工作項及模板配置：當使用者與機器人對話時，將自動建立配置的工作項例項 提交人儲存欄位：用於儲存與機器人對話的機器人的員工資訊（僅可選單行文字型別欄位），由於開放能力技術限制，目前並不能將建單人直接設定為工作項角色人員。外掛提供了“建單人”控制元件，使用該控制元件可以快速調起與建單人的飛書對話

User Key：userkey是Meegle對於人員的唯一標識，外掛裡用於呼叫Meegle的openapi，該人員資訊會被記錄在工作項建立者欄位及操作記錄內。如配置張三的userkey，則透過該機器人建立的工作項建立者會顯示為張三，操作記錄顯示為張三(From plugin-快捷建單)

飛書機器人配置

配置資訊來源於第一步飛書應用配置裡 獲取APP ID、APP Secret： 獲取Verification Token：

操作配置

目前支援配置是否自動回覆訊息

功能使用

1. 開啟飛書APP，找到機器人

建議開啟自動回覆，配置方式如下：

自動建群功能

1. 建立工單 建單後將自動給與機器人對話的提單人傳送工單連結資訊。

FAQ

1. 是否支援富文字型別的訊息？
2. 目前僅支援純文字型別的訊息，富文字（如訊息裡貼了圖片）型別的訊息目前無法識別
3. 建單人是否可以設定為工單建立者？
4. 暫不支援
5. 可否進行跨租戶的提單？
6. 暫不支援
7. 透過機器人新建的工作項是否會校驗必填
8. 不會，目前透過openapi新建工作項不會校驗必填表單
9. 沒有空間訪問許可權的人員是否能用機器人建單
10. 可以，因為建立工單時呼叫的是固定的userkey，只要外掛配置的usekey有新建許可權且該人員有飛書機器人的使用許可權即可

{ "scopes": { "tenant": [ "contact:contact.base:readonly", "contact:user.base:readonly", "im:message.group_at_msg:readonly", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot" ], "user": [ "contact:contact.base:readonly", "contact:user.base:readonly", "im:message:readonly" ] } }