Merge pull request microsoft#15 from vidrana/patch-2

Updating readme to include ConnectToEngagementHub section

Author: sbacha

ConnectToEngagementHub/README.md

@@ -0,0 +1,28 @@
+# Connect to Engagement Hub
+
+This sample shows the minimum code required for a Power Virtual Agent client to intercept a handoff activity and connect to an engagement hub to transfer conversation to a live agent.
+## Prerequisites
+
+- [.NET Core SDK](https://dotnet.microsoft.com/download) version 2.1
+
+  ```powershell
+  # determine dotnet version
+  dotnet --version
+  ```
+
+## How to try this sample
+- When an end-user interacts with a PVA bot over Directline, messages are sent to client in the form of activities. 
+- In a dialog, when a node to transfer a chat to a live agent is detected, the activities payload contains a handoff activity that is a trigger to transfer the chat.
+- To detect the handoff activity,
+    1. Clone the repository
+    ```bash
+    git clone https://github.com/microsoft/PowerVirtualAgentsSample.git
+    ```
+    2. Add the HandoffHelper and dependent models on the client to intercept activities payload sent over Directline.
+    
+- This helper detects an event activity with name - handoff.initiate.
+- HandoffHelper also parses conversation context (refer to [HandoffContext.cs](./Handoff/HandoffContext.cs)) and the transcript of the conversation between end-user and bot from the handoff.initiate activity.
+- Conversation context and transcript can then be used to write a custom adapter (based on engagement hub APIs) to transfer the chat to a live agent.
+
+## Further reading
+- [Configure hand-off to any generic engagement hub](https://review.docs.microsoft.com/en-us/power-virtual-agents/configure-generic-handoff)

README.md

@@ -4,6 +4,7 @@
 ## Overview
 
 This branch contains samples for connecting your Power Virtual Agents bot to a custom app or to existing [Azure Bot Service channels](/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0). 
+The ConnectToEngagementHub sample contains code for handing off conversations seamlessly and contextually to an Engagement hub.
 
 ## Samples list
 
@@ -20,11 +21,13 @@ To use the samples, clone this GitHub repository using Git.
 |BotConnectorApp | Demonstrates how to connect your bot to a custom app for example mobile-device app   | [View][cs#1]|
 |BuildYourOwnCanvasSamples | Demonstrates how to connect your bot to a custom canvas with various functionality | [View][cs#2] |
 |RelayBotSample | Demonstrates how to connect your bot to existing Azure Bot Service channels | [View][cs#3] |
+|ConnectToEngagementHub | Demonstrates how to detect a handoff activity during a bot conversation and read conversation context | [View][cs#4] |
 
 
 [cs#1]:./BotConnectorApp
 [cs#2]:./BuildYourOwnCanvasSamples
 [cs#3]:./RelayBotSample
+[cs#4]:./ConnectToEngagementHub
 
 
 ## Contributing