Calendar Skill

Add calendar capabilities to your Assistant. Powered by Microsoft Graph and Google.

Supported scenarios

The following scenarios are currently supported by the Calendar Skill:

• Accept a Meeting
  • I’ll attend the meeting this afternoon
  • Accept the event sent by Yolanda Wong
• Change an Event
  • Bring forward my 4:00 appointment two hours
  • Reschedule my interview to Tuesday at 1 PM
• Connect to a Meeting
  • Connect me to conference call
  • Connect me with my 2 o’clock meeting
• Create a Meeting
  • Create a meeting tomorrow at 9 AM with Lucy Chen
  • Put anniversary on my calendar
• Delete a Meeting
  • Cancel my meeting at 3 PM today
  • Drop my appointment for Monday
• Find a Meeting
  • Do I have any appointments today?
  • Get to my next event
• Find an Event by Time
  • What day is Lego Land scheduled for?
  • What time is my next appointment?
• Find an Event by Location
  • Where is my meeting with Kayla?
  • Where do I need to be next?
• Find an Event by Attendee
  • Who am I meeting at 10 AM tomorrow?
  • Who is in my next meeting?
• Find an Event’s Duration
  • How long will the next meeting last?
  • What’s the duration of my 4 PM meeting?
• Find a Meeting Room
  • Find a meeting room at 3 PM
  • Is the room 325 open right now?
• Time Remaining
  • How long until my next meeting?
  • How many minutes free do I have before next scheduled appointment?

Language Understanding

LUIS models for the Skill are provided in .lu file format as part of the Skill. Further languages are being prioritized.

Intents

Entities

Configuration

Deployment

Learn how to provision your Azure resources in the Create a Skill tutorial.

Supported content providers

Office 365 and Outlook.com through the Microsoft Graph is supported along with support for Google accounts.

Authentication connection settings

Office 365

This skill uses the following authentication scopes:

• User.ReadBasic.All
• Calendars.ReadWrite
• People.Read
• Contacts.Read

You must use these steps to manually configure Authentication for the Calendar Skill. Due to a change in the Skill architecture this is not currently automated.

Ensure you configure all of the scopes detailed above.

Google Account

To use a Google account follow these steps:

1. Enable Calendar API in Google API library
2. Create your calendar API credential in Google developers console.
   1. Choose “Create credential” - “OAuth Client ID”
   2. Choose “Web Application”
   3. Set Redirect URL as https://token.botframework.com/.auth/web/redirect
3. Create an OAuth connection setting in your Web App Bot.
   • Connection name: googleapi
   • Service Provider: Google
   • Client id and secret are generated in step 2
   • Scopes: https://www.googleapis.com/auth/calendar https://www.googleapis.com/auth/contacts.
4. Add the connection name, client id, secret and scopes in the appsetting.json file.

Meeting Room Booking Support

The Calendar skill provides additional support to search and book meeting rooms. Due to search limitations in Microsoft Graph limiting the experience we leverage Azure Search to provide fuzzy meeting room name matching, floor level, etc.

1. To simplify the process of extracting your meeting room data and inserting into Azure Search we have provided an example PowerShell script. However, you should ensure that displayName, emailAddress, building and floorNumber are populated within your Office 365 tenant (example below). You can do this through the Graph Explorer using the query shown below, this information is required for the Meeting Room booking experience.

   https://graph.microsoft.com/beta/places/microsoft.graph.room

    {
      "value": [
          {
              "id": "94a7966e-b7f8-4466-b0c7-435251dab6eb",
              "displayName": "London ConfRoom Excalibur",
              "emailAddress": "Excalibur@ContosoVirtualAssist.onmicrosoft.com",
              "building": "4",
              "floorNumber": 2,
          },
          {
              "id": "45d9a9b4-ca7f-4cc5-aa50-f4a151bed172",
              "displayName": "London ConfRoom Enterprise",
              "emailAddress": "Enterprise@ContosoVirtualAssist.onmicrosoft.com",
              "building": "4",
              "floorNumber": 1
          },
      ]
    }
   

2. In the Azure Portal, Configure the settings of your registered Calendar Skill app at Azure Active Directory > App registrations
   • This app will request the permission for Place.Read.All scope. There are two ways to grant the consent:
     1. In the API permissions tab, add a permission for Place.Read.All scope, and grant admin consent for your organization.
     2. Make sure your account has permission to access your tenant’s meeting room data so that you can consent on behalf of your organization in the login step, testing the previous query will validate this.
   • In the Authentication tab
     • Toggle Default client type > Treat application as a public client to “Yes”
     • Set Supported account types according to your own requirements
3. Run the following command to install the module:

    Install-Module -Name CosmosDB
   

4. Run the following command:

    ./Deployment/Scripts/enable_findmeetingroom.ps1
   

What do these parameters mean?

You can access all the required parameters from the Deployment step.

When running the script, you will be asked to sign in with your account which can access the meeting room data in the MSGraph.

Follow the general instructions here to configure this using the scopes shown above.

Events

Learn how to use events to send backend data to a Skill, like a user’s location or time zone.

Download a transcript

Download