1. Microsoft Ignite 2015 4/16/2017 3:41 PM
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

2. Build an add-in for Outlook reaching over 400 Million users!
BRK3156
Build an add-in for Outlook reaching over 400 Million users!
Andrew Salamatov

3. Agenda Let’s build! Platform capabilities & new APIs
4/16/2017
Agenda
Let’s build!
Platform capabilities & new APIs
New UI entry points
Outlook ecosystem
© 2014 Microsoft Corporation. All rights reserved. Microsoft, Windows, and other product names are or may be registered trademarks and/or trademarks in the U.S. and/or other countries. The information herein is for informational purposes only and represents the current view of Microsoft Corporation as of the date of this presentation. Because Microsoft must respond to changing market conditions, it should not be interpreted to be a commitment on the part of Microsoft, and Microsoft cannot guarantee the accuracy of any information provided after the date of this presentation. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

4. Build an add-in across Outlook.com, Outlook and Office 365
4/16/2017 3:41 PM
Build an add-in across Outlook.com, Outlook and Office 365
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

5. Outlook add-in platform
Build 2015
4/16/2017 3:41 PM
Outlook add-in platform
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

6. Add-in capabilities Rule-based activation
Add-ins can appear based on regex match
Based on presence of entities (eg postal address, meeting suggestion)
Based on presence of attachments
Based on type of item
Extensive JS object model API
Access to core item properties in read and compose
Access to body and attachments
Ability to modify fields and add attachments in compose
Launch native reply and new appointment forms
Ability to set custom properties on items
Support for SSO

7. New APIs Available today Coming in Outlook 2016 and soon to O365
Display new reply form with an attachment
Get/set user’s selection from subject or body in compose
Coming in Outlook 2016 and soon to O365
Get full body in read
Get/set full body in compose
Save draft in compose
Close item being composed

8. Demo: Explore Outlook add-ins

9. New entry points

10. Outlook add-in vision Add-ins must feel native and intuitive
Leverage UI framework of host client
Entry points must scale gracefully
Write once, run everywhere

11. Body text highlighting
Outlook will highlight regex matches and entities against plain text body
Clicked on entity or regex match will be passed into add-in
Add-in is loaded in a hover card experience

12. Demo: Add-in commands Build 2015 4/16/2017 3:41 PM
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

13. Add-in commands 1-click way for users to take add-in actions
In Outlook desktop, actions are ribbon buttons and can:
Launch task pane
Execute a JavaScript function without showing UI
Dropdown (menu) with different types of buttons as options [coming later]
Support backwards compatibility

14. Commands UI Scales with the rest of the ribbon
Commands can be on default tab, or create 1 custom tab
Up to 6 buttons per group
1 group on default tab, up to 10 groups on custom tab
Commands that don’t launch UI can show status messages on the mail item or appointment

15. Demo: Build an add-in commands
4/16/2017 3:41 PM
Demo: Build an add-in commands
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

16. Function Buttons Build 2015 4/16/2017 3:41 PM Track
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

17. Function Buttons IE Process FunctionFile.html //JS code
Office.initialize…
function track()
Track

18. Single Sign On Exchange and Outlook.com generate a token
Add-in validates token and maps it to known user id
Token: {
"aud" : "
"iss" :
"nbf" : " ",
"exp" : " ",
"isbrowserhostedapp":"true",
"appctx" : {
"msexchuid" :
"version" : "ExIdTok.V1“,
"amurl" : " }

19. Single Sign On
Add-in
Backend
Mail Server
User in Outlook
Add-in

20. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()

21. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()
Token is generated and
returned to Outlook
Token passed back to add-in

22. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()
Add-in passes token to backend
to validate token and look up user
Token is generated and
returned to Outlook
Token passed back to add-in

23. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()
Add-in passes token to backend
to validate token and look up user
Token is generated and
returned to Outlook
Token passed back to add-in
If user is not found, add-in backend
requests to have user log in

24. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()
Add-in passes token to backend
to validate token and look up user
Token is generated and
returned to Outlook
Token passed back to add-in
Add-in pops up a window
and prompts user to auth
If user is not found, add-in backend
requests to have user log in
Auth Prompt

25. Single Sign On Add-in Backend Mail Server User in Outlook Add-in
Outlook requests token
from server
Add-in calls getUserIdentityTokenAsync()
Add-in passes token to backend
to validate token and look up user
Token is generated and
returned to Outlook
Token passed back to add-in
Add-in pops up a window
and prompts user to auth
If user is not found, add-in backend
requests to have user log in
Auth Prompt
Once user logs in, add-in backend creates
a mapping of uid in token with known
identity

26. Office Store Build 2015 4/16/2017 3:41 PM
© 2015 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

27. Getting add-ins Easy access to the Office Store
End-users can get any add-in from Store
End-users can side-load add-ins

28. Calls to Action
Go to dev.outlook.com for add-ins documentation and resources
Request a preview Outlook.com account to test add-ins by ing us at
Sign up for Office 16 Technical Preview by going to and build add-ins with commands

29. Please evaluate this session
4/16/2017 3:41 PM
Please evaluate this session
Your feedback is important to us!
Visit Myignite at or download and use the Ignite Mobile App with the QR code above.
© 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.

30. 4/16/2017 3:41 PM
© 2014 Microsoft Corporation. All rights reserved. MICROSOFT MAKES NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, AS TO THE INFORMATION IN THIS PRESENTATION.