TỔNG QUAN VỀ PHẦN MỞ RỘNG NHẮN TIN MICROSOFT REFLECT CHO TEAMS

Chúng ta phát triển mạnh mẽ khi chúng ta được làm việc và học tập trong những môi trường hỗ trợ sức khỏe tinh thần của chúng ta. Đây là những môi trường mà chúng ta cảm thấy được lắng nghe, có giá trị, an toàn và được trở thành một phần.

Các nhà lãnh đạo nhóm (ví dụ, lãnh đạo cuộc họp, người quản lý, giáo viên) đấu tranh để thu thập thông tin về trạng thái cảm xúc của từng thành viên trong nhóm của họ, nhưng thông tin này rất hữu ích để hiểu cách hỗ trợ sự tham gia, năng suất, hợp tác, phúc lợi và nội bộ của nhóm họ -các mối quan hệ nhóm.

Tiện ích nhắn tin Reflect giúp các thành viên trong nhóm nhận thức rõ hơn về trạng thái cảm xúc của chính họ và của nhau trong quá trình giao tiếp bằng cách cung cấp cho họ khả năng tạo các đăng ký cảm xúc đơn giản, hiệu quả và hấp dẫn trực tiếp trong quá trình trò chuyện trong Teams.

Các nhà lãnh đạo nhóm có thể kiểm tra với các thành viên trong nhóm của họ về cảm giác chung của họ hoặc về một chủ đề cụ thể, chẳng hạn như nhiệm vụ, kinh nghiệm học tập hoặc làm việc tại nhà, hoặc các sự kiện hiện tại trong cộng đồng của họ.

Các tính năng chính

  • Phù hợp với nghiên cứu mới nhất và các phương pháp hay nhất để học tập cảm xúc xã hội, tâm lý tổ chức và môi trường hỗ trợ tình cảm
  • Có sẵn dưới dạng tiện ích mở rộng trò chuyện cho thảo luận kênh, trò chuyện nhóm và cuộc họp cũng như trong các cuộc trò chuyện 1: 1
  • Bao gồm danh sách các câu hỏi đăng ký được đề xuất và cung cấp khả năng tạo các câu hỏi tùy chỉnh để đăng ký với đồng nghiệp
  • Có thể đặt đăng ký để phản hồi là công khai, riêng tư đối với người gửi hoặc ẩn danh hoàn toàn
  • Chạy trên dịch vụ Azure của chính tổ chức
  • Các nguồn thông tin phát triển chuyên môn cho các nhà giáo dục có sẵn tại:  https://aka.ms/checking-in-with-students  và https://aka.ms/remote-wellbeing

Hướng dẫn triển khai Reflect

Điều kiện tiên quyết

Để bắt đầu, bạn sẽ cần:

  • Quyền truy cập của quản trị viên đối với tenant nơi bạn muốn triển khai Reflect
  • Một công cụ soạn thảo văn bản (ví dụ: VS Code) để chỉnh sửa các tệp JSON
  • Có kinh nghiệm làm việc trong Visual Studio và quen với việc phát triển và triển khai các giải pháp dữ liệu trên Azure (lý tưởng là kinh nghiệm triển khai các gói và ứng dụng)
  • Tên cho ứng dụng Teams của bạn. Ví dụ: “Reflect”
  • Đăng ký Azure nơi bạn có thể tạo các loại tài nguyên sau:

+ Azure Function

+ App service

+ App service plan

+ Bot channels registration

+ Storage account

+ Application Insights

Video hướng dẫn quy trình triển khai có sẵn tại đây:

Tóm tắt các bước để triển khai Reflect:

  1. Tạo một ứng dụng Azure AD mới.
  2. Tạo mẫu tùy chỉnh mới để triển khai bằng cách sử dụng mẫu ARM được cung cấp trong thư mục Triển khai trong repo Reflect GitHub. Mẫu ARM sẽ tự động tạo các nhóm tài nguyên và tài nguyên cần thiết cho dịch vụ Reflect và sau đó triển khai mã nguồn cho Reflect trong Azure.
  3. Sử dụng cổng quản trị Azure để cho phép bot Reflect mới được tạo sẵn có trong Teams.
  4. Cập nhật tệp kê khai Reflect và cài đặt ứng dụng Reflect cho Teams.

Bước 1: Đăng ký ứng dụng Azure AD

Bước đầu tiên là tạo đăng ký ứng dụng cho bot. Thao tác này sẽ tạo Application ID và App Secret mà chúng tôi sẽ sử dụng sau này khi xây dựng mẫu. Làm theo các bước dưới đây để đăng ký ứng dụng Azure AD trong danh bạ của tenant cho tiện ích nhắn tin.

  1. Đăng nhập vào Azure Portal để đăng ký và truy cập trang “App registrations” tại
https://portal.azure.com/#blade/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/RegisteredApps.
  1. Chọn “New registration” và cung cấp tên cho ứng dụng (bất kỳ chuỗi văn bản chữ thường nào không có dấu cách đều được) và chọn tùy chọn thích hợp cho môi trường đối tượng thuê của bạn (Single, Multitenant, Multitenant + Microsoft account hoặc chỉ tài khoản Microsoft) và sau đó nhấp vào “Register”.
  2. Name : Tên ứng dụng Teams của bạn. Ví dụ, “Reflect”.
  3. Supported account types: Chọn “Accounts in any organizational directory.”
  4. Để trống trường “Redirect URI”.

Lưu ý: Nếu bạn không chắc nên chọn tùy chọn đối tượng nào, hãy chọn tùy chọn thứ hai trong danh sách cho ứng dụng nhiều đối tượng.

  • Bấm vào nút “Register”
  • Khi ứng dụng được đăng ký, bạn sẽ được đưa đến trang “Overview” của ứng dụng. Sao chép Application (client) ID; chúng ta sẽ cần chúng sau này.
  • Trên thanh bên trong phần Manage, điều hướng đến phần “Certificates & secrets”. Trong phần Client secrets, nhấp vào “+ New client secret”. Thêm mô tả cho bí mật và chọn khung thời gian cho thời điểm bí mật hết hạn. Nhấp vào “Add”.
  • Khi client secret được tạo, hãy sao chép Value của nó; chúng ta sẽ cần nó sau.

Tại thời điểm này, bạn có 2 giá trị duy nhất:

  • Application (client) ID cho bot
  • Client secret cho bot

Chúng tôi khuyên bạn nên sao chép các giá trị này vào một tệp văn bản, sử dụng một ứng dụng như Notepad. Chúng ta sẽ cần những giá trị này sau.

Bước 2: Triển khai mẫu ứng dụng mới

  1. Đăng nhập vào cổng Azure, chọn + Create a resource, rồi nhập ” Template “.
  • Chọn tùy chọn “Template deployment (deploy using custom templates” và sau đó tạo.
  • Nhấp vào “Build your own template” trong trình chỉnh sửa.
  • Từ GitHub repo for Reflect, chuyển đến thư mục Deployment và nhấp vào tệp có tiêu đề “ReflectARMTemplate.json”. Sao chép tất cả văn bản trong tệp .json và dán vào trình chỉnh sửa json trong Azure cho mẫu tùy chỉnh mới của bạn. (Lưu ý: bạn đang thay thế tất cả văn bản mặc định trong mẫu mặc định bằng văn bản bạn đã sao chép từ GitHub).
  • Nhấp vào ” Save”.
  • Từ các thuộc tính và giá trị được tạo từ mẫu, hãy chỉnh sửa các giá trị nếu cần như: Subscription, provide a new resource group name và web app service name.
  • Sao chép và dán Application ID và App Secret được tạo ở Bước 1 vào các trường có nhãn Bot ID và Bot Client Secret
  • Application ID –> Bot ID
  • App Secret –> Bot Client Secret

Lưu ý:

  • Mặc dù, biểu mẫu ” Custom deployment” chỉ ra rằng chỉ các trường Subscription và Bot Client Secret là bắt buộc, cần phải nhập giá trị cho tất cả các trường được hiển thị trong phần Parameters của biểu mẫu ” Custom deployment”.
  • Không giống như trong hình ảnh ví dụ dưới đây, Azure không cho phép không gian trong trường Web App Service.
  • Nếu xác nhận thành công, sau đó nhấp vào nút ” Create” bên dưới.
  • Hãy để triển khai chạy và nó sẽ tạo tất cả các tài nguyên cần thiết theo nhóm tài nguyên được chỉ định.

Bước 3: Thêm bot vào Teams Channel

  1. Chuyển đến nhóm tài nguyên bạn vừa tạo. Ở bên phải, chúng ta thấy các tài nguyên đang được tạo.
  2. Trong màn hình Nhóm Resource, nhấp vào tài nguyên Web App Bot được liệt kê trong phần có nhãn ” Essentials”
  • Sau khi nhấp vào Web App Bot trong màn hình Resource Groups, bạn sẽ được đưa đến phần tổng quan về Web App Bot. Từ đây, nhấp vào ” Channels” ở menu bên trái.
  • Từ màn hình ” Channels”, nhấp vào Teams để thêm nhóm làm kênh cho bot Reflect.
  • Trong cửa sổ Configure Microsoft Teams, chọn tùy chọn có nhãn “Microsoft Teams Commercial” và nhấp vào Save.

THẬN TRỌNG: Sau khi triển khai mẫu ARM hoàn tất, điều quan trọng là phải xác nhận rằng cài đặt cho ” Supported account types” khớp với những gì đã được đặt khi bạn tạo mẫu. Để thực hiện việc này, trong cổng Azure, hãy điều hướng đến Reflect app registration bạn đã tạo ở Bước 1 và đảm bảo rằng các Supported account types phù hợp với yêu cầu tổ chức của bạn (Người thuê đơn hoặc Người thuê nhiều).

Bước 4: Cập nhật tệp Reflect manifest cho đối tượng thuê của bạn và sau đó cài đặt tệp đó trong Teams.

  1. Tải về một bản sao của thư mục Manifest từ Reflect GitHub repo ở đây: https://github.com/OfficeDev/Microsoft-Teams-App-Reflect/tree/main/Manifest
  2. Sử dụng trình soạn thảo văn bản hoặc Mã VS để mở tệp Reflect manifest (tên tệp: tệp kê khai.json) và thay thế trường id trên dòng 5 bằng bất kỳ GUID duy nhất nào. (Lưu ý: bạn có thể tạo GUID mới cho trường này bằng cách sử dụng bất kỳ trình tạo GUID trực tuyến nào (ví dụ: https://www.guidgenerator.com/) Đồng thời thay thế trường botId trên dòng 31 và 41 bằng Application ID mà chúng ta đã lưu ở Bước 1.
  3. Lưu ý: Đảm bảo loại bỏ dấu ngoặc nhọn (tức là dấu ngoặc nhọn) khi dán giá trị GUID ở dòng 5 và cả cho trường botId ở dòng 31 và 41. Giá trị GUID giữa các dấu ngoặc kép chỉ nên chứa số, chữ cái và dấu gạch ngang.
  4. Thay đổi trường placeholder trong bản kê thành các giá trị phù hợp với tổ chức của bạn.
  5. developer.name
  6. developer.websiteUrl
  7. developer.privacyUrl
  8. developer.termsOfUseUrl
  9. Tạo gói ZIP với tệp manifest.json, color.png và outline.png. Hai tệp hình ảnh là biểu tượng cho ứng dụng của bạn trong Teams.
  10. Đảm bảo rằng 3 tệp là cấp cao nhất của gói ZIP, không có thư mục lồng nhau.

Bước 5: Chạy các ứng dụng trong Microsoft Teams

  1. Nếu tenant của bạn đã bật ứng dụng tải xuống, bạn có thể cài đặt ứng dụng của mình cho một nhóm bằng cách làm theo hướng dẫn bên dưới
  2. Tải gói lên nhóm bằng tab Apps: https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/apps/apps-upload#upload-your-package-into-a-team-using-the-apps-tab
  3. Tải gói lên một nhóm bằng Store: https://docs.microsoft.com/en-us/microsoftteams/platform/concepts/apps/apps-upload#upload-your-package-into-a-team-or-conversation-using-the-store
  4. Bạn cũng có thể tải nó lên danh mục ứng dụng của người thuê để mọi người trong đối tượng thuê của bạn có thể cài đặt: https://docs.microsoft.com/en-us/microsoftteams/tenant-apps-catalog-teams
  5. Cài đặt ứng dụng cho một nhóm.

Bước 6: Đặt Reflect thành ứng dụng ” pinned” cho tất cả tenant

Các bước trên dẫn đến việc Reflect khả dụng cho người dùng trong đối tượng thuê của bạn nhưng họ vẫn cần tự cài đặt nó theo cách thủ công nếu muốn sử dụng nó trong các cuộc trò chuyện trong Teams của họ. Để đảm bảo rằng Reflect được cài đặt và hiển thị cho tất cả người dùng của bạn, hãy sử dụng Trung tâm quản trị Microsoft Teams để quản lý chính sách thiết lập ứng dụng cho Reflect để nó xuất hiện dưới dạng ứng dụng ” pinned” trong Teams cho tất cả người dùng của bạn.

Bạn có thể tìm thấy thông tin chi tiết về cách quản lý chính sách thiết lập ứng dụng trong Teams tại đây:  https://docs.microsoft.com/en-us/MicrosoftTeams/teams-app-setup-policies

Tổng quan về Kiến trúc & Giải pháp

Các vấn đề đã biết:

Các cuộc thăm dò Reflect được lên lịch vào sáng hôm sau đôi khi có thể đăng muộn hơn ~ 30 phút so với dự kiến. Đây là kết quả của việc các Teams đưa bot Reflect vào trạng thái ngủ sau một thời gian dài không hoạt động trong cuộc trò chuyện.

Bài viết thuộc về: www.office365vietnam.info

Ý kiến của bạn:

This site uses Akismet to reduce spam. Learn how your comment data is processed.