When you configure the OBTP feature for the calendar service, the softkey Calendar displays 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 Join to join a meeting from the calendar list.


 
Currently, only the English language is supported for this feature.

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.

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

Apply to use the application Cisco Phone OBTP in Microsoft Entra gallery

Apply to use the application Cisco Phone OBTP in Microsoft Entra gallery

In order for Microsoft 365 to trust the Cisco phone and send the calendar items to the phone, Cisco creates an application called Cisco Phone OBTP and lists it in Microsoft Entra Gallery, see the following example of Cisco Video Phone 8875:

Microsoft tenant screenshot

To get the Microsoft tenant access, do the following:

Contact your Microsoft Tenant administrator to grant the access to you.

For more information about how to add an application, see https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/add-application-portal

Cisco Phone OBTP requires the following permissions to read the calendar and keep the calendar info on phone:

  • Calendars.Read
  • offline_access

For more information about the API, see https://learn.microsoft.com/en-us/graph/api/user-list-calendarview?view=graph-rest-1.0&tabs=http