Microsoft Bot Framework and Teams App Architecture
Microsoft Teams apps are built on the Bot Framework, which is a set of SDKs and a cloud relay service (Azure Bot Service) that handles the communication protocol between your bot server and Teams clients. Your bot server receives activity objects (messages, adaptive card submissions, meeting events) from the Bot Framework relay and sends responses back through the same channel. SpeedMVPs uses the Bot Framework SDK for Node.js, which provides an Activity Handler model for routing incoming activities to the correct handler function. For more complex conversational AI, the Teams AI Library (an extension of the Bot Framework SDK) adds support for prompt management, OpenAI integration, and action-based dialog flows with less boilerplate. The bot is deployed as a containerised Node.js service on Azure App Service or AWS ECS, registered with Azure Bot Service, and connected to your Teams tenant via an App Manifest.
AI Knowledge Copilots in Teams
The same RAG architecture SpeedMVPs builds for Slack bots applies to Teams. A user @mentions the bot or messages it directly, the bot queries a vector database containing your company's knowledge base, retrieves relevant chunks, constructs a prompt with context, calls an LLM (typically Azure OpenAI Service for enterprise clients who need UK data residency), and returns a cited answer. For Microsoft-stack clients, the knowledge base is often SharePoint documents and Teams channel content, which are accessible via the Microsoft Graph API. SpeedMVPs builds the Graph API ingestion pipeline alongside the Teams bot, so your knowledge copilot is grounded in the same documents your team actually uses. Adaptive Cards allow rich citation formatting with clickable links to SharePoint pages.
Microsoft Graph API Integration
The Microsoft Graph API is the access layer for all Microsoft 365 data: Teams messages, SharePoint content, OneDrive files, Outlook emails, and Azure AD user and group information. SpeedMVPs integrates Graph API access into Teams AI bots for use cases that require this data: a sales copilot that retrieves a contact's email history from Outlook before generating a meeting briefing, a knowledge bot that searches SharePoint document libraries for relevant policy documents, or a workflow bot that creates and assigns Planner tasks based on an AI analysis of a Teams message. Graph API access requires Azure AD application registration with the appropriate permission scopes, which for enterprise tenants requires admin consent from the IT team.
Azure OpenAI Service for Enterprise Compliance
Enterprise clients in regulated UK industries (financial services, NHS, legal) typically require that LLM processing happens within Azure's UK South or North Europe data centres, not on OpenAI's consumer infrastructure. Azure OpenAI Service provides access to GPT-4o and embedding models with UK data residency, Virtual Network integration for private networking, Azure Active Directory authentication for access control, and Microsoft's compliance certifications (ISO 27001, SOC 2, NHS DSPT compatible configurations). SpeedMVPs integrates Azure OpenAI into Teams bots for clients where data residency is a requirement, configuring the Azure OpenAI resource in the appropriate region and connecting it to the bot's LLM calls. This is often the right approach for NHS Digital compliance, FCA-regulated firms, and UK central government deployments.
Adaptive Cards and Interactive Bot Responses
Microsoft Teams supports Adaptive Cards, a JSON-based card format that renders rich interactive UI inside Teams messages. SpeedMVPs designs bot responses using Adaptive Cards where appropriate: an AI-generated summary card with approve/reject buttons for a document review workflow, a form card for collecting structured input from a user without leaving Teams, or a status card that displays real-time AI processing results with a refresh button. Adaptive Cards improve usability significantly over plain text responses, particularly for workflow automation bots where the response needs to be actionable. Teams also supports Message Extensions, which allow users to invoke AI tools from the compose box or the message action menu, extending the bot's reach beyond explicit @mentions.
Deployment, Compliance, and What Gets Delivered
Deploying a Teams app in an enterprise environment involves the tenant admin approving the app in the Teams Admin Centre. SpeedMVPs produces an App Manifest and submission package compatible with enterprise app catalogue requirements. For clients requiring a custom app published only to their tenant (rather than the public Teams App Store), the internal app deployment process is simpler and does not require Microsoft's app review. SpeedMVPs delivers: Bot Framework server implementation, Azure Bot Service registration, Teams App Manifest, Graph API integration for required Microsoft 365 data, Azure OpenAI integration with UK data residency configuration where required, Adaptive Card templates for rich responses, deployment to Azure App Service or equivalent, and documentation covering how to extend the bot, manage Azure permissions, and update the knowledge base. GDPR and, where applicable, NHS Digital DSPT alignment documentation is available on request.