Microsoft Teams Incoming Webhook Integration With ASP.NET Core

public class ArticleModel {
    public ArticleModel() {
        Message = new MessageModel();
    }
    public string Title {
        get;
        set;
    }
    public string Description {
        get;
        set;
    }
    public string Author {
        get;
        set;
    }
    public MessageModel Message {
        get;
        set;
    }
}

public class Root {
    public Root() {
            PotentialAction = new List < PotentialAction > ();
        }
        [JsonProperty("@context")]
    public string Context {
        get;
        set;
    }
    [JsonProperty("@type")]
    public string Type {
        get;
        set;
    }
    [JsonProperty("themeColor")]
    public string ThemeColor {
        get;
        set;
    }
    [JsonProperty("summary")]
    public string Summary {
        get;
        set;
    }
    [JsonProperty("title")]
    public string Title {
        get;
        set;
    }
    [JsonProperty("text")]
    public string Text {
        get;
        set;
    }
    [JsonProperty("potentialAction")]
    public List < PotentialAction > PotentialAction {
        get;
        set;
    }
}
public class PotentialAction {
    public PotentialAction() {
            Targets = new List < Target > ();
        }
        [JsonProperty("@type")]
    public string Type {
        get;
        set;
    }
    [JsonProperty("name")]
    public string Name {
        get;
        set;
    }
    [JsonProperty("targets")]
    public List < Target > Targets {
        get;
        set;
    }
}
public class Target {
    [JsonProperty("os")]
    public string Os {
        get;
        set;
    }
    [JsonProperty("uri")]
    public string Uri {
        get;
        set;
    }
}

Index.cshtml

This is the HTML that I have in my Views>Article>Index.cshtml

@model TeamsWebHook.Models.ArticleModel
@{
    ViewData["Title"] = "Create Article";
    Layout = "~/Views/Shared/_Layout.cshtml";
}

<h4>Create new article</h4>
<hr />
<div class="row">
    <div class="col-md-4">
        @if (Model.Message != null)
        {
            <div class="@(Model.Message.IsSuccess?"text-success":"text-error")">@Model.Message.Message</div>
        }
        <form asp-action="Index">
            <div asp-validation-summary="ModelOnly" class="text-danger"></div>
            <div class="form-group">
                <label asp-for="Title" class="control-label"></label>
                <input asp-for="Title" class="form-control"/>
                <span asp-validation-for="Title" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Description" class="control-label"></label>
                <textarea asp-for="Description" class="form-control" rows="10"></textarea>
                <span asp-validation-for="Description" class="text-danger"></span>
            </div>
            <div class="form-group">
                <label asp-for="Author" class="control-label"></label>
                <input asp-for="Author" class="form-control"/>
                <span asp-validation-for="Author" class="text-danger"></span>
            </div>
            <div class="form-group">
                <input type="submit" value="Create" class="btn btn-primary"/>
            </div>
        </form>
    </div>
</div>

@section Scripts {
    @{await Html.RenderPartialAsync("_ValidationScriptsPartial");}
}

Below screenshot shows the output of this HTML.

ArticleController.cs

This code holds all the basic things needed to display in the channel. I have used MessageCard type. Summary, title and text is the part where you have to add all your custom messages.

var teamsMessage = new Root(){
    Context = "https://schema.org/extensions",
    Type = "MessageCard",
    ThemeColor = "0072C6",
    Summary = $"{model.Author} has submitted new article {model.Title}",
    Title = "New Article Alert!!!",
    Text = $"**{model.Author}** has submitted new article **{model.Title}**. Please click below action buttons to proceed."
};

This code is responsible for adding action button in the channel. We can add action button multiple times.

//Adds approve button and its target
var approveAction = new PotentialAction {
    Type = "OpenUri",
        Name = "Approve",
};
var approveTarget = new Target() {
    Os = "default",
        Uri = "https://www.c-sharpcorner.com/articles/review.aspx"
};
approveAction.Targets.Add(approveTarget);
teamsMessage.PotentialAction.Add(approveAction);

And here I have converted teamsMessage object into JSON and sends the JSON content to webhook.

var teamsPayload = JsonConvert.SerializeObject(teamsMessage);
request.Content = new StringContent(teamsPayload, Encoding.UTF8, "application/json");
var response = await httpClient.SendAsync(request);

JSON content posting to webhook is done by using HttpRequestMessage

using (var request = new HttpRequestMessage(new HttpMethod("POST"), webHookUrl))

Full code of ArticleController.cs

public class ArticleController: Controller {
    private readonly ILogger < ArticleController > _logger;
    public ArticleController(ILogger < ArticleController > logger) {
            _logger = logger;
        }
        [HttpGet]
    public IActionResult Index() {
            var model = new ArticleModel();
            return View(model);
        }
        [HttpPost]
    public async Task < ActionResult > Index(ArticleModel model) {
        using(var httpClient = new HttpClient()) {
            var webHookUrl = "<your webhook URL>";
            using(var request = new HttpRequestMessage(new HttpMethod("POST"), webHookUrl)) {
                var teamsMessage = new Root() {
                    Context = "https://schema.org/extensions",
                        Type = "MessageCard",
                        ThemeColor = "0072C6",
                        Summary = $ "{model.Author} has submitted new article {model.Title}",
                        Title = "New Article Alert!!!",
                        Text = $ "**{model.Author}** has submitted new article **{model.Title}**. Please click below action buttons to proceed."
                };
                //Adds approve button and its target
                var approveAction = new PotentialAction {
                    Type = "OpenUri",
                        Name = "Approve",
                };
                var approveTarget = new Target() {
                    Os = "default",
                        Uri = "https://www.c-sharpcorner.com/articles/review.aspx"
                };
                approveAction.Targets.Add(approveTarget);
                teamsMessage.PotentialAction.Add(approveAction);
                //Adds review button and its target
                var reviewAction = new PotentialAction {
                    Type = "OpenUri",
                        Name = "Review"
                };
                var reviewTarget = new Target() {
                    Os = "default",
                        Uri = "https://www.c-sharpcorner.com/authors/dashboard.aspx"
                };
                reviewAction.Targets.Add(reviewTarget);
                teamsMessage.PotentialAction.Add(reviewAction);
                var teamsPayload = JsonConvert.SerializeObject(teamsMessage);
                request.Content = new StringContent(teamsPayload, Encoding.UTF8, "application/json");
                var response = await httpClient.SendAsync(request);
                var messageModel = new MessageModel();
                if (response.StatusCode == HttpStatusCode.OK) {
                    messageModel.IsSuccess = true;
                    messageModel.Message = "Your article has been submitted successfully.";
                } else {
                    messageModel.IsSuccess = false;
                    messageModel.Message = "Unable to submit your article.";
                }
                model.Message = messageModel;
            }
        }
        return View(model);
    }
}

Final Output

This is the message received in Teams channel. You can see 2 different buttons, one for approval and one for review. Both of the button holds link to the system where auto approve can happen or shows detail to review.

Summary

This article has described about adding channel, Incoming Webhook and how to configure Incoming Webhook in Microsoft Teams. This also described integrating Incoming Webhook with ASP.NET Core application.

I hope you will find this article helpful. If you have any suggestions, then please feel free to ask into the comment section.

Thank you for reading the article