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.
To set up a meeting users can schedule a date by providing the day, month, and/or year. Users can also specify phrases such as "today", "tomorrow", "noon", “next monday”, or certain US holidays to schedule events.
Below are the supported holidays:
New Years' Day
Valentines Day
Martin Luther King Jr. Day
Presidents' Day
Saint Patrick’s Day
Easter
Memorial Day
Juneteenth
Independence Day
Labor Day
Columbus Day
Veterans' Day
Halloween
Thanksgiving
Christmas Eve
Christmas Day
New Years Eve
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.
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
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.