[Docs] Add Targeted Messages Support

teams.md/src/components/include/essentials/sending-messages/csharp.incl.md

@@ -45,3 +45,20 @@ app.OnMessage(async context =>
     await context.Send(new MessageActivity("hi!").AddMention(activity.From));
 });
 ```
+
+<!-- targeted-method-name -->
+
+`WithTargetedRecipient`
+
+<!-- targeted-send-example -->
+
+```csharp
+app.OnMessage(async context =>
+{
+    // Using WithTargetedRecipient(true) automatically targets the sender of the incoming message
+    await context.Send(
+        new MessageActivity("This message is only visible to you!")
+            .WithTargetedRecipient(true)
+    );
+});
+```

teams.md/src/components/include/essentials/sending-messages/proactive-messaging/csharp.incl.md

@@ -35,4 +35,19 @@ public static class Notifications
         await app.Send(conversationId, "Hey! It's been a while. How are you?");
     }
 }
+```
+
+<!-- targeted-proactive-example -->
+
+```csharp
+// When sending proactively, you must provide the explicit user ID
+public static async Task SendTargetedNotification(string conversationId, string userId)
+{
+    var teams = app.UseTeams();
+    await teams.Send(
+        conversationId,
+        new MessageActivity("This is a private notification just for you!")
+            .WithTargetedRecipient(userId)
+    );
+}
 ```

teams.md/src/components/include/essentials/sending-messages/proactive-messaging/python.incl.md

@@ -34,4 +34,18 @@ async def send_proactive_notification(user_id: str):
         return
     activity = MessageActivityInput(text="Hey! It's been a while. How are you?")
     await app.send(conversation_id, activity)
+```
+
+<!-- targeted-proactive-example -->
+
+```python
+from microsoft_teams.api import MessageActivityInput
+
+# When sending proactively, you must provide the explicit user ID
+async def send_targeted_notification(conversation_id: str, user_id: str):
+    await app.send(
+        conversation_id,
+        MessageActivityInput(text="This is a private notification just for you!")
+            .with_targeted_recipient(user_id)
+    )
 ```

teams.md/src/components/include/essentials/sending-messages/proactive-messaging/typescript.incl.md

@@ -38,4 +38,19 @@ const sendProactiveNotification = async (userId: string) => {
   const activity = new MessageActivity('Hey! It\'s been a while. How are you?');
   await app.send(conversationId, activity);
 };
+```
+
+<!-- targeted-proactive-example -->
+
+```typescript
+import { MessageActivity } from '@microsoft/teams.api';
+
+// When sending proactively, you must provide the explicit user ID
+const sendTargetedNotification = async (conversationId: string, userId: string) => {
+  await app.send(
+    conversationId,
+    new MessageActivity('This is a private notification just for you!')
+      .withTargetedRecipient(userId)
+  );
+};
 ```

teams.md/src/components/include/essentials/sending-messages/python.incl.md

@@ -46,3 +46,22 @@ async def handle_message(ctx: ActivityContext[MessageActivity]):
 async def handle_message(ctx: ActivityContext[MessageActivity]):
   await ctx.send(MessageActivityInput(text='hi!').add_mention(account=ctx.activity.from_))
 ```
+
+<!-- targeted-method-name -->
+
+`with_targeted_recipient`
+
+<!-- targeted-send-example -->
+
+```python
+from microsoft_teams.api import MessageActivity, MessageActivityInput
+from microsoft_teams.apps import ActivityContext
+
+@app.on_message
+async def handle_message(ctx: ActivityContext[MessageActivity]):
+    # Using with_targeted_recipient(True) automatically targets the sender of the incoming message
+    await ctx.send(
+        MessageActivityInput(text="This message is only visible to you!")
+            .with_targeted_recipient(True)
+    )
+```

teams.md/src/components/include/essentials/sending-messages/typescript.incl.md

@@ -41,3 +41,21 @@ app.on('message', async ({ send, activity }) => {
   await send(new MessageActivity('hi!').addMention(activity.from));
 });
 ```
+
+<!-- targeted-method-name -->
+
+`withTargetedRecipient`
+
+<!-- targeted-send-example -->
+
+```typescript
+import { MessageActivity } from '@microsoft/teams.api';
+
+app.on('message', async ({ send }) => {
+  // Using withTargetedRecipient(true) automatically targets the sender of the incoming message
+  await send(
+    new MessageActivity('This message is only visible to you!')
+      .withTargetedRecipient(true)
+  );
+});
+```

teams.md/src/pages/templates/essentials/sending-messages/README.mdx

@@ -37,3 +37,15 @@ Streaming is currently only supported in 1:1 conversations, not group chats or c
 Sending a message at `@mentions` a user is as simple including the details of the user using the <LanguageInclude section="mention-method-name" /> method
 
 <LanguageInclude section="mention-example" />
+
+## Targeted Messages
+
+:::info[Preview]
+Targeted messages are currently in preview.
+:::
+
+Targeted messages, also known as ephemeral messages, are delivered to a specific user in a shared conversation. From a single user's perspective, it appears as regular inline messages in a conversation. Other participants won't see these messages, making them useful for authentication flows, help or error responses, personal reminders, or sharing contextual information without cluttering the group conversation.
+
+To send a targeted message when responding to an incoming activity, use the <LanguageInclude section="targeted-method-name" /> method. The recipient will automatically be set to the user who sent the incoming message.
+
+<LanguageInclude section="targeted-send-example" />

teams.md/src/pages/templates/essentials/sending-messages/proactive-messaging.mdx

@@ -20,3 +20,15 @@ Then, when you want to send a proactive message, you can retrieve the <LanguageI
 :::tip
 In this example, you see how to get the <LanguageInclude section="conversation-id-field" /> using one of the activity handlers. This is a good place to store the conversation id, but you can also do this in other places like when the user installs the app or when they sign in. The important thing is that you have the conversation id stored somewhere so you can use it later.
 :::
+
+## Targeted Proactive Messages
+
+:::info[Preview]
+Targeted messages are currently in preview.
+:::
+
+Targeted messages, also known as ephemeral messages, are delivered to a specific user in a shared conversation. From a single user's perspective, it appears as regular inline messages in a conversation. Other participants won't see these messages.
+
+When sending targeted messages proactively, you must explicitly specify the recipient's user ID.
+
+<LanguageInclude section="targeted-proactive-example" />