Josh/link (microsoft#1882)

* adding link unfurling sample

* updating readme

Author: Virtual-Josh

samples/csharp_dotnetcore/55.teams-link-unfurling/AdapterWithErrorHandler.cs

@@ -0,0 +1,25 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using Microsoft.Bot.Builder.Integration.AspNet.Core;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Logging;
+
+namespace Microsoft.BotBuilderSamples
+{
+    public class AdapterWithErrorHandler : BotFrameworkHttpAdapter
+    {
+        public AdapterWithErrorHandler(IConfiguration configuration, ILogger<BotFrameworkHttpAdapter> logger)
+            : base(configuration, logger)
+        {
+            OnTurnError = async (turnContext, exception) =>
+            {
+                // Log any leaked exception from the application.
+                logger.LogError($"Exception caught : {exception.Message}");
+
+                // Send a catch-all apology to the user.
+                await turnContext.SendActivityAsync("Sorry, it looks like something went wrong.");
+            };
+        }
+    }
+}

samples/csharp_dotnetcore/55.teams-link-unfurling/Bots/LinkUnfurlingBot.cs

@@ -0,0 +1,41 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using System.Collections.Generic;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Bot.Builder;
+using Microsoft.Bot.Builder.Teams;
+using Microsoft.Bot.Schema;
+using Microsoft.Bot.Schema.Teams;
+
+namespace Microsoft.BotBuilderSamples.Bots
+{
+    /*
+     * This one exists in JS.
+     */
+    public class LinkUnfurlingBot : TeamsActivityHandler
+    {
+        protected override async Task OnMessageActivityAsync(ITurnContext<IMessageActivity> turnContext, CancellationToken cancellationToken)
+        {
+            await turnContext.SendActivityAsync(MessageFactory.Text($"echo: {turnContext.Activity.Text}"), cancellationToken);
+            await turnContext.SendActivityAsync(
+                MessageFactory.Text("If you copy and paste a link from seattletimes.com the link will unfurl."), cancellationToken);
+        }
+
+        protected override async Task<MessagingExtensionResponse> OnTeamsAppBasedLinkQueryAsync(ITurnContext<IInvokeActivity> turnContext, AppBasedLinkQuery query, CancellationToken cancellationToken)
+        {
+            var heroCard = new ThumbnailCard
+            {
+                Title = "Thumbnail Card",
+                Text = query.Url,
+                Images = new List<CardImage> { new CardImage("https://raw.githubusercontent.com/microsoft/botframework-sdk/master/icon.png") },
+            };
+
+            var attachments = new MessagingExtensionAttachment(HeroCard.ContentType, null, heroCard);
+            var result = new MessagingExtensionResult(AttachmentLayoutTypes.List, "result", new[] { attachments }, null, "test unfurl");
+
+            return new MessagingExtensionResponse(result);
+        }
+    }
+}

samples/csharp_dotnetcore/55.teams-link-unfurling/Controllers/BotController.cs

@@ -0,0 +1,35 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Bot.Builder;
+using Microsoft.Bot.Builder.Integration.AspNet.Core;
+
+namespace Microsoft.BotBuilderSamples.Controllers
+{
+    // This ASP Controller is created to handle a request. Dependency Injection will provide the Adapter and IBot
+    // implementation at runtime. Multiple different IBot implementations running at different endpoints can be
+    // achieved by specifying a more specific type for the bot constructor argument.
+    [Route("api/messages")]
+    [ApiController]
+    public class BotController : ControllerBase
+    {
+        private readonly IBotFrameworkHttpAdapter Adapter;
+        private readonly IBot Bot;
+
+        public BotController(IBotFrameworkHttpAdapter adapter, IBot bot)
+        {
+            Adapter = adapter;
+            Bot = bot;
+        }
+
+        [HttpPost]
+        public async Task PostAsync()
+        {
+            // Delegate the processing of the HTTP POST to the adapter.
+            // The adapter will invoke the bot.
+            await Adapter.ProcessAsync(Request, Response, Bot);
+        }
+    }
+}

samples/csharp_dotnetcore/55.teams-link-unfurling/Program.cs

@@ -10,6 +10,11 @@ public class Program
     {
         public static void Main(string[] args)
         {
+            CreateWebHostBuilder(args).Build().Run();
         }
+
+        public static IWebHostBuilder CreateWebHostBuilder(string[] args) =>
+            WebHost.CreateDefaultBuilder(args)
+                .UseStartup<Startup>();
     }
 }

samples/csharp_dotnetcore/55.teams-link-unfurling/Properties/launchSettings.json

@@ -3,7 +3,7 @@
     "windowsAuthentication": false,
     "anonymousAuthentication": true,
     "iisExpress": {
-      "applicationUrl": "http://localhost:10754/",
+      "applicationUrl": "http://localhost:3978/",
       "sslPort": 0
     }
   },
@@ -15,13 +15,13 @@
         "ASPNETCORE_ENVIRONMENT": "Development"
       }
     },
-    "TeamsLinkUnfurling": {
+    "LinkUnfurling": {
       "commandName": "Project",
       "launchBrowser": true,
       "environmentVariables": {
         "ASPNETCORE_ENVIRONMENT": "Development"
       },
-      "applicationUrl": "http://localhost:10755/"
+      "applicationUrl": "http://localhost:3978/"
     }
   }
 }

samples/csharp_dotnetcore/55.teams-link-unfurling/README.md

@@ -1,30 +1,72 @@
-# EchoBot
+## TeamsLinkUnfurlingBot
 
-Bot Framework v4 Teams Link Unfurling.
+Bot Framework v4 Teams link unfurling bot sample for Teams.
 
 This bot has been created using [Bot Framework](https://dev.botframework.com), it shows how to create a simple bot that performs link unfurling in Teams.
 
 ## Prerequisites
 
+
 - [.NET Core SDK](https://dotnet.microsoft.com/download) version 2.1
 
   ```bash
   # determine dotnet version
   dotnet --version
   ```
+  
+- Microsoft Teams is installed and you have an account
 
 ## To try this sample
 
+### Clone the repo
 - Clone the repository
 
     ```bash
     git clone https://github.com/Microsoft/botbuilder-samples.git
     ```
 
-- In a terminal, navigate to `samples/csharp_dotnetcore/55.teams-link-unfurling`
-- Run the bot from a terminal or from Visual Studio, choose option A or B.
-
-  A) From a terminal
+### Ngrok
+- Download and install [ngrok](https://ngrok.com/download)
+- In terminal navigate to where ngrok is installed and run: 
+
+```bash
+ngrok http -host-header=rewrite 3978
+```
+- Copy/paste the ```https``` **NOT** the ```http``` web address into notepad as you will need it later
+
+### Creating the bot registration
+- Create a new bot [here](https://dev.botframework.com/bots/new)
+- Enter a```Display name``` and ```Bot handle```
+- In the ```Messaging endpoint``` enter the https address from Ngrok and add ```/api/messages``` to the end
+  - EX: ```https://7d899fbb.ngrok.io/api/messages``` 
+- Open the ```Create Microsoft App ID and password``` link in a new tab
+- Click on the ```New registration``` button 
+- Enter a name, and select the ```Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox)```
+- Click ```Register```
+- Copy & paste the ```Application (client) ID``` field into notepad. This is your botID.
+- Click on ```Certificates & secrets``` tab on the left
+- Click ```New client secret```
+- Enter a name, select `Never`, and click ```Add```
+- Copy & paste the password into notepad. This is your app password.
+- Go back to the bot registration tab and enter the ```botID``` into the app ID field
+- Scroll down, agree to the Terms, and click ```Register```
+- Click the ```Microsoft Teams``` icon on the next screen
+- Click ```Save```
+
+### Visual Studio
+- Launch Visual Studio
+- Navigate to and open the `samples/csharp_dotnet/55.teams-link-unfurling-bot` directory
+- Open the ```appsettings.json``` file
+- Paste your botID value into the ```MicrosoftAppId``` field 
+- Put the password into the ```MicrosoftAppPassword``` field
+- Save the file
+- Open the ```manifest.json```
+- Replace your botID everywhere you see the place holder string ```<<YOUR-MICROSOFT-BOT-ID>>```
+
+
+- Run the bot:
+
+ A) From a terminal
 
   ```bash
   # run the bot
@@ -33,36 +75,25 @@ This bot has been created using [Bot Framework](https://dev.botframework.com), i
 
   B) Or from Visual Studio
 
-  - Launch Visual Studio
   - File -> Open -> Project/Solution
-  - Navigate to `samples/csharp_dotnetcore/55.teams-link-unfurling` folder
-  - Select `TeamsLinkUnfurling.csproj` file
+  - Navigate to `samples/csharp_dotnetcore/55.teams-link-unfurling-bot` folder
+  - Select `TeamsLinkUnfurlingBot.csproj` file
   - Press `F5` to run the project
 
-## Testing the bot using Teams
-
-1) run ngrok - point to port 3978
-1) create bot framework registration - using ngrok URL
-1) update your manifest.json to include the app id from bot framework
-1) zip up teams-manifest folder to create a manifest.zip
-1) upload manifest.zip to teams (from Apps view click "Upload a custom app")
-1) pick your bot from the compose command menu
-
-## Deploy the bot to Azure
-
-To learn more about deploying a bot to Azure, see [Deploy your bot to Azure](https://aka.ms/azuredeployment) for a complete list of deployment instructions.
-
-## Further reading
-
-- [Bot Framework Documentation](https://docs.botframework.com)
-- [Bot Basics](https://docs.microsoft.com/azure/bot-service/bot-builder-basics?view=azure-bot-service-4.0)
-- [Activity processing](https://docs.microsoft.com/en-us/azure/bot-service/bot-builder-concept-activity-processing?view=azure-bot-service-4.0)
-- [Azure Bot Service Introduction](https://docs.microsoft.com/azure/bot-service/bot-service-overview-introduction?view=azure-bot-service-4.0)
-- [Azure Bot Service Documentation](https://docs.microsoft.com/azure/bot-service/?view=azure-bot-service-4.0)
-- [.NET Core CLI tools](https://docs.microsoft.com/en-us/dotnet/core/tools/?tabs=netcore2x)
-- [Azure CLI](https://docs.microsoft.com/cli/azure/?view=azure-cli-latest)
-- [Azure Portal](https://portal.azure.com)
-- [Language Understanding using LUIS](https://docs.microsoft.com/en-us/azure/cognitive-services/luis/)
-- [Channels and Bot Connector Service](https://docs.microsoft.com/en-us/azure/bot-service/bot-concepts?view=azure-bot-service-4.0)
-- [Restify](https://www.npmjs.com/package/restify)
-- [dotenv](https://www.npmjs.com/package/dotenv)
+### Teams - App Studio
+- Launch Microsoft Teams
+- In the bar at the top of Teams search for and select ```App Studio``` 
+- Click the ```Manifest editor``` tab
+- Click ```Import an existing app```
+- Navigate to and select the `manifest.json` file from the previous step
+- Click on the `TeamsConversationBot` card
+- Click ```Test and distribute``` on the left hand side
+- Click the ```Install``` button
+
+| To install bot in a personal chat... | To install in a group chat... | To install in team chat... |
+|:-------------------- | :------------------------- | :-----------------------|
+| 1. Click ```Add``` button| 1. Click the down arrow to the right of the ```Add``` button <br> 2. Click ```Add to Chat``` <br> 3. Search for and select your group chat <br> 4. Click the ```Set up bot``` button <br> **Note:** There must be at least 1 message in a group chat for it to be searchable |  1. Click the down arrow to the right of the ```Add``` button <br> 2. Click ```Add to Team``` <br> 3. Search for and select your team <br> 4. Click the ```Set up a bot``` button  |
+
+### Interacting with the bot
+
+If you copy and paste a link from https://www.seattletimes.com into the compose message area the link will unfurl. 

samples/csharp_dotnetcore/55.teams-link-unfurling/Startup.cs

@@ -0,0 +1,58 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.Bot.Builder;
+using Microsoft.Bot.Builder.Integration.AspNet.Core;
+using Microsoft.BotBuilderSamples.Bots;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Microsoft.BotBuilderSamples
+{
+    public class Startup
+    {
+        public Startup(IConfiguration configuration)
+        {
+            Configuration = configuration;
+        }
+
+        public IConfiguration Configuration { get; }
+
+        // This method gets called by the runtime. Use this method to add services to the container.
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddMvc().SetCompatibilityVersion(CompatibilityVersion.Version_2_1);
+
+            // Create the storage we'll be using for User and Conversation state. (Memory is great for testing purposes.)
+            services.AddSingleton<IStorage, MemoryStorage>();
+
+            // Create the Bot Framework Adapter with error handling enabled.
+            services.AddSingleton<IBotFrameworkHttpAdapter, AdapterWithErrorHandler>();
+
+            // Create the bot as a transient. In this case the ASP Controller is expecting an IBot.
+            services.AddTransient<IBot, LinkUnfurlingBot>();
+        }
+
+        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+        public void Configure(IApplicationBuilder app, IHostingEnvironment env)
+        {
+            if (env.IsDevelopment())
+            {
+                app.UseDeveloperExceptionPage();
+            }
+            else
+            {
+                app.UseHsts();
+            }
+
+            app.UseDefaultFiles();
+            app.UseStaticFiles();
+
+            //app.UseHttpsRedirection();
+            app.UseMvc();
+        }
+    }
+}

samples/csharp_dotnetcore/55.teams-link-unfurling/TeamsLinkUnfurling.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk.Web">
+<Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
     <TargetFramework>netcoreapp2.1</TargetFramework>

samples/csharp_dotnetcore/55.teams-link-unfurling/appsettings.Development.json

@@ -0,0 +1,9 @@
+{
+  "Logging": {
+    "LogLevel": {
+      "Default": "Debug",
+      "System": "Information",
+      "Microsoft": "Information"
+    }
+  }
+}

samples/csharp_dotnetcore/55.teams-link-unfurling/appsettings.json

@@ -0,0 +1,4 @@
+{
+  "MicrosoftAppId": "",
+  "MicrosoftAppPassword": ""
+}