Merge pull request #1968 from OfficeDev/v-ajayjadhav/targetedMessagesPython

Adding Agent-targeted-messages python sample

Author: AjayJ12-MSFT

.github/workflows/build-complete-samples.yml

@@ -542,6 +542,10 @@ jobs:
               name: 'tab-request-approval'
               version: '3.10.x'
 
+            - project_path: 'samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages'
+              name: 'agent-targeted-messages'
+              version: '3.12.x'
+
             - project_path: 'samples/TeamsSDK/bot-ai-messages/python/bot-ai-messages'
               name: 'bot-ai-messages'
               version: '3.12.x'

samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages/.env.TEMPLATE

@@ -0,0 +1,3 @@
+CLIENT_ID=
+CLIENT_SECRET=
+TENANT_ID=

samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages/README.md

@@ -0,0 +1,37 @@
+# Targeted Messages in Microsoft Teams - Python
+
+This sample demonstrates how to use **targeted messaging** in Microsoft Teams. Targeted messages are private messages that appear in a channel or group chat but are **only visible to a specific user**. The sample implements a reminder bot where all bot responses — confirmations, reminder deliveries, active reminder lists, and snooze confirmations — are sent as targeted messages.
+
+## Prerequisites
+
+- [Python >=3.12, <3.15](https://www.python.org/downloads/)
+- pip (recommended) or [uv](https://docs.astral.sh/uv/)
+
+## Run the sample
+
+1. Navigate to this directory:
+   ```bash
+   cd samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages
+   ```
+2. Run the agent using pip:
+
+```bash
+pip install -e .
+python main.py
+```
+
+### Alternative: Using uv
+
+1. Install dependencies using uv:
+   ```bash
+   uv sync
+   ```
+
+2. Run the agent:
+   ```bash
+   uv run main.py
+   ```
+
+The agent will start listening on `http://localhost:3978`.
+
+Refer to the main [README.md](../../../README.md) to interact with your agent in the agentsplayground or in Teams.

samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages/assets/sample.json

@@ -0,0 +1,68 @@
+[
+  {
+    "name": "officedev-microsoft-teams-samples-agent-targeted-messages-python",
+    "source": "officeDev",
+    "title": "Targeted Messages",
+    "shortDescription": "This sample agent demonstrates how to use targeted messaging in Microsoft Teams to send private reminders, confirmations, and lists visible only to the intended recipient.",
+    "url": "https://github.com/OfficeDev/Microsoft-Teams-Samples/tree/main/samples/TeamsSDK/agent-targeted-messages/python/agent-targeted-messages",
+    "longDescription": [
+      "This sample demonstrates targeted messaging in Microsoft Teams using Python. Targeted messages are private messages visible only to a specific user within a channel or group chat. The agent implements a reminder system where every response — reminder confirmations, deliveries, active reminder lists, and snooze confirmations — is sent as a targeted message using MessageActivityInput.with_recipient(). It also demonstrates proactive targeted messaging via app.send() and interactive Adaptive Cards with Action.Execute for dismiss, snooze, and cancel actions."
+    ],
+    "creationDateTime": "2026-04-28",
+    "updateDateTime": "2026-04-28",
+    "products": [
+      "Teams"
+    ],
+    "metadata": [
+      {
+        "key": "TEAMS-SAMPLE-SOURCE",
+        "value": "OfficeDev"
+      },
+      {
+        "key": "TEAMS-SERVER-LANGUAGE",
+        "value": "python"
+      },
+      {
+        "key": "TEAMS-SERVER-PLATFORM",
+        "value": "python"
+      },
+      {
+        "key": "TEAMS-FEATURES",
+        "value": "agent,targeted-messaging,proactive-messaging,adaptive-cards"
+      }
+    ],
+    "thumbnails": [
+      {
+        "type": "Image",
+        "order": 100,
+        "url": "https://raw.githubusercontent.com/OfficeDev/Microsoft-Teams-Samples/main/samples/TeamsSDK/agent-targeted-messages/assets/agent-targeted-messages.gif",
+        "alt": "Targeted Reminder Agent showing reminder delivery with snooze and dismiss options"
+      }
+    ],
+    "authors": [
+      {
+        "gitHubAccount": "OfficeDev",
+        "pictureUrl": "https://avatars.githubusercontent.com/u/6789362?s=200&v=4",
+        "name": "OfficeDev"
+      }
+    ],
+    "references": [
+      {
+        "name": "Teams developer documentation",
+        "url": "https://aka.ms/TeamsPlatformDocs"
+      },
+      {
+        "name": "Teams developer questions",
+        "url": "https://aka.ms/TeamsPlatformFeedback"
+      },
+      {
+        "name": "Teams development videos from Microsoft",
+        "url": "https://aka.ms/sample-ref-teams-vids-from-microsoft"
+      },
+      {
+        "name": "Teams development videos from the community",
+        "url": "https://aka.ms/community/videos/m365powerplatform"
+      }
+    ]
+  }
+]