Set up the calendar service

When you enable the OBTP feature for the calendar service, the softkey Calendar can display on the phone screen. Therefore, users can select this softkey to sign in to the calendar service. After a successful sign-in, the users can directly join different types of meetings on the phone.

When the feature is enabled, the phone gets the calendar items and related meeting links, it can recognize the meeting types if SIP URIs for the supported meeting types are identified. In this way, the Join softkey can display on the calendar item. Then user can select the softkey to join a meeting from a calendar list.

  • Currently, only the English language is supported for this feature.
  • The OBTP feature only supports the Microsoft Office 365 Calendar. The Microsoft Exchange Calendar is not supported.

Before you begin

Cisco Video Integration for Microsoft Teams (VIMT) license is required for each device that joins the meeting. If users join the meeting via third party, the Microsoft Teams CVI license might be required.
1

Do one of the following actions from Cisco Unified CM Administration:

  • To set up the feature for a specific phone:

    Choose Device > Phone and locate the phone that you want to set up.

  • To set up the feature for a group of phones:

    Choose Device > Device Settings > Common Phone Profile and locate the profile that you want to set up.

  • To set up the feature for all phones:

    Choose System > Enterprise Phone Configuration.

2

Ensure that CUCM can dial external SIP URI calls with SIP and expressway setup.

3

Set the following fields:

  • Calendar Service: Enable or disable the service. By default, the service is disabled.
  • Calendar Login Timeout (days): Specifies the number of days for the login duration. The user will automatically log out from the calendar service after the configured days.

    The maximum value is 30. By default, the field is empty.

    If the field is empty, the users remain logged in until they manually log out from the phone.

4

Click Save.

After the configuration, you can see the Calendar softkey or soft button on the phone screen, depending on your phone model.

What to do next

Check Microsoft services access

Check Microsoft services access

The calendar service uses the Microsoft calendar service. Therefore, make sure that the phone can access the following services via the HTTPS protocol:

  • HTTP URLs to get user code, request token:

    https://login.microsoftonline.com/organizations/oauth2/v2.0/devicecode

    https://login.microsoftonline.com/organizations/oauth2/v2.0/token

  • HTTP URLs to retrieve calendar:

    https://graph.microsoft.com/v1.0/me/calendar/calendarView?$orderby=start/dateTime&startDateTime=%s&endDateTime=%s&$select=subject,organizer,attendees,start,end,onlinemeeting,body,isCancelled&$top=%d

  • HTTP URLs to logout:

    https://login.microsoftonline.com/common/oauth2/v2.0/logout

What to do next

Authorize the OBTP application in Entra ID

Authorize the OBTP application in Entra ID

To authorize the Cisco Phone OBTP application in Microsoft Entra ID, you can use one of the methods according to the Microsoft Entra role:

  • The role has admin permissions in Entra ID.
  • The role doesn't have admin permissions in Entra ID.

Enable the OBTP application by using a role that has admin permissions in Entra ID

You can provide the user with an account that has the admin permissions in Entra ID. The admin role can manage applications in the Enterprise Applications Catalog of Entra ID.

By using the account with the admin privileges, the user can directly sign in to the OBTP application on the phone. For example:

Use the provided account to sign in to the OBTP application:

When the users sign in to the OBTP application at the first time, typically they will be prompted to accept the permissions request for the application integration on the phone. For example:

If you want to avoid the permissions request for the users, ensure that the Entra ID is configured to provide the requested permissions on behalf of your organization. For example:

The configuration in Microsoft Entra is out of scope of this article. For more information, see Quickstart: Add an enterprise application.

As the administrator of the Entra ID, you can find the application (for example, "Cisco Phone OBTP") in Entra ID Enterprise applications catalog. The navigation path is: Identity > Applications > Enterprise applications > All applications.

Enable the OBTP service by using a role that doesn't have admin permissions in Entra ID

If you don't have the admin permissions in Entra ID, you need to provide the following URL to the Microsoft Entra administrators for support, so they can authorize the calendar service integration on behalf of the users. The Entra administrators will also create the application (for example, "Cisco Phone OBTP") in Entra ID applications catalog.

URL: https://login.microsoftonline.com/organizations/v2.0/adminconsent?client_id=ac3f3f1a-96b5-4d6a-8449-cba134140123&scope=https%3A%2F%2Fgraph.microsoft.com%2FCalendars.Read%20https%3A%2F%2Fgraph.microsoft.com%2Foffline_access

The Entra ID administrators only need the admin permission in Entra ID. They doesn’t need to exist in Webex or any other application in Enterprise catalog applications.

After the Entra ID administrators approve the OBTP service for the associated Microsoft Tenant, the users can sign in to the Calendar service on the phone.