bot-activity-handler

Official

Handle Teams bot activities reliably

Authorinterserver
Version1.0.0
Installs0

System Documentation

What problem does it solve?

It solves the problem of implementing robust Microsoft Teams bot event handling for messages, card submits, reactions, and member/conversation lifecycle events without breaking downstream middleware.

Core Features & Use Cases

  • Bot Framework activity lifecycle hooks: Add targeted handlers for message, member, reaction, delete/update, conversation update, and token response events.
  • Adaptive Card submit routing: Correctly process card submissions delivered as message activities by checking msteams.type inside context.activity.value.
  • Safe middleware chaining: Ensures every registered handler awaits next() to avoid swallowing subsequent middleware, and supports updating cards using injected activityId.

Quick Start

Add the requested handler(s) into server/bot/botActivityHandler.js inside BotActivityHandler’s constructor, ensuring each callback ends with await next() and that any Adaptive Card Action.Submit includes data.msteams.type matching the handler branch.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: bot-activity-handler
Download link: https://github.com/interserver/teams-chat-bot/archive/main.zip#bot-activity-handler

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.