- 홈
- /
- 문서
Webex Calling용 Microsoft Teams 구성
조직에 Webex Calling 사용자에 대한 기본 통화 옵션으로 해당 통화를 설치합니다.
Use this article to configure your Microsoft Teams app with Webex Calling options. The icon is added to the left navigation and as a Messaging extension. Teams 통화 옵션이 꺼진 경우, 조직에 있는 모든 사람은 동일한 플랫폼을 사용하여 전화를 걸고 받을 수 있습니다.
전제 조건
-
Make sure you’re a Microsoft Teams administrator.
-
Make sure you have access to the Control Hub.
-
Verify that users have assigned licenses in Control Hub and registered to Cisco Unified Communications Manager, or Webex Calling for making calls.
-
Users must have Webex App and Microsoft Teams installed.
-
For the Webex Calling for Microsoft Teams integration to work with the Unified CM call control backend (on-premises, Webex Calling Dedicated Instance or UCM Cloud), ensure you are on Unified CM 12.5 SU7 or 14 SU3, Cisco Unity Connection (CUC) 12.5 or 14.
-
For On-prem Unified CM customers, ensure Unified CM & CUC clusters are on-boarded to Webex Cloud-Connected UC (CCUC).
-
사용자는 온-프레미스 Active Directory 또는 Azure와 같은 클라우드 AD에서 Control Hub 공통 ID(CI)로 동기화되어야 합니다.
-
For on-premises, Webex Calling Dedicated Instance, and UCM Cloud customers, Configure Cisco Unified CM—The line number on Cisco Unified CM needs to be associated to the User ID for the Call History to be populated with the username. From Cisco Unified CM Administration, use the Device → Phone, select the phone and click on the Device Name (Line) and then click the required line from Association panel to get to User Associated with Line.
-
Make sure that the Unified CM Mail ID matches the Control Hub Primary email which is used to obtain the Universally Unique Identifier (UUID).
-
Virtual Desktop Infrastructure (VDI): When Webex Calling integration for Microsoft Teams is used in a VDI environment, both Webex Calling and Microsoft Teams must be running in the same virtual machine.
Microsoft Teams configuration
1 |
Sign in to Teams admin center to manage your apps and allow Webex Calling. |
2 |
Manage third-party apps in your Permission policies to allow Webex Calling. |
3 |
Install Webex Calling, then add the icon to the Webex App and unpin the built-in calling option. |
4 |
Optional––disable the built-in calling option org-wide and make Webex Calling the only call option: |
Accept presence sync permissions
Review and accept the presence sync permissions in Microsoft Teams to bidirectionally synchronize the user’s presence status between Microsoft Teams and Webex.
1 |
In the Dashboard menu, go to and check if the following permissions are included.
|
2 |
Click Accept to accept the permissions. |
3 |
Perform one of the following ways to ensure that new permissions are showing up as granted:
The following permissions should be observed in the admin consent:
Once you've verified the permissions, enable the presence sync in the Control Hub. Refer Enable bidirectional presence sync section. |
Permissions for Webex Calling and Microsoft Teams integration
The integration service uses Webex and Microsoft APIs to access data, such as call history, for displaying and updating statuses, such as marking voicemails as read, without storing any user data. All data transfers between the integration and the Webex/Microsoft backends occur over encrypted HTTPS channels. Thereby, the service ensures that user data are not stored in the cloud, strengthening the data privacy and security.
We request the minimum required permissions from Microsoft to call Microsoft API for enabling the integration functionality. The following table describes each permission that we request and why it's required.
권한 | 이유 |
---|---|
offline_access | Allows the integration service to generate a new access token without asking the user to re-authorize often |
User.Read | Allows the integration service to read the user's basic information such as the email address |
User.ReadWrite | Allows the integration service to store speed dials in user profiles |
User.Read.All | Allows the integration service to search for users in the active directory to make calls |
Contacts.Read | Allows the integration service to search for the user's outlook contact to make calls |
Presence.Read.All | Allows the integration service to subscribe for presence status changes |
채널멤버.읽기.모두 | Allows the integration message extension to read members of a channel so that the user can search for a specific channel member to call |
Chat.ReadBasic | Allows the integration message extension to read members of a group chat so that the user can search for a specific member to call |
Presence.ReadWrite.All | Allow the integration service to subscribe for presence status change notifications |
Control Hub configuration
You can configure and enable the following features in Control Hub to make them available for Microsoft Teams users.
Hide Webex App window
You can configure to hide the Webex App window when users interact with the Webex Calling integration with Microsoft Teams. For more information on the configuration, see: Configure to hide Webex App window for Microsoft Teams users.
You can use the public APIs to hide the Webex App window in the Microsoft Teams client. See Update an organization's MS Teams setting for details.
Enable multi call window
Multi call window is a separate, floating window that helps users to manage multiple or shared lines in a single window. Users can make and receive calls, see the status of all lines, and have better access to features like hold, transfer, and barge, without changing to another window.
1 |
From the customer view in https://admin.webex.com., go to . |
2 |
Go to In-call feature access section, and under Additional features, toggle on Display multi call window and choose one of the following options:
|
3 |
Go to Microsoft Teams integration section, and turn on the Set Microsoft Teams as the default app for multi-call window toggle. After you turn on this option, when the user clicks the voicemail and missed call icons from the multi call window, it cross-launches to the Microsoft Teams Webex Calling instead of Webex App. This toggle is grayed out if you haven't enabled the Display multi call window as mentioned in the step 2.
You can configure this feature at user-group level by navigating to Microsoft Teams integration. and >You can configure this feature at user level by navigating to Microsoft Teams integration. and > |
Enable bidirectional presence sync
You can enable a bidirectional presence sync feature to synchronize the user’s presence status between Microsoft Teams and Webex bidirectionally. The presence status includes In a call, In a meeting, Presenting, and Do not disturb.
After enabling this feature, when a user makes or receives a Webex call, their Microsoft Teams status gets changed to In a call. When they enable Do not disturb in the Webex App or any Webex device, the status is automatically synchronized to Microsoft Teams. Similarly, the In a meeting and Presenting statuses synchronizes between applications.
When Do not disturb is enabled on user's Webex App or any Webex device, they won’t get any notification of incoming call and messages in Webex App, Webex device or Microsoft Teams.
You can also use public API to enable Webex Calling presence synchronization with the MS Teams client. See Update an organization's MS Teams setting for details.
The following table shows the bidirectional status sync representation between Webex and Microsoft Teams.
Webex 상태 |
Microsoft Teams status |
---|---|
On a call |
In a call |
In a meeting (This status syncs only from Webex to Teams) |
In a call |
Presenting |
Presenting |
방해 금지 |
방해 금지 |
1 |
From the customer view in https://admin.webex.com., go to Services, and then click . |
2 |
Go to the Microsoft Teams integration section and turn on the Presence sync toggle. You can turn on the Hide Webex Window toggle for the best experience, but it's optional. |
3 |
Go to the Do Not Disturb (DND) Status Sync section and turn on the toggle. |
Enable voicemail
You can enable voicemail for the users to access it. The voicemail feature is enabled by default for Webex Calling, Dedicated Instance, and UCM Cloud customers.
For more information on enabling voicemail for Webex Calling users, see: Configure and manage voicemail settings for a Webex Calling user.
For more information on enabling voicemail for BroadWorks users, see Enabling Voicemail for Microsoft Teams Integration.
Enable call history
Call History feature is enabled by default for Webex Calling, Dedicated Instance, and UCM Cloud customers.
BroadWorks 관리자가 이 기능이 올바르게 통화 기록 통합된 시스템 활성화를 활성화해야 합니다. 자세한 내용은 Cisco BroadWorks 구성 안내서의 Webex를 참조하십시오.
To enable voicemail, call history and bidirectional presence sync service for on-prem Unified CM customers, perform the following steps:
Voicemail service enabled for on-prem customers takes a maximum of 12 hours to activate.
1 |
From the customer view in https://admin.webex.com., go to Services > Connected UC. UC 관리 카드에서 인벤토리를 클릭합니다. 설명, 상태, 클러스터 및 노드가 포함된 클러스터 그룹의 목록이 나타납니다. | ||||
2 |
Perform the following actions:
선택한 클러스터 그룹에 소속된 클러스터의 목록을 표시하는 인벤토리 페이지가 나타납니다. | ||||
3 |
특정 제품 노드가 소속된 클러스터 옆에 있는 세부 사항을 클릭합니다. 버전, 제품 및 상태가 포함된 노드 이름이 나타납니다. | ||||
4 |
이벤트 히스토리 옆에 있는 줄임표 ⋮ 아이콘을 클릭하고 서비스 관리를 선택합니다. 서비스의 목록과 함께 서비스 관리 페이지가 나타납니다. | ||||
5 |
Use the toggle button to enable the Voicemail, Centralized Call History and Presence status sync.
| ||||
6 |
제출을 클릭합니다. | ||||
7 |
If the Data Collection Confirmation pop-up is displayed, agree to it by enabling the check box and click Submit. |