使用AzureFunction开发最简单的Teams Outgoing Webhook

上篇文章讲了teams app的serverless架构，这篇主要讲如何真正使用Azure Function来开发一个最最简单的Teams Outgoing Webhook。

我们先登入azure的portal，创建一个azure function。我这里创建了一个名字叫outgoing-webhook的azure function。完成后如下图，记住这个azure function的URL，我这里是 https://outgoing-webhook.azurewebsites.net

在左边菜单里选择”Functions”，点击”Add”创建一个新的function

选择Trigger，我们使用HTTP Trigger

输入我们function的名字，我这里叫HandleMessage，有一点需要注意，Authorization level需要选择”Anonymous”，然后点击Create Function

完成后就可以看到我们有了HandleMessage这个函数。

输入我们的outgoing webhook代码。

#r "Newtonsoft.Json"

using System.Net;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Extensions.Primitives;
using Newtonsoft.Json;

public class Message
{
    public string Text { get; set; }
}

public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
{
    log.LogInformation("C# HTTP trigger function processed a request.");
    string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    var message = JsonConvert.DeserializeObject<Message>(requestBody);
    return new OkObjectResult(new Message { Text = "Echo: " + message.Text });
}

回到Teams，先选择需要添加outgoing webhook的一个team，选择”Manage team”

进入”Apps”页面，在右下方，点击 “Create an outgoing webhook”，你有可能看不到这个选项，如果看不到，你需要用管理员账号按照下面的步骤到office365后台进行设置

使用你的Office365管理员账号登入”https://portal.office.com”，点击”Admin”菜单

在左侧找到”Teams”菜单

然后找到 “Teams app”，点击”Permission policies”，点击你所在policy组，我这里是默认的”Global (Org-wide default)”

确保Custom apps是Allow all apps

再到Setup policies，确保 “Upload custom apps”是打开的状态

回到Teams，刷新页面，或者重新登入，现在你应该可以看到 “Create an outgoing webhook”的连接了，点击它。

在弹出的页面里输入你的webhook名字，和URL。 

我这里使用名字”OutgoingWebhookTest”，URL是https://outgoing-webhook.azurewebsites.net/api/HandleMessage。这个URL就是我们前面创建的azure function的URL，加上function的名字。

{azure function url}/api/{http-triggered function name}

创建完后进入一个channel，at这个webhook，我这里是 @outgoingWebhookTest

后面跟上你想发给这个webhook的文字。

发送后，等几秒钟后，你就可以收到我们function发回来的回复了。

如果你点开Azure Function的log，可以实时的看到我们function被teams调用的记录

使用Azure Function开发的好处是代码简单，不需要ngrok之类的工具，而且当你webhook只是用来自己测试玩玩，基本是免费的，这也是Azure serverless的一大优势！