This sample demonstrates how to integrate Microsoft Graph capabilities into a UWP app that uses Cortana voice commands.
C#
Latest commit efdf972 Oct 21, 2016 @PaulStubbs PaulStubbs committed on GitHub Update README.md
Updated app registration text.

README.md

Microsoft Graph MeetingBot sample for UWP

Table of contents

Introduction

This sample demonstrates how to integrate Microsoft Graph capabilities into a UWP app that uses Cortana voice commands. Once you've installed it and signed in, you can activate it by asking Cortana to show the next meeting on your calendar and/or asking Cortana to tell the participants of your next meeting that you're running late.

It uses the Microsoft Graph .NET Client Library to work with data returned by Microsoft Graph. The sample uses the v2.0 authentication endpoint, which enables users to sign in with either their personal or work or school Microsoft accounts.

Prerequisites

This sample requires the following:

Register and configure the app

  1. Sign into the App Registration Portal using either your personal or work or school account.
  2. Select Add an app.
  3. Enter a name for the app, and select Create application.

    The registration page displays, listing the properties of your app.

  4. Under Platforms, select Add platform.

  5. Select Mobile platform.
  6. Copy the Application Id to the clipboard. You'll need to enter this value into the sample app.

    The app id is a unique identifier for your app. The redirect URI is a unique URI provided by Windows 10 for each application to ensure that messages sent to that URI are only sent to that application.

  7. Select Save.

Build and debug

Note: If you see any errors while installing packages during step 2, make sure the local path where you placed the solution is not too long/deep. Moving the solution closer to the root of your drive resolves this issue.

  1. After you've loaded the solution in Visual Studio, configure the sample to use the application id that you registered by adding the corresponding values for these keys in the Application.Resources node of the App.xaml file. Microsoft Graph MeetingBot sample

  2. Press F5 to build and debug. Run the solution and sign in with either your personal or work or school account.

Running the sample

When you first run the sample, you'll be prompted to sign in with your Microsoft or Office 365 for business account. After you've authenticated and consented to the required permissions, you won't have to sign in again unless you want to run the sample with another account.

If you want to sign out and then sign in with a different account, select the disconnect button at the top right of the app and then select the connect button to its left.

After you've installed and run the app once, you can activate it at any time by issuing the following voice commands to Cortana:

  1. "MeetingBot, show my next meeting."
  2. "MeetingBot, tell my next meeting I'm going to be late."

If you've enabled the "Hey Cortana" feature, you can activate the app at any time by issuing these voice commands to your device:

  1. "Hey Cortana, ask MeetingBot to show my next meeting."
  2. "Hey Cortana, ask MeetingBot to tell my next meeting I'm going to be late."

In both cases, the app will launch and display the title and time frame of your next meeting. If you ask MeetingBot to tell your next meeting that you're going to be late, the app will either confirm that it has sent a "running late" message to your next meeting's participants, or it will tell you that it couldn't find the meeting invitation in your account's mailbox.

Microsoft Graph MeetingBot sample

Contributing

If you'd like to contribute to this sample, see CONTRIBUTING.MD.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Questions and comments

We'd love to get your feedback about the Microsoft Graph MeetingBot for UWP project. You can send your questions and suggestions to us in the Issues section of this repository.

Your feedback is important to us. Connect with us on Stack Overflow. Tag your questions with [MicrosoftGraph].

Additional resources

Copyright

Copyright (c) 2016 Microsoft. All rights reserved.