Botas 0.3.6-alpha

Botas The Bot App SDK

Lightweight library for building Microsoft Bot Framework bots — .NET / ASP.NET Core. A lightweight library for building Microsoft Teams bots in .NET / ASP.NET Core

What it does

• Enables a chat experience in Teams, for personal, group, channel or meetings chats.
• Secure inbound messages are dispatched to message handlers
• Implement rich UX in chats using AdaptiveCards, Suggested Actions, Collect feedback and more
• Secure outbound messages using standard Entra Application Tokens

Installation

dotnet add package Botas

Quick start

using Botas;

var app = BotApp.Create(args);

app.On("message", async (ctx, ct) =>
{
    await ctx.SendAsync($"You said: {ctx.Activity.Text}", ct);
});

app.Run();

Configure the App Credentials

You can configure the bot app credentials using the appSettings.json or overrid with env vars from launchSettings.json:

appSettings.json

// copy to outdir
{
  "$schema": "https://json.schemastore.org/appsettings.json",
  "AzureAd": {
    "Instance": "https://login.microsoftonline.com/",
    "TenantId": "<your-tenant-id>",
    "ClientId": "<your-bot-app-id>",
    "ClientCredentials": [
      {
        "SourceType": "ClientSecret",
        "ClientSecret": "<your-client-secret>"
      }
    ]
  }
}

launchSettings.json

{
  "$schema": "https://json.schemastore.org/launchsettings.json",
  "profiles": {
    "local": {
      "commandName": "Project",
      "launchBrowser": false,
      "applicationUrl": "http://localhost:3978",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development",
        "AzureAd__Instance": "https://login.microsoftonline.com/",
        "AzureAd__TenantId": "<your-tenant-id>",
        "AzureAd__ClientId": "<your-bot-app-id>",
        "AzureAd__ClientCredentials__0__SourceType": "",
        "AzureAd__ClientCredentials__0__ClientSecret": "<your-client-secret>",
      }
    }
  }
 }

env vars

AzureAd__Instance=https://login.microsoftonline.com/
AzureAd__ClientId="<your-bot-app-id>"
AzureAd__TenantId="<your-tenant-id>"
AzureAd__ClientCredentials__0__SourceType="ClientSecret"
AzureAd__ClientCredentials__0__ClientSecret="<your-client-secret>"

💡 Tip: You can configure your app with any of the credentials supported by MSAL see calling Downstream APIs docs.

Documentation

• Full documentation site
• Full feature specification
• Architecture overview
• Infrastructure setup

License

MIT