Chuyển tới nội dung chính

Cấu hình Microsoft Teams

Thiết lập TEAMS Office 365​

1. Cài đặt mô-đun Teams​

  • Chạy lệnh sau để xác nhận xem bạn đã cài đặt mô-đun PowerShell của Teams thành công hay chưa: Get-Module -ListAvailable -Name MicrosoftTeams. Nếu cài đặt thành công, bạn sẽ thấy kết quả dưới đây:

PowerShell Teams Module Check

  • Nếu bạn không thể thấy kết quả, điều đó có nghĩa là mô-đun PowerShell chưa được cài đặt đúng cách, vui lòng truy cập https://www.powershellgallery.com/packages/MicrosoftTeams/ để cài đặt thủ công.
  • Nếu có mô-đun Teams mới hơn, bạn có thể sử dụng lệnh dưới đây để nâng cấp:
Install-Module -Name MicrosoftTeams -Force

PowerShell Teams Module Installation

2. Tạo tên miền của bạn trong Office 365 tenant​

  • Đăng nhập vào tài khoản quản trị Office 365 của bạn và tạo tên miền của bạn. Trong trung tâm quản trị Microsoft 365, đi tới Setup (Thiết lập). Sau đó nhấn nút View (Xem) cho phần Get your custom domain set up (Thiết lập tên miền tùy chỉnh của bạn), sau đó là nút Manage (Quản lý). Thêm một tên miền ở đó.
  • Chọn một tên miền (ví dụ: skyx.cc) mà bạn sở hữu.

⚠️ Cảnh báo: Vì nó sẽ được Microsoft xác minh, ví dụ bằng cách bạn dán một giá trị vào trường giá trị TXT của DNS của bạn hoặc đăng nhập vào tài khoản nơi bạn có tên miền, v.v. Điều quan trọng là bạn phải sở hữu tên miền và có thể thực hiện quá trình xác minh. Sau khi hoàn tất, tên miền sẽ được tạo và bạn có thể thêm người dùng vào đó.

3. Tạo người dùng trong tên miền đó​

Bây giờ bạn có thể tạo người dùng dưới tên miền bạn vừa tạo ở bước 1 ở trên.

Một lần nữa, trong trung tâm quản trị Microsoft 365, đi tới Active users (Người dùng hoạt động) dưới Users (Người dùng) và Add a user (Thêm người dùng). Nhập tên và họ của người dùng (ví dụ: "Thomas Oliveri") và dưới tên người dùng, nhập một tên duy nhất sẽ là email của anh/cô ấy.

⚠️ Cảnh báo: Đảm bảo chọn tên miền bạn đã tạo ở trên cho phần tên miền của tên người dùng (ví dụ: skyx.cc trong ví dụ này) chứ không phải bất kỳ tên miền nào khác *.onmicrosoft.com.

Bằng cách đó, người dùng sẽ nằm trong tên miền bạn vừa tạo ở bước 1 ở trên (trong ví dụ này là: thomas@skyx.cc).

Create User in Domain

4. Sử dụng PowerShell để kết nối với tài khoản Office 365 của bạn​

  • Mở cửa sổ dòng lệnh Windows PowerShell và chạy các lệnh sau:
Import-Module MicrosoftTeams
$userCredential = Get-Credential
Connect-MicrosoftTeams -Credential $userCredential
  • Trong hộp thoại Windows PowerShell Credential Request, nhập tên tài khoản quản trị viên và mật khẩu của bạn, sau đó nhấn OK. Chỉ cần phần "Connect using a Skype for Business Online administrator account name and password" là đủ trừ khi bạn muốn làm nhiều hơn.
  • Nếu bạn nhận được lỗi "cannot be loaded because running scripts is disabled on this system", thì chạy lệnh sau để điều chỉnh quyền:
Set-ExecutionPolicy RemoteSigned

PowerShell Connection

5. Tạo một PSTN gateway sẽ kết nối với SBC​

  • Đảm bảo nó là đúng và được kết nối với đúng tài khoản như bạn đã làm ở các bước trên. Để xác nhận các bước đã được thực hiện đúng, sử dụng lệnh:
Get-Command *onlinePSTNGateway*

Lệnh của bạn sẽ trả về bốn chức năng được hiển thị ở đây sẽ cho phép bạn quản lý SBC.

  • Sử dụng PowerShell, tạo một PSTN gateway sẽ kết nối với SkyX SBC bằng FQDN của tên miền, ví dụ: sbc.skyx.cc. Lưu ý, bạn phải có một chứng chỉ hợp lệ cho tên miền sbc.skyx.cc hoặc một chứng chỉ đại diện (wildcard certificate) cho skyx.cc.
  • Phần tên miền của FQDN này phải khớp với tên miền đã đăng ký trong tenant của bạn như ở bước "Create users in that domain" ở trên (ví dụ: nó có thể là: sbc.skyx.cc, vì tên miền bạn đã tạo là skyx.cc).
  • Điều quan trọng nữa là phải có một người dùng Office 365 trong tên miền đó (như bạn đã làm ở các bước trên, một người dùng trong skyx.cc) và một giấy phép E3 hoặc E5 được gán. Nếu không, bạn sẽ nhận được lỗi: "Can not use the sbc.skyx.cc domain as it is not configured for this tenant."
  • FQDN này (ví dụ sbc.skyx.cc) phải phân giải thành một IP có thể truy cập được của SkyX SBC, Định tuyến trực tiếp Teams sẽ định tuyến các cuộc gọi đến SkyX SBC bằng FQDN này: FQDN này (trong ví dụ này là sbc.skyx.cc) phải là một tên miền SIP trong SkyX PBX. Bạn phải đảm bảo rằng một bản ghi DNS A được tạo cho tên miền đó (ví dụ: sbc.skyx.cc) sẽ đến được SkyX SBC. Một chứng chỉ hợp lệ phải được thêm vào SkyX SBC cho tên miền này.

Ví dụ lệnh PowerShell để tạo PSTN gateway:

New-CsOnlinePSTNGateway -Identity sbc.skyx.cc -Enabled $true -SipSignalingPort 5067 -MaxConcurrentSessions 1000

🚨 Cảnh báo: Cổng 5067 trong các lệnh trên đề cập đến cổng TLS của SkyX PBX (SBC); theo mặc định, SkyX PBX (SBC) tạo truyền tải TLS trên cổng 5067 cho Teams; nếu bạn đã thay đổi cổng TLS mặc định cho Teams trong SkyX PBX (SBC), vui lòng thay thế 5067 bằng cổng TLS mới trong các lệnh trên.

Bạn có thể kiểm tra các tham số gateway bất cứ lúc nào với:

Get-CsOnlinePSTNGateway -Identity sbc.skyx

PSTN Gateway Configuration

6. Kích hoạt người dùng cho dịch vụ định tuyến trực tiếp​

  • Định tuyến trực tiếp yêu cầu người dùng phải được đăng ký trên Skype for Business Online. Bạn có thể kiểm tra điều này bằng cách xem tham số RegistrarPool. Nó cần có một giá trị trong miền infra.lync.com.

Lệnh PowerShell:

Get-CsOnlineUser -Identity "email" | fl RegistrarPool

Ví dụ:

Get-CsOnlineUser -Identity "thomas@skyx.cc" | fl RegistrarPool
  • Sử dụng PowerShell, kích hoạt người dùng cho dịch vụ định tuyến trực tiếp bằng cách cấu hình số điện thoại và bật thoại doanh nghiệp và hộp thư thoại cho người dùng.
  • Sử dụng PowerShell, kích hoạt người dùng cho dịch vụ định tuyến trực tiếp bằng cách cấu hình số điện thoại và bật thoại doanh nghiệp và hộp thư thoại cho người dùng. Lưu ý, đó là số 4 chữ số theo ví dụ của chúng ta, nhưng nó có thể là một số E.164 đầy đủ. Đối với ví dụ này, chúng ta muốn sử dụng người dùng làm máy nhánh (và ở đây 1001 là máy nhánh cho người dùng này) có thể kết nối và có thể được kết nối như một máy nhánh giữa TEAMS và SkyX PBX.
  • Các cuộc gọi đến và đi PSTN hoặc SIP trunk có thể được xử lý bởi trunk của SkyX PBX giống như bất kỳ PBX nào và người dùng trên TEAMS có thể hoạt động như các máy nhánh của PBX. Nhưng bạn có thể dễ dàng sử dụng các thiết lập và kịch bản khác và gán các số E.164 đầy đủ (với mã quốc gia) cho người dùng.
Set-CsPhoneNumberAssignment -Identity thomas@skyx.cc -PhoneNumber +1001 -PhoneNumberType DirectRouting
Set-CsPhoneNumberAssignment -Identity thomas@skyx.cc -EnterpriseVoiceEnabled $true

Lưu ý: Có thể mất một thời gian giữa việc tạo người dùng trong Teams và có thể thay đổi cài đặt của nó ở đây với Set-CsUser hoặc Set-CsPhoneNumberAssignment, vì vậy bạn có thể phải đợi một hoặc hai giờ nếu nó báo lỗi như người dùng không tồn tại và bạn đã đảm bảo rằng email (hoặc tên) người dùng là chính xác.

Người dùng giờ đây có thể nhận cuộc gọi từ SkyX PBX, dù là từ các máy nhánh trên chính SkyX PBX hay từ PSTN và SIP trunks (được thiết lập trong SkyX PBX), tùy từng trường hợp.

7. Cấu hình định tuyến thoại cho các cuộc gọi đi đến SkyX PBX​

Bây giờ bạn có thể cấu hình các quy tắc về thời điểm sử dụng thiết lập PSTN gateway để định tuyến cuộc gọi đến SkyX PBX.

Như đã giải thích trong tài liệu của Microsoft, Microsoft Teams có một cơ chế định tuyến cho phép một cuộc gọi được gửi đến một SBC cụ thể dựa trên:

  • Mẫu số được gọi
  • Mẫu số được gọi + Người dùng cụ thể thực hiện cuộc gọi

Định tuyến cuộc gọi bao gồm:

  • Online PSTN Gateway: Nó kết nối với SBC hoặc PBX (trong trường hợp này là SkyX SBC). Nó cũng lưu trữ cấu hình được áp dụng khi một cuộc gọi được thực hiện qua SBC, chẳng hạn như chuyển tiếp P-Asserted-Identity (PAI) hoặc Preferred Codecs. Nó được sử dụng bởi Voice Routes.
  • Voice Route: Nó sử dụng Online PSTN Gateways để sử dụng cho các cuộc gọi mà số gọi khớp với mẫu.
  • PSTN Usage: Nó sử dụng Voice Routes và các PSTN Usages khác. Các Chính sách định tuyến thoại (Voice Routing Policies) khác nhau có thể sử dụng nó.
  • Voice Routing Policy: Nó sử dụng PSTN Usages. Nó có thể được gán cho một người dùng hoặc cho nhiều người dùng.

Tóm lại:

User > Voice routing policy > PSTN usage > Voice route > PSTN gateway.

Trong ví dụ của chúng ta, vì chúng ta sử dụng người dùng làm máy nhánh của SkyX PBX, chúng ta muốn cuộc gọi đầu tiên đến đó và sử dụng các kế hoạch quay số trong SkyX PBX để định tuyến cuộc gọi. Có thể dễ dàng triển khai các kịch bản khác. Đối với kịch bản đơn giản này, hãy tạo:

Thomas Oliveri (Người dùng) > MyPolicy (Chính sách thoại) > MyUsage (Sử dụng PSTN) > sbc.skyx.cc (PSTN gateway).

Hãy tạo usage trước vì nó sẽ được sử dụng trong route:

Set-CsOnlinePstnUsage -Identity Global -Usage @{Add="MyUsage"}

Hãy tạo route bằng SkyX PSTN gateway và usage ở trên:

New-CsOnlineVoiceRoute -Identity "MyRoute" -NumberPattern "^\+(\d{4})|^(\d{4})" -OnlinePstnGatewayList sbc.skyx.cc -Priority 1 -OnlinePstnUsages "MyUsage"

Như bạn có thể thấy, lệnh này tạo một route "MyRoute" nơi TEAMS sẽ chuyển cuộc gọi đến PSTN gateway sbc.skyx.cc (một tên miền trong SkyX PBX) nếu số được quay có ít nhất 4 chữ số (tất nhiên điều này dựa trên ví dụ của chúng ta ở đây, nơi chúng ta muốn cấp cho mỗi người dùng một máy nhánh 4 chữ số, nhưng điều đó tùy thuộc vào thiết lập của bạn), có hoặc không có dấu "+". Bằng cách đó, bạn có thể quay một máy nhánh 4 chữ số hoặc một số E.164 với mã quốc gia và dấu "+".

Tất nhiên, nhiều route có thể được tạo với các ưu tiên khác nhau.

  • Để tìm hiểu các route khác nhau, sử dụng:
Get-CsOnlineVoiceRoute

Hãy tạo một chính sách thoại sử dụng cùng usage mà PSTN gateway của chúng ta được liên kết ở trên:

New-CsOnlineVoiceRoutingPolicy "MyPolicy" -OnlinePstnUsages "MyUsage"

Kết quả cho ví dụ:

Identity         : Tag:MyPolicy
OnlinePstnUsages : {MyUsage}
Description      :
RouteType        : BYOT

Bạn tất nhiên có thể tạo một chính sách với nhiều PSTN Usages, nhưng chúng ta sẽ giữ nó đơn giản và đi thẳng vào vấn đề liên quan đến ví dụ của chúng ta.

Hãy cấp chính sách thoại của chúng ta cho người dùng thomas@skyx.cc:

Grant-CsOnlineVoiceRoutingPolicy -Identity "thomas@skyx.cc" -PolicyName "MyPolicy"

Bạn có thể kiểm tra việc gán chính sách bằng lệnh này:

Get-CsOnlineUser "thomas@skyx.cc" | select OnlineVoiceRoutingPolicy

Bây giờ chính sách quay số đi và định tuyến đã hoàn tất và thomas@skyx.cc có thể gọi đi. Trong ví dụ này, cuộc gọi đi đó sẽ kết thúc trong tên miền SIP của SkyX PBX là sbc.skyx.cc.

Trong ví dụ của chúng ta, chúng ta có thể thiết lập tên miền của bạn trong SkyX PBX (đã giải thích trong phần SkyX PBX) sao cho:

  • Nếu máy nhánh đó (4 chữ số trong trường hợp này) tồn tại trong tên miền SkyX PBX của bạn và đã được đăng ký, nó sẽ được gọi từ người dùng Office 365 của bạn dù đó là điện thoại bàn SIP đã đăng ký với tên miền SIP của SkyX, ứng dụng desktop SkyX, ứng dụng web SkyX hoặc ứng dụng di động SkyX.
  • Nếu máy nhánh đó không tồn tại (ví dụ: một số E.164 10 chữ số, v.v.), thì SkyX PBX sẽ định tuyến cuộc gọi đến một SIP trunk để cuộc gọi có thể được thực hiện.