Working with the Persistent Chat Platform in Lync 2013

1. Working with the Persistent Chat Platform in Lync 2013

2. Session Objectives • Persistent Chat in the Lync API • Persistent Chat Add-Ins • Working with the Persistent Chat Server SDK

3. Agenda Overview Persistent Chat in the Lync API Persistent Chat Add-Ins Persistent Chat Server SDK Working with the Persistent Chat Platform in Lync 2013

4. Overview

5. Persistent Chat Platform Components • Persistent Chat support added to client-side Lync 2013 SDK • Delivered as managed APIs • New in Lync 2013 • Lync 2013 Persistent Chat PowerShell® interfaces • PowerShell cmdlets to administer and manage Persistent Chat • Lync 2013 Persistent Chat Server SDK • Introduced with OCS 2007 R2; was the only API available for Persistent Chat • Lync 2013 continues supporting and enhancing this SDK • Separate install • Delivered as managed APIs that build on UCMA • Applications run on Lync Server (e.g., BOTs)

6. Persistent Chat in Lync 2013 • Consistent user experience • Message history is persisted in the room • Stories • Rich permissions structure • Extensible using the Lync Managed API • Interact with rooms and their events • Build an add-in that runs in the room

7. Room Management Add-In • Extend the functionality of a room • Web application hosted in IIS • Interact with the room using the Lync API Category • Set options for rooms in the category • Set Allowed Members • Set Denied Members • Set Creators Room • Inherit settings defined in the category • Set room type • Associate an add-in • Set Managers • Set Members • Room types • Normal • Auditorium Management PowerShell cmdlets or using the Lync Server Control Panel Management Futures End-user interface for managing rooms Room Add-Ins Extend the room’s functionality using an add-in; e.g. display relevant news items sent by a bot

8. Persistent Chat in the Lync Client

9. Agenda Overview Persistent Chat in the Lync API Persistent Chat Add-Ins Persistent Chat Server SDK Working with the Persistent Chat Platform in Lync 2013

10. Persistent Chat in the Lync API

11. Working with Persistent Chat using the Lync API RoomManager Accessible through LyncClient class Get a room by its URI Search for rooms Follow and un-follow rooms Subscribe to room events Participant Added / Removed Messages Received Unread Message Count Changed

12. Working with Persistent Chat using the Lync API Send Messages to a Room Message types Regular Alert Story Plain text or RTF Filter Messages Call Room.EnableOutgoingMessageFilter() Take action on messages before they are sent to the room

13. Persistent Chat PowerShell cmdlets – Categories • # Create a Persistent Chat Category • New-CsPersistentChatCategory–Name <String> • # Set the allowed members of the Category • Set-CsPersistentChatCategory -Identity <Identity> • -AllowedMembers @("<Active Directory Container">) • # Set users who are allowed to create Rooms in the Category • Set-CsPersistentChatCategory -Identity <Identity> • -Creators sip:username@contoso.com • # Indicate if users are notified when invited to a Room in the Category • Set-CsPersistentChatCategory –Identity <Identity> • -Invitations <Boolean>

14. Persistent Chat PowerShell cmdlets – Rooms • # Create a Room in a Category • New-CsPersistentChatRoom–Name <String> • -Category <String> • -Description <String> • # Set the Managers of the Room • Set-CsPersistentChatRoom • -Identity <Identity> • -Managers <Managers> • # Set the Members of the Room • Set-CsPersistentChatRoom • -Identity <Identity> • -Members <Members>

15. Working with Persistent Chat in the Lync API

16. Agenda Overview Persistent Chat in the Lync API Persistent Chat Add-Ins Persistent Chat Server SDK Working with the Persistent Chat Platform in Lync 2013

17. Persistent Chat Add-Ins

18. Persistent Chat Add-Ins Extend the Functionality of a Room Add-ins run in the extension pane of the conversation window Can access the room Can retrieve messages from the room Can send messages to the room and apply filters to messages Scenarios Display messages from a bot Show grouped message history of the room Provide companion LOB application in room

19. Add-In Development and Deployment Development Experience Build in Silverlight Call LyncClient.GetHostingRoom()method to get handle to room Management Deploy to IIS Associate an add-in with a room PowerShell cmdlets, Lync Server Control Panel, or Persistent Chat Server SDK

20. Persistent Chat PowerShell cmdlets – Addins • # Create a new Addin • New-CsPersistentChatAddin • -Name <String> • -PersistentChatPoolFqdn<String> • -Url <String> • # Associate the Addin with a Room • Set-CsPersistentChatRoom • -Identity <String> • -Addin <String>

21. Persistent Chat Message History Add-In

22. Agenda Overview Persistent Chat in the Lync API Persistent Chat Add-Ins Persistent Chat Server SDK Working with the Persistent Chat Platform in Lync 2013

23. Persistent Chat Server SDK

24. Persistent Chat Server SDK Scenarios Room Participation Post messages, query room directory and content, chat history Upload/download files Throttling participant list updates BOTs in a Room Automated participants posting content to a room

25. Persistent Chat Server SDK Scenarios Associate Add-Ins to a Room Associate add-ins with Persistent Chat rooms to extend the in-room experience End User Room Creation and Management Customize room creation and management workflows Hook into Lync client entry point

26. Persistent Chat PowerShell cmdlets – Endpoints • # Create a new Persistent Chat Endpoint • New-CsPersistentChatEndpoint • -SipAddress<String> • -PersistentChatPoolFqdn<String>

27. Working with the Persistent Chat Server SDK

28. Agenda Overview Persistent Chat in the Lync API Persistent Chat Add-Ins Persistent Chat Server SDK Working with the Persistent Chat Platform in Lync 2013

29. Key takeaways • Interact with Persistent Chat using the Lync API • Build Persistent Chat add-ins using the Lync API • Manage Persistent Chat using PowerShell cmdlets, and Lync Server Control Panel • Interact with and manage Persistent Chat using the Persistent Chat Server SDK

30. thank you

31. © 2011 Microsoft Corporation. All rights reserved. Microsoft, Windows, Windows Vista 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.