Skill - Microsoft Event Scheduling Skill

Overview

This Skill gives the Digital Person the ability to conversationally schedule a Microsoft Outlook meeting. The Skill is triggered by saying Create/Setup/Schedule (an event)/(a meeting). You must give a date, time, and title to the event that will be created. Once the event is created, the user may add attendees to the meeting that may be other Microsoft Users or Groups. Uses the Microsoft Office 365 Graph API to find people in an organization and get their calendar information.

This skill is:

Built and owned by Soul Machines Ltd.
Only supported in English.
Powered by the Microsoft Graph API

Limitations

The current version of the skill cannot edit or delete events. If you would like to edit or delete an event, you must log on to Microsoft Outlook and make changes there.
The current version also does not support adding multiple users in the same sentence. If you would like to add multiple users quickly, make sure they are all a part of a Microsoft Outlook Group and you can add the group to an event.

Requirements

Must support content cards

Skill Demo

Screen Recording 2022-07-18 at 3.43.09 PM.mov

Configurations

Provide the following information in the Microsoft Event Scheduling Skill configuration screen in Digital DNA Studio. See Adding Skills to your Digital Person for detailed instructions:

Field	Type	Description
APPLICATION ID FOR AUTHENTICATION (required)	`TEXT`	This is a required field used for authentication. It is a unique identifier assigned to you by the Microsoft identity platform. Instructions for how to obtain it is provided in the next section.
CLIENT SECRET FOR AUTHENTICATION (required)	`TEXT`	This is a required field used for authentication. It is a password that your app uses to authenticate with the Microsoft identity platform. Instructions for how to obtain it is provided in the next section.
DIRECTORY/ORGANIZATION ID FOR AUTHENTICATION (required)	`TEXT`	It is a unique identifier assigned to your organization by the Microsoft identity platform. Instructions for how to obtain it is provided in the next section.
THE EMAIL OF THE USER WHO WILL HOST THE MEETINGS (required)	`TEXT`	This field allows you to set the email of the event organizer. This person will be the host of the meeting. In addition, this person’s timezone setting in Outlook will be the timezone of the event that is added.
SPOKEN PHRASE WHEN IT CAN'T HANDLE THE REQUEST	`TEXT`	This is an optional field to set the response from the Digital Person cannot handle the request. The default is `Sorry, I did not understand that`.

Obtaining Application ID and Client Secret from Graph API

In order to access Microsoft’s Graph API, create an app on the https://portal.azure.com/#home Portal. Have a working Microsoft account ready. Follow the steps on this page: https://docs.microsoft.com/en-us/graph/auth-register-app-v2.
There are three required fields needed to authenticate an access token for use with Microsoft’s Graph API. Once you have successfully registered your app, you will be given an Application ID, Client Secret, and Directory/Tenant/Organization ID. You may wish to save these somewhere because you will be unable to see the client secret again after generation. If you lose your client secret, you can generate a new one.

Add permissions to the app

The last thing needed is to make sure the correct permissions are approved for this app. The permissions needed for this skill are given below.

For more information, you can navigate to this page: https://docs.microsoft.com/en-us/graph/auth/auth-concepts