Bot Framework Activity delivered to the bot endpoint
receiveBotActivitybody
Messages & Schemas 39
The contract defines 39 schemas that model the data carried by its messages. The most detailed are ActivityBase (14 properties), TeamsChannelData (9 properties), ChangeNotification (8 properties), ConversationAccount (5 properties). Each schema is shown below with its type and property counts.
ChatMessageNotification
message
Notification payload for changes on the chatMessage resource. The resource may be in a channel or chat context. When includeResourceData is true on the subscri…
ChannelNotification
message
ChatNotification
message
TeamNotification
message
ConversationMemberNotification
message
TeamsAppInstallationNotification
message
CallRecordingNotification
message
CallTranscriptNotification
message
LifecycleNotification
message
Subscription lifecycle event. The lifecycleEvent value is one of reauthorizationRequired, subscriptionRemoved, or missed. Subscribers must respond with HTTP 20…
ValidationRequest
message
Sent by Microsoft Graph with the validationToken query parameter when a subscription is created or updated. The endpoint must respond within 10 seconds with HT…
MessageActivity
message
MessageUpdateActivity
message
Sent when a previously sent message is edited or restored from soft-delete. channelData.eventType is editMessage or undeleteMessage.
MessageDeleteActivity
message
Sent when a message is soft-deleted. channelData.eventType is softDeleteMessage.
ConversationUpdateActivity
message
Sent for membership and team/channel lifecycle changes. The channelData.eventType discriminator identifies the Teams-specific sub-event: teamMemberAdded, teamM…
MessageReactionActivity
message
Sent when a user adds or removes a reaction (like, heart, laugh, surprised, sad, angry, and other supported emoji reactions) to a message previously sent by th…
InstallationUpdateActivity
message
Sent when the bot is installed, uninstalled, or upgraded in a conversation thread. The action field is one of add, remove, add-upgrade, or remove-upgrade.
TypingActivity
message
InvokeActivity
message
Synchronous request from Teams that expects a response payload. The name discriminator identifies the invoke kind. Documented Teams invoke names include compos…
EventActivity
message
Asynchronous notification from Teams. Documented Teams event names include application/vnd.microsoft.readReceipt, application/vnd.microsoft.meetingStart, appli…
ChangeNotificationCollection
object
Top-level payload delivered by Microsoft Graph to a notificationUrl. Contains a batch of changeNotification items and optional validationTokens used to verify…
2 properties1 required
ChangeNotification
object
A single change notification item.
8 properties3 required
ResourceData
object
4 properties
EncryptedContent
object
Present when includeResourceData: true is set on the subscription. The receiver decrypts dataKey with its private key, then uses the symmetric key to decrypt d…
4 properties
LifecycleNotificationCollection
object
2 properties1 required
LifecycleNotification
object
5 properties2 required
ActivityBase
object
Bot Framework Activity base properties.
14 properties
MessageActivity
object
MessageUpdateActivity
object
MessageDeleteActivity
object
ConversationUpdateActivity
object
MessageReactionActivity
object
InstallationUpdateActivity
object
TypingActivity
object
InvokeActivity
object
EventActivity
object
ChannelAccount
object
4 properties
ConversationAccount
object
5 properties
MessageReaction
object
1 property
TeamsChannelData
object
Teams-specific channelData payload appended to most Bot Framework activities. The eventType discriminator identifies Teams sub-events on conversationUpdate and…
9 properties
Specification
The full machine-readable AsyncAPI contract behind this narrative.
Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.
Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.
MCP tools for apis
4 tools reach this content
search_api_evangelistSearch every content type across the network at once.
find_relatedThe shared-tag relevance graph — what else covers this.
get_tagEverything one tag labels, across all content types.
guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
A second provider on the same verified email joins the account you already have.
Your account
ⓘWhere this information came from
This is an independent, third-party profile of Microsoft Teams Bot Framework API, published by
API Evangelist. We do not operate, host, resell, or
support these APIs, and we are not affiliated with or endorsed by the company unless stated above.
Everything here is built from publicly available information — the company's own site,
developer portal, documentation, public repositories, and the specifications it publishes for public use.
Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's
public API artifacts, scored against a published rubric. They are not certifications,
endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and
you do not need to justify the request. A removed company is recorded as unrated, never scored
zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy → On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.
