會議整合

簡介：

飛書日程整合外掛超好用！在Meegle裡，它能把重要專案日程當作工作項管理，輕鬆完成日程建立與更新。會議一結束，參會明細自動同步。搭配Meegle度量系統，還能快速分析會議效率，讓專案管理更高效 。

外掛配置

在正式使用外掛前，需要進行一些基礎配置來保證Meegle與飛書日程之間的互通性。 日曆整合外掛會使用飛書應用機器人進行會議api的相關操作，首先在飛書開放平臺（open.feishu.cn）新建應用，應用建完後需要申請一系列的許可權及配置；

1. 開啟機器人能力 在“新增應用能力”Tab頁新增機器人能力

1. 配置重定向地址 SaaS環境地址配置地址為：https://project.feishu.cn/m-api/v1/builtin_app/sync_calendar/oauth/page（如果是私有化部署，將域名部分替換為對應的私有化部署域名即可） 如果是海外環境，配置時需要做域名區分 SG：https://project-sg.feishu.cn/m-api/v1/builtin_app/sync_calendar/oauth/page JP：https://project-jp.feishu.cn/m-api/v1/builtin_app/sync_calendar/oauth/page VA：https://project-va.feishu.cn/m-api/v1/builtin_app/sync_calendar/oauth/page

1. 開啟重新整理access token開關 在“安全設定”Tab頁開啟重新整理user_access_token的開關，如果設定頁面沒有此Tab頁，則預設就是處於開啟的狀態，無需額外操作了。

1. 許可權配置

在“許可權管理”Tab頁需要開通如下許可權 應用身份：

1. calendar:calendar (更新日曆及日程資訊)
2. calendar:calendar:readonly (獲取日曆、日程及忙閒資訊)
3. vc:meeting.all_meeting:readonly (獲取所有視訊會議資訊)
4. ~~vc:meeting:readonly (獲取會議資訊，新版本該許可權已去掉)~~
5. vc:record:readonly (獲取會議錄製資訊)
6. vc:reserve (更新會議預約資訊)
7. vc:reserve:readonly (獲取會議預約資訊)
8. vc:meeting.meetingevent:read (獲取會議資訊)

9. vc:meeting.meetingid:read (獲取會議id) 使用者身份：

10. calendar:calendar (更新日曆及日程資訊)

11. calendar:calendar.acl:create (新增日曆訪問控制許可權)
12. calendar:calendar:readonly (獲取日曆、日程及忙閒資訊)
13. offline_access (離線訪問已授權資料)
14. vc:reserve (更新會議預約資訊)
15. vc:reserve:readonly (獲取會議預約資訊)
16. vc:meeting.meetingevent:read (獲取會議資訊)
17. vc:meeting.meetingid:read (獲取會議id)

18. 新增事件能力 在“事件與回撥”Tab頁事件配置中，新增事件地址： SaaS環境地址為：https://project.feishu.cn/m-api/v1/builtin_app/sync_calendar/call_back （如果是私有化部署，將域名部分替換為對應的私有化部署域名即可） 如果是海外環境，配置時需要做域名區分 SG：https://project-sg.feishu.cn/m-api/v1/builtin_app/sync_calendar/call_back JP：https://project-jp.feishu.cn/m-api/v1/builtin_app/sync_calendar/call_back VA：https://project-va.feishu.cn/m-api/v1/builtin_app/sync_calendar/call_back 新增事件：

19. vc.meeting.all_meeting_started_v1 （企業會議開始）

20. vc.meeting.all_meeting_ended_v1 （企業會議結束）

1. 設定該應用的可用範圍 在進行應用釋出時，需要配置該應用的可用範圍，只有在該範圍內的成員才可以使用，否則會報無許可權錯誤。

日程工作項配置 安裝外掛後，外掛會自動生成一個日程工作項，並做好欄位對映，也支援關聯其他自定義工作項

使用實踐

前置說明（必讀）

該外掛的設計思路是透過整合統一管理專案會議，並透過參會人的資料統計，來進一步分析專案會議的會議質量，是否有低效會議等。首先對外掛裡的幾個控制元件進行說明：

1. 預計參與者：指在建立會議日程時，預期參會人。比如一次需求技術評審，預期參會人可能是該需求的前後端研發工程師，測試工程師。
2. 日程參與者：指在飛書日曆日程裡顯示的參與者，如果從外掛裡建立的日程，預設日程參與者等於預計參與者，但實際情況裡，日程參與者可能發現還需要引入其他人，依然是技術評審的舉例，後端研發可能在接到會議後判斷需要引入其他模組的研發一起進行評審，從而補充參會人。
3. 實際參與者：指視訊會議過程中真實加入會議的人員。會議結束後，外掛會自動統計這部分參會人員的參會時間明細。 透過以上三組資料的對比，使用者可以進一步分析出會議組織者建立會議的精準度，從而進行改進。

場景一：Meegle上建立日程

1. 外掛配置完成後，在導航進入日程工作項即可以開始新建日程

1. 工作項建立後，在詳情頁透過“建立日程”按鈕可以完成飛書日程的同步建立，建立日程時，會自動帶入下方的預計參與者。

1. 日程建立後，“建立日程”按鈕會展示為“開啟會議”，點選可以快速拉起飛書會議。

1. 會議完成後，自動同步會議資料到工作項欄位，可用於進一步做會議效能分析。

1. 手動同步日程預計參與人 在日程建立後，日程裡的屬性資訊除了預計參會人，都會在日程工作項欄位更新時自動同步到飛書日程中。預計參會人欄位需要手動同步，同步方式如下。

場景二：飛書日程已完成會議，資料同步到Meegle

該方式不建議作為主要使用路徑，建議專案會議規範建立流程，該方式作為兜底策略使用。

1. 在Meegle裡，新建日程工作項例項。
2. 在會議連結控制元件輸入會議連結並失焦後，會自動搜尋當前日期前後7天內的日程資料，找到匹配的日程時間後，點選按鈕“儲存並從飛書同步”，將自動同步日程標題、組織者、參會人、參會明細等資料。

FAQ

1. 已經建立的日程，在飛書側更新日程標題、描述等資訊，會自動同步回工作項日程嗎？ 不支援：主場景是在Meegle流程中建立會議並推到日曆，這種會議應該是在流程中被定義出來，如果發生了更新，也應該是使用者判斷是否要拉回來更新Meegle會議資訊，Meegle這邊應該是作為流程規範存在的