botas-fastapi 0.3.82

FastAPI integration for botas – zero-boilerplate Bot Service bot hosting

botas-fastapi

A lightweight, multi-language library for building Microsoft Teams bots — this is the FastAPI integration package.

Wraps botas with a FastAPI server for zero-boilerplate bot hosting.

Installation

pip install botas-fastapi

Quick start

from botas_fastapi import BotApp

app = BotApp()

@app.on("message")
async def on_message(ctx):
    await ctx.send(f"You said: {ctx.activity.text}")

app.start()

Manual FastAPI wiring

For full control over routes, middleware, and server lifecycle:

from botas import BotApplication
from botas_fastapi import bot_auth_dependency
from fastapi import Depends, FastAPI, Request

bot = BotApplication()

@bot.on("message")
async def on_message(ctx):
    await ctx.send(f"You said: {ctx.activity.text}")

app = FastAPI()

@app.post("/api/messages", dependencies=[Depends(bot_auth_dependency())])
async def messages(request: Request):
    body = await request.body()
    await bot.process_body(body.decode())
    return {}

API

BotApp

High-level wrapper that composes a BotApplication with a FastAPI + Uvicorn server.

Method	Description
on(type, handler)	Register a handler for an activity type (also works as a @decorator)
on_invoke(name, handler)	Register a handler for an invoke activity by name (also works as a @decorator)
use(middleware)	Add a middleware to the turn pipeline
start()	Start the FastAPI/Uvicorn server

Options

BotApp accepts BotApplicationOptions plus these additional keyword arguments:

Option	Default	Description
port	3978 (or PORT env)	HTTP listen port
path	/api/messages	Endpoint path for incoming activities
auth	Auto (enabled when client_id is set)	Enable/disable JWT auth middleware

Authentication options

Inherited from BotApplicationOptions — see the botas package README for the full list of authentication options and environment variables.

Documentation

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

License

MIT