proactive-message

What problem does it solve?

Proactive messaging in Microsoft Teams can be difficult because the bot must continue a past conversation context using a stored conversation reference, otherwise the request fails.

Core Features & Use Cases

• Conversation reference capture: Stores the conversation reference from every incoming message to enable future proactive sends.
• Redis-backed lookup: Retrieves conversation references from Redis using the fixed key format convref:{conversationId}.
• Reliable proactive delivery: Continues the conversation via BotFrameworkAdapter.continueConversation with transient and authorization retry handling.
• Separation from reactive replies: Uses this flow for user-initiated proactive triggers like “notify channel” rather than for standard ActivityHandler responses.

Quick Start

Add a conversation reference write on every incoming Teams message, implement sendProactiveMessage in server/api/msgController.js with retries, and then call POST /api/message with {"message":"Hello from proactive!"} after the bot has first received a message in the target conversation.