Updates to Slack, GroupMe, sample links, next steps (#194)

MicrosoftDocs · RobStand · Aug 7, 2017 · Jul 7, 2017 · Jul 7, 2017 · Jul 8, 2017
commit 6de5e70e0ca8ecb42120aba033d161f7d8a78364
diff --git a/articles/azure/azure-bot-service-continuous-integration.md b/articles/azure/azure-bot-service-continuous-integration.md
@@ -2,7 +2,7 @@
 title: Set up continuous integration for a bot that is built using Azure Bot Service | Microsoft Docs
 description: Learn how to set up continuous integration for a bot that is built using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-debug-bot.md b/articles/azure/azure-bot-service-debug-bot.md
@@ -2,7 +2,7 @@
 title: Debug a bot built using Azure Bot Service | Microsoft Docs
 description: Learn how to debug a bot built using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-overview.md b/articles/azure/azure-bot-service-overview.md
@@ -2,7 +2,7 @@
 title: Azure Bot Service | Microsoft Docs
 description: Learn about the Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-quickstart.md b/articles/azure/azure-bot-service-quickstart.md
@@ -2,7 +2,7 @@
 title: Create a bot with the Azure Bot Service | Microsoft Docs
 description: Create a bot with the Azure Bot Service, an integrated, dedicated bot development environment.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-template-basic.md b/articles/azure/azure-bot-service-template-basic.md
@@ -2,7 +2,7 @@
 title: Create a basic bot using Azure Bot Service | Microsoft Docs
 description: Learn how to create a basic bot using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-template-form.md b/articles/azure/azure-bot-service-template-form.md
@@ -2,7 +2,7 @@
 title: Create a form bot using Azure Bot Service | Microsoft Docs
 description: Learn how to create a form bot using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-template-language-understanding.md b/articles/azure/azure-bot-service-template-language-understanding.md
@@ -2,7 +2,7 @@
 title: Create a language understanding bot using Azure Bot Service | Microsoft Docs
 description: Learn how to create a language understanding bot using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-template-proactive.md b/articles/azure/azure-bot-service-template-proactive.md
@@ -2,7 +2,7 @@
 title: Create a proactive bot using Azure Bot Service | Microsoft Docs
 description: Learn how to create a proactive bot using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-template-question-and-answer.md b/articles/azure/azure-bot-service-template-question-and-answer.md
@@ -2,7 +2,7 @@
 title: Create a question and answer bot using Azure Bot Service | Microsoft Docs
 description: Learn how to create a question and answer bot using Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/azure/azure-bot-service-templates.md b/articles/azure/azure-bot-service-templates.md
@@ -2,7 +2,7 @@
 title: Templates in the Azure Bot Service | Microsoft Docs
 description: Learn about templates in the Azure Bot Service.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/bot-builder-overview-getstarted.md b/articles/bot-builder-overview-getstarted.md
@@ -2,7 +2,7 @@
 title: Start building bots with the Bot Framework | Microsoft Docs
 description: Get started building powerful bots with the Bot Framework and Bot Builder SDKs.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: get-started-article
 ms.prod: bot-framework

diff --git a/articles/bot-design-pattern-knowledge-base.md b/articles/bot-design-pattern-knowledge-base.md
@@ -206,10 +206,8 @@ you could trigger a [BasicQnAMakerDialog][qnamakerTemplate] to initiate the proc
 
 ## Sample code
 
-For a complete sample that shows how to create a basic knowledge bot using the Bot Builder SDK for .NET, see the <a href="https://github.com/Microsoft/BotBuilder-Samples/tree/master/CSharp/sample-KnowledgeBot" target="_blank">Knowledge Bot sample</a> in GitHub. 
-For a complete samples that show how to create more complex knowledge bots using the Bot Builder SDK for .NET, see the <a href="https://github.com/Microsoft/BotBuilder/tree/master/CSharp/Samples/SearchPoweredBots" target="_blank">Search-powered Bots sample</a> in GitHub.
-
-For a complete sample that shows how to create a basic knowledge bot using the Bot Builder SDK for Node.js, see the <a href="https://github.com/Microsoft/BotBuilder-Samples/tree/master/Node/sample-knowledgeBot" target="_blank">Knowledge Bot sample</a> in GitHub.
+- For a sample that shows how to create a basic knowledge bot using the Bot Builder SDK for .NET, see the <a href="https://github.com/Microsoft/BotBuilder-Samples/tree/master/CSharp/sample-KnowledgeBot" target="_blank">Knowledge Bot sample</a> in GitHub. 
+- For a sample that shows how to create more complex knowledge bots using the Bot Builder SDK for .NET, see the <a href="https://github.com/Microsoft/BotBuilder-Samples/tree/master/CSharp/demo-Search" target="_blank">Search-powered Bots sample</a> in GitHub.
 
 ## Additional resources
 

diff --git a/articles/channel-connect-directline.md b/articles/channel-connect-directline.md
@@ -2,7 +2,7 @@
 title: Connect a bot to Direct Line | Microsoft Docs
 description: Learn how to configure a bot's connection to Direct Line.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/channel-connect-groupme.md b/articles/channel-connect-groupme.md
@@ -23,25 +23,23 @@ If you don't have a GroupMe account, [sign up for a new account](https://web.gro
 
 [Create a GroupMe application](https://dev.groupme.com/applications/new) for your bot.
 
-Use this callback URL: <code>https://groupme.botframework.com/Home/Login</code>
+Use this callback URL: `https://groupme.botframework.com/Home/Login`
 
 ![Create app](~/media/channels/GM-StepApp.png)
 
 ## Gather credentials
 
-Copy the **Client ID** section from the redirect URL.
+1. In the **Redirect URL** field, copy the value after **client_id=**.
+2. Copy the **Access Token** value.
 
-![Copy client ID](~/media/channels/GM-StepClientId.png)
+![Copy client ID and access token](~/media/channels/GM-StepClientId.png)
 
-## Submit credentials
-
-1. Paste the Client ID you just copied into the **Client ID** field.
-2. Click **Submit GroupMe Credentials**.
-![Enter credentials](~/media/channels/GM-StepApp.png)
 
-## Enable the bot
-Check **Enable this bot on GroupMe**. Then click **I'm done configuring GroupMe**.
+## Submit credentials
 
-When you have completed these steps, your bot will be successfully configured to communicate with users in GroupMe.
+1. On dev.botframework.com, paste the **client_id** value you just copied into the **Client ID** field.
+2. Paste the **Access Token** value into the **Access Token** field.
+2. Click **Save**.
 
+![Enter credentials](~/media/channels/GM-StepClientIDToken.png)
 
diff --git a/articles/channel-connect-slack.md b/articles/channel-connect-slack.md
@@ -25,9 +25,10 @@ Enter an App Name and select a Development Slack Team. If you are not already a
 
 ![Create app](~/media/channels/slack-CreateApp.png)
 
-Click Create App. Slack will create your app and generate a Client ID and Client Secret.
+Click **Create App**. Slack will create your app and generate a Client ID and Client Secret.
 
 ## Add a new Redirect URL
+
 Next you will add a new Redirect URL.
 
 1. Select the **OAuth & Permissions** tab. 
@@ -38,29 +39,50 @@ Next you will add a new Redirect URL.
 
 ![Add Redirect URL](~/media/channels/slack-RedirectURL.png)
 
+## Subscribe to Bot Events
+
+By subscribing to bot events, your app will be notified of user activities at the URL you specify.
+
+1. Select the **Event Subscriptions** tab.
+2. Click **Enable Events** to **On**.
+3. In **Request URL**, enter this URL, but replace `{YourBotHandle}` with your bot handle.
+        `https://slack.botframework.com/api/Events/{YourBotHandle}`
+4. In **Subscribe to Bot Events**, click **Add Bot User Event**.
+5. In the list of events, click Add **Bot User Event** to subscribe to these six event types:
+    * `member_joined_channel`
+    * `member_left_channel`
+    * `message.channels`
+    * `message.groups`
+    * `message.im`
+    * `message.mpim`
+6. Click **Save Changes**.
+
+![Subscribe to Events](~/media/channels/slack-EnableEvents.png)
+
 ## Create a Slack Bot User
+
 Adding a Bot User allows you to assign a username for your bot and choose whether it is always shown as online.
 
 1. Select the **Bot Users** tab.
 2. Click **Add a Bot User**.
 
 ![Create bot](~/media/channels/slack-CreateBot.png)
 
-Click **Add Bot User** to validate your settings, and then click **Save Changes**. 
+Click **Add Bot User** to validate your settings, click **Always Show My Bot as Online** to **On**, and then click **Save Changes**.
 
 ![Create bot](~/media/channels/slack-CreateApp-AddBotUser.png)
 
 ## Add and Configure Interactive Messages (optional)
 
-If your bot will use Slack-specific functionality such as buttons, select the **Interactive Messages** tab and click **Enable Interactive Messages.
+If your bot will use Slack-specific functionality such as buttons, select the **Interactive Messages** tab and click **Enable Interactive Messages**.
 
 1. Enter https://slack.botframework.com/api/Actions as the Request URL for Interactive Messages.
 2. Click the **Enable Interactive Messages** button and **Save changes** once the URL is successfully validated.
 
 ![Enable messages](~/media/channels/slack-MessageURL.png)
 
 ## Gather credentials
-Select the **Basic Information** tab and scroll to the **App Credentials** section. The Client ID, Client Secret and optional Verification Token required for configuration of your Slack bot are displayed.
+Select the **Basic Information** tab and scroll to the **App Credentials** section. The Client ID, Client Secret, and Verification Token required for configuration of your Slack bot are displayed.
 
 ![Gather credentials](~/media/channels/slack-AppCredentials.png)
 

diff --git a/articles/deploy-bot-overview.md b/articles/deploy-bot-overview.md
@@ -2,7 +2,7 @@
 title: Deploy a bot to the cloud | Microsoft Docs
 description: Learn how to deploy a bot to Azure.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-activities.md b/articles/dotnet/bot-builder-dotnet-activities.md
@@ -2,7 +2,7 @@
 title: Activities overview | Microsoft Docs
 description: Learn about the different activity types available within the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-add-input-hints.md b/articles/dotnet/bot-builder-dotnet-add-input-hints.md
@@ -2,7 +2,7 @@
 title: Add input hints to messages | Microsoft Docs
 description: Learn how to add input hints to messages using the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-add-media-attachments.md b/articles/dotnet/bot-builder-dotnet-add-media-attachments.md
@@ -2,7 +2,7 @@
 title: Add media attachments to messages | Microsoft Docs
 description: Learn how to add media attachments to messages using the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-add-rich-card-attachments.md b/articles/dotnet/bot-builder-dotnet-add-rich-card-attachments.md
@@ -2,7 +2,7 @@
 title: Add rich card attachments to messages | Microsoft Docs
 description: Learn how to add rich cards to messages using the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-add-suggested-actions.md b/articles/dotnet/bot-builder-dotnet-add-suggested-actions.md
@@ -2,7 +2,7 @@
 title: Add suggested actions to messages | Microsoft Docs
 description: Learn how to add suggested actions to messages using the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-audio-calls.md b/articles/dotnet/bot-builder-dotnet-audio-calls.md
@@ -2,7 +2,7 @@
 title: Conduct audio calls with Skype | Microsoft Docs
 description: Learn how to conduct audio calls with Skype using the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-channeldata.md b/articles/dotnet/bot-builder-dotnet-channeldata.md
@@ -2,7 +2,7 @@
 title: Implement channel-specific functionality | Microsoft Docs
 description: Learn how to implement channel-specific functionality using the the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-concepts.md b/articles/dotnet/bot-builder-dotnet-concepts.md
@@ -2,7 +2,7 @@
 title: Key concepts in the Bot Builder SDK for .NET | Microsoft Docs
 description: Understand the key concepts and tools for building and deploying conversational bots available in the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework
@@ -61,15 +61,12 @@ transported over the wire.
 You should ensure that your bot's endpoint can only be called by the Bot Framework Connector service. 
 For more information on this topic, see [Secure your bot](bot-builder-dotnet-security.md).
 
-## Additional resources
+## Next steps
 
-- [Bot Builder SDK for .NET](bot-builder-dotnet-overview.md)
-- [Create a bot with the Bot Builder SDK for .NET](bot-builder-dotnet-quickstart.md)
-- [Activities overview](bot-builder-dotnet-activities.md)
-- [Dialogs](bot-builder-dotnet-dialogs.md)
-- [Design and control conversation flow](../bot-design-conversation-flow.md)
-- [Secure your bot](bot-builder-dotnet-security.md)
-- <a href="https://docs.microsoft.com/en-us/dotnet/api/?view=botbuilder-3.8" target="_blank">Bot Builder SDK for .NET Reference</a>
+Now you know the concepts behind every bot. You can quickly [build a bot using Visual Studio](bot-builder-dotnet-quickstart.md) using a template. Next, study each key concept in more detail, starting with dialogs.
+
+> [!div class="nextstepaction"]
+> [Dialogs in the Bot Builder SDK for .NET](bot-builder-dotnet-dialogs.md)
 
 [connectorLibrary]: https://docs.microsoft.com/en-us/dotnet/api/microsoft.bot.connector?view=botbuilder-3.8
 

diff --git a/articles/dotnet/bot-builder-dotnet-connector.md b/articles/dotnet/bot-builder-dotnet-connector.md
@@ -2,7 +2,7 @@
 title: Send and receive activities | Microsoft Docs
 description: Learn how to exchange information with a user across various channels by using the Connector service via the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework

diff --git a/articles/dotnet/bot-builder-dotnet-create-messages.md b/articles/dotnet/bot-builder-dotnet-create-messages.md
@@ -2,7 +2,7 @@
 title: Create messages with the Bot Builder SDK for .NET | Microsoft Docs
 description: Learn about commonly-used message properties within the Bot Builder SDK for .NET.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework
@@ -148,6 +148,13 @@ The `Speak` property of a message activity can be used to specify the text to be
 
 The `SuggestedActions` property of a message activity can be used to present buttons that the user can tap to provide input. Unlike buttons that appear within rich cards (which remain visable and accessible to the user even after being tapped), buttons that appear within the suggested actions pane will disappear after the user makes a selection. For details, see [Add suggested actions to messages](bot-builder-dotnet-add-suggested-actions.md).
 
+## Next steps
+
+A bot and a user can send messages to each other. When the message is more complex, your bot can send a rich card in a message to the user. Rich cards cover many presentation and interaction scenarios commonly needed in most bots.
+
+> [!div class="nextstepaction"]
+> [Send a rich card in a message](bot-builder-dotnet-add-rich-card-attachments.md)
+
 ## Additional resources
 
 - [Activities overview](bot-builder-dotnet-activities.md)
@@ -158,4 +165,4 @@ The `SuggestedActions` property of a message activity can be used to present but
 - [Add suggested actions to messages](bot-builder-dotnet-add-suggested-actions.md)
 - [Implement channel-specific functionality](bot-builder-dotnet-channeldata.md)
 - <a href="https://docs.microsoft.com/en-us/dotnet/api/microsoft.bot.connector.activity?view=botbuilder-3.8" target="_blank">Activity class</a>
-- <a href="https://docs.microsoft.com/en-us/dotnet/api/microsoft.bot.connector.imessageactivity?view=botbuilder-3.8" target="_blank">IMessageActivity interface</a>
+- <a href="https://docs.microsoft.com/en-us/dotnet/api/microsoft.bot.connector.imessageactivity?view=botbuilder-3.8" target="_blank">IMessageActivity interface</a>
diff --git a/articles/dotnet/bot-builder-dotnet-dialogs.md b/articles/dotnet/bot-builder-dotnet-dialogs.md
@@ -2,7 +2,7 @@
 title: Dialogs overview | Microsoft Docs
 description: Learn how to use dialogs within the Bot Builder SDK for .NET to model conversations and manage conversation flow.
 author: kbrandl
-ms.author: v-kibran
+ms.author: kibrandl
 manager: rstand
 ms.topic: article
 ms.prod: bot-framework
@@ -202,14 +202,13 @@ If `Chain.Switch<T, R>` returns a nested `IDialog<IDialog<T>>`, then the inner `
 
 [!code-csharp[Chain.Switch](../includes/code/dotnet-dialogs.cs#chain5)]
 
-## Additional resources
+## Next steps
+
+Dialogs manage conversation flow between a bot and a user. A dialog defines how to interact with a user. A bot can use many dialogs organized in stacks to guide the conversation with the user. In the next section, see how the dialog stack grows and shrinks as you create and dismiss dialogs in the stack.
+
+> [!div class="nextstepaction"]
+> [Manage conversation flow with dialogs](bot-builder-dotnet-manage-conversation-flow.md)
 
-- [Key concepts in the Bot Builder SDK for .NET](bot-builder-dotnet-concepts.md)
-- [Design and control conversation flow](../bot-design-conversation-flow.md)
-- [Manage conversation flow with dialogs](bot-builder-dotnet-manage-conversation-flow.md)
-- [Enable language understanding with LUIS](bot-builder-dotnet-luis-dialogs.md)
-- [Bot Framework troubleshooting guide](../troubleshoot-general-problems.md)
-- <a href="https://docs.microsoft.com/en-us/dotnet/api/?view=botbuilder-3.8" target="_blank">Bot Builder SDK for .NET Reference</a>
 
 [builderLibrary]: https://docs.microsoft.com/en-us/dotnet/api/microsoft.bot.builder.dialogs?view=botbuilder-3.8