[4675026][ [Doc Feature] Shared/Private Channels - [App developer guidance for SC/PC]

msteams-platform/TOC.yml

@@ -276,7 +276,315 @@
           displayName: loop
         - name: Action extensions
           href: resources/messaging-extension-v3/create-extensions.md
-- name: Manifest for agents or apps
+- name: Build bots and agents
+  expand: true
+  items:
+  - name: Overview
+    href: bots/overview.md
+    displayName: AI bot, bot capability, command bot, workflow bot, custom engine agent, agent, conversational bot, activity handler, bot logic, notification bot
+  - name: Bots and agents in Teams
+    href: bots/build-a-bot.md
+    displayName: Bot samples, Code sample, Teams AI library, Microsoft Bot Framework SDK, build a bot, build AI bot, command bot, workflow bot, custom engine agent, agent, conversational bot, notification bot, tools, platforms, Azure OpenAI, Microsoft 365 Agents Toolkit, Azure AI Foundry
+  - name: Custom engine agent overview
+    href: /microsoft-365-copilot/extensibility/overview-custom-engine-agent?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+    displayName: AI bot, Teams AI library, custom agent
+  - name: Teams AI library
+    items:
+      - name: Get started
+        href: /microsoftteams/platform/teams-ai-library/welcome
+  - name: Bot user experience
+    items:
+    - name: Custom engine agent user experience
+      href: bots/how-to/teams-conversational-ai/ai-ux.md
+      displayName: AI bot user experience, AI bot UX, custom engine agent, AI label, citation, feedback loop    
+    - name: Stream bot messages
+      href: bots/streaming-ux.md
+      displayName: Streaming, response generation, AI library, AI SDK, REST API
+    - name: Enhance AI-generated bot messages
+      href: bots/how-to/bot-messages-ai-generated-content.md
+      displayName: AI label, citations, feedback buttons, sensitivity label, Powered by AI UX Kit
+  - name: Understand bot concepts
+    href: bots/bot-concepts.md
+    displayName: Microsoft Bot Framework SDK, Activity handler, Bot logic, Teams handler
+  - name: Send and receive messages
+    items:
+    - name: Build conversational capability
+      href: bots/build-conversational-capability.md
+      displayName: chat, Messages sent between your Microsoft Teams bot and one or more user, Teams channel data, RSC, conversation with RSC
+    - name: Receive all messages for bots and agents
+      href: bots/how-to/conversations/channel-messages-for-bots-and-agents.md  
+    - name: Channel and group chat conversations with a bot
+      href: bots/how-to/conversations/channel-and-group-conversations.md
+      displayName: Teams conversational bots, mention, tag mention, user mention
+    - name: Create a commands menu
+      href: bots/how-to/create-a-bot-commands-menu.md
+      displayName: compose
+    - name: Conversation events in your Teams bot
+      href: bots/how-to/conversations/subscribe-to-conversation-events.md 
+      displayName: conversation bot, activity, Message reaction events, event handling for install and uninstall events, customize bot conversation, bot conversation events, update bot conversation events
+    - name: Format the bot messages
+      href: bots/how-to/format-your-bot-messages.md
+      displayName: cross-platform support
+    - name: Send and receive files
+      href: bots/how-to/bots-filesv4.md  
+      displayName: receive files using bot
+  - name: Send notifications
+    items:
+    - name: Build notification capability
+      href: bots/build-notification-capability.md
+      displayName: Adapter, notifications
+    - name: Send proactive messages
+      href: bots/how-to/conversations/send-proactive-messages.md
+      displayName: conversationId, send message, bot framework, notification,
+  - name: Command bot in Teams
+    href: bots/how-to/conversations/command-bot-in-teams.md
+    displayName: bot initialization
+  - name: Create prompt suggestions
+    href: bots/how-to/conversations/prompt-suggestions.md
+    displayName: prompt starter, suggested actions
+  - name: Workflow bot in Teams
+    href: bots/how-to/conversations/workflow-bot-in-teams.md
+    displayname: Jira, jira
+  - name: Get Teams-specific context
+    href: bots/how-to/get-teams-context.md
+    displayName: Fetch roster or user profile, get user profile, get roster, get team, get channel, get chat
+  - name: Configure bot scope
+    href: bots/how-to/bot-configuration-experience.md
+    displayName: configuration settings, fetchTask, config/fetch, config/submit
+  - name: Optimize bots with rate limits
+    href: bots/how-to/rate-limit.md
+    displayName: handle rate limit, detect transient exceptions, per thread limit, exponential backoff
+  - name: Apps for shared and private channels
+    href: build-apps-for-shared-private-channels.md
+    displayName: shared channels, private channels
+  - name: Explore advanced bot capabilities
+    items:
+    - name: Modify Teams bot API to fetch team or chat members
+      href: resources/team-chat-member-api-changes.md
+      displayName: team, chat, member, API, bot, fetch, team or chat members
+    - name: Calls and meetings bots
+      items:
+      - name: Overview
+        href: bots/calls-and-meetings/calls-meetings-bots-overview.md
+      - name: Real-time media calls and meetings
+        href: bots/calls-and-meetings/real-time-media-concepts.md
+        displayName: active and dominant speakers, SILK and G.722 for audio and H.264 for video, codec 
+      - name: Register calls and meetings bot
+        href: bots/calls-and-meetings/registering-calling-bot.md
+        displayName: How Bot can create call, join meeting and transfer call
+      - name: Incoming call notifications
+        href: bots/calls-and-meetings/call-notifications.md
+        displayName: Redirects for region affinity, GeoDNS resolution 
+      - name: Application-hosted media bots
+        href: bots/calls-and-meetings/requirements-considerations-application-hosted-media-bots.md
+        displayName: Service Fabric with Virtual Machine Scale Sets, instance-level public 
+- name: Build tabs
+  items:
+  - name: Tabs overview
+    href: tabs/what-are-tabs.md
+    displayName: Webpages embedded in Teams, declare custom tab in app manifest, contentUrl, web apps, device permissions for tabs
+  - name: Prerequisites
+    href: tabs/how-to/tab-requirements.md
+    displayName: clickjacking, device permissions for tabs
+  - name: Create a tab
+    href: tabs/how-to/create-personal-tab.md
+    displayName: App generator, Reorder static personal tabs, channel, or group custom tab, offline tab
+  - name: Get context for your tab
+    href: tabs/how-to/access-teams-context.md
+    displayName: getContext, entityId, groupId, User context, authentication flow from Microsoft Entra ID, retrieve context, theme changes
+  - name: Tab features
+    items:
+    - name: Open content in multi-window
+      href: tabs/open-content-in-stageview.md
+      displayName: Tab in Stageview, Collaborative Stageview, Stageview Multi-window, Stageview Modal, Teams multiwindow
+    - name: Create a configurable tab
+      href: tabs/how-to/create-channel-group-tab.md
+      displayName: create a channel tab or group tab, create a custom channel or group tab with ASP.NET Core, build app using Blazor
+    - name: Create a content page
+      href: tabs/how-to/create-tab-pages/content-page.md
+      displayName: Loading indicator, showLoadingIndicator, personal-scoped custom tab, channel or group custom tab
+    - name: Create a configuration page
+      href: tabs/how-to/create-tab-pages/configuration-page.md
+      displayName: configurationUrl
+    - name: Create a removal page
+      href: tabs/how-to/create-tab-pages/removal-page.md
+      displayName: Reconfigure tab, register remove handler
+    - name: Tabs on mobile
+      href: tabs/design/tabs-mobile.md
+      displayName: Teams Store apps approved by Microsoft for mobile
+    - name: Apps for shared channels
+      href: concepts/build-and-test/shared-channels.md
+      displayName: Cross-tenant notifications, context for shared channel, apps and permissions in shared channels
+    - name: Apps for shared and private channels
+      href: build-apps-for-shared-private-channels.md
+      displayName: shared channels, private channels
+    - name: Send activity feed notifications
+      href: /graph/teams-send-activityfeednotifications?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+      displayName: activity feed, notification, customize notification
+    - name: App caching for your tab app
+      href: tabs/how-to/app-caching.md
+      displayName: App caching, caching, launch time, cache
+    - name: Build a dashboard tab app
+      href: tabs/how-to/Build-a-dashboard-tab-app.md
+      displayName: Dashboard, widget, Graph API call
+- name: Build message extensions
+  items:
+  - name: What are message extensions?
+    href: messaging-extensions/what-are-messaging-extensions.md
+    displayName: handleTeamsMessagingExtensionFetchTask, commands
+  - name: Build message extensions using API
+    expanded: false 
+    items:
+    - name: API-based message extensions
+      href: messaging-extensions/api-based-overview.md
+      displayName: OpenAPI Description, Search, single parameter, search based message extension
+    - name: Create API-based message extensions
+      href: messaging-extensions/create-api-message-extension.md
+      displayName: API-based, Microsoft 365 Agents Toolkit CLI, Developer Portal, Visual Studio Code, Visual Studio
+  - name: Build message extensions using Bot Framework  
+    items:
+    - name: Bot-based message extensions
+      href: messaging-extensions/build-bot-based-message-extension.md
+      displayName: one-on-one conversation, search command, action command, search based message extension, action based message extension
+    - name: Action commands
+      items:
+      - name: Define action commands
+        href: messaging-extensions/how-to/action-commands/define-action-command.md
+        displayName: Command invoke locations, static list of parameters, action command manually
+      - name: Create and send dialogs
+        href: messaging-extensions/how-to/action-commands/create-task-module.md
+        displayName: Initial invoke request, respond to fetchTask, payload activity, handleTeamsMessagingExtensionFetchTask
+      - name: Respond to the dialog submit action
+        href: messaging-extensions/how-to/action-commands/respond-to-task-module-submit.md
+        displayName: Compose, Respond to initial submit action, configure the poll, attribution for bot messages, submit action
+    - name: Search commands
+      items:
+      - name: Define search commands
+        href: messaging-extensions/how-to/search-commands/define-search-command.md
+        displayName: bot-based message extensions
+      - name: Respond to search commands
+        href: messaging-extensions/how-to/search-commands/respond-to-search.md
+        displayName: response card types
+      - name: Universal actions for search based message extensions
+        href: messaging-extensions/how-to/search-commands/universal-actions-for-search-based-message-extensions.md
+        displayName: Handle tap actions, Just-in-time install, JIT
+      - name: Bot-based message extension agent guidelines
+        href: messaging-extensions/dev-guidelines-agents.md
+        displayName: criteria, extend message extension, agent, Microsoft 365 Copilot, Copilot agents, plugins
+      - name: Extend bot-based message extension as agent
+        href: messaging-extensions/build-bot-based-agent.md
+        displayName: extend message extension, search based message extension, M365, Microsoft 365 Copilot
+      - name: Debug an agent for Microsoft 365 Copilot with developer mode
+        href: /microsoft-365-copilot/extensibility/debugging-copilot-plugin?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+        displayName: Copilot, Microsoft 365 Copilot, enabled agents, matched functions, selected functions for execution, function execution details, plugin
+      - name: Copilot handoff
+        href: bots/how-to/conversations/bot-copilot-handoff.md
+        displayName: custom agent, custom engine agent, agent, conversation, Microsoft 365 Copilot, plugins
+    - name: Add link unfurling
+      href: messaging-extensions/how-to/link-unfurling.md
+      displayName: domain listing, wildcards, cache
+    - name: Micro-capabilities for website links
+      href: messaging-extensions/how-to/micro-capabilities-for-website-links.md
+      displayName: App less link unfurling  
+- name: Build apps for Teams meetings and calls
+  items:
+  - name: Apps for meetings and calls
+    href: apps-in-teams-meetings/teams-apps-in-meetings.md
+    displayName: apps in meetings, meeting lifecycle, meeting types in Teams, guest user, in-tenant user, federated or external user, anonymous user, scenes for meetings, meeting participants, app caching in Teams meeting
+  - name: Enable and configure apps for Teams meetings and calls
+    items:
+    - name: Build tabs for meeting
+      href: apps-in-teams-meetings/build-tabs-for-meeting.md
+      displayName: anonymous
+    - name: Build tabs for calling
+      href: apps-in-teams-meetings/build-tabs-for-calling.md
+      displayName: PSTN, calling extensibility, calls in Teams
+    - name: Build apps for meeting stage
+      href: apps-in-teams-meetings/build-apps-for-teams-meeting-stage.md
+      displayName: apps for meeting, share content, share to stage APIs, in-meeting document signing, meeting side panel, customize share button
+    - name: Share in meeting
+      href: concepts/build-and-test/share-in-meeting.md
+      displayName: generate a deep link
+    - name: Build in-meeting notifications
+      href: apps-in-teams-meetings/in-meeting-notification-for-meeting.md
+      displayName: bubble, targeted meeting, in-meeting, notification
+    - name: Enable app icon badging for Teams app
+      href: apps-in-teams-meetings/app-icon-badging-for-your-app.md
+      displayName: app icon badging
+    - name: Extensible conversations for meeting chat
+      href: apps-in-teams-meetings/build-extensible-conversation-for-meeting-chat.md
+    - name: Build apps for anonymous users
+      href: apps-in-teams-meetings/build-apps-for-anonymous-user.md
+      displayName: supportsAnonymousGuestUsers, guest, meetingExtensionDefinition
+    - name: Meeting apps APIs
+      href: apps-in-teams-meetings/meeting-apps-apis.md
+      displayName: OnMessageActivityAsync, payload, recurring, getparticipant, captions, targeted meeting notification, real-time meeting events, meeting start and end events
+  - name: Get meeting transcripts, recordings, and AI summaries
+    items:
+    - name: Meeting transcripts and recordings
+      href: graph-api/meeting-transcripts/overview-transcripts.md
+      displayName: get teams meeting transcripts, get teams meeting recordings, teams automatic meeting recording
+    - name: Get change notifications
+      href: /graph/teams-changenotifications-callrecording-and-calltranscript?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+    - name: Get transcripts
+      href: /graph/api/resources/calltranscript?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+    - name: Get recordings
+      href: /graph/api/resources/callrecording?toc=/microsoftteams/platform/toc.json&bc=/microsoftteams/platform/breadcrumb/toc.json
+    - name: Get AI-generated meeting summaries
+      href: graph-api/meeting-transcripts/meeting-insights.md
+      displayName: get AI insights, get meeting insights, get meeting AI insights, meeting AI insights API
+  - name: Enhanced collaboration with Live Share
+    items:
+    - name: Live Share SDK
+      href: apps-in-teams-meetings/teams-live-share-overview.md
+      displayName: Loop, Fluid Framework, Azure Fluid Relay, distributed data structures, web sockets
+    - name: Getting started
+      items:
+      - name: Quick start guide
+        href: apps-in-teams-meetings/teams-live-share-quick-start.md
+      - name: Dice Roller tutorial
+        href: apps-in-teams-meetings/teams-live-share-tutorial.md
+    - name: Core capabilities
+      href: apps-in-teams-meetings/teams-live-share-capabilities.md
+      displayName: Live Share data structures, broadcast
+    - name: Media synchronization
+      href: apps-in-teams-meetings/teams-live-share-media-capabilities.md
+      displayName: Media synchronization, audio ducking
+    - name: Canvas
+      href: apps-in-teams-meetings/teams-live-share-canvas.md
+      displayName: Inking, cursors, live canvas
+    - name: How-to guides
+      items:
+      - name: Agile Poker tutorial
+        href: sbs-teams-live-share.yml
+      - name: Custom Azure Fluid Relay service
+        href: apps-in-teams-meetings/teams-live-share-how-to/how-to-custom-azure-fluid-relay.md
+        displayName: access token
+    - name: Live Share FAQ
+      href: apps-in-teams-meetings/teams-live-share-faq.md
+  - name: Custom Together Mode scenes in Teams
+    href: apps-in-teams-meetings/teams-together-mode.md
+    displayName: Single virtual scene, scene studio
+  - name: Integrate meetings and calls in external apps
+    href: get-started/b2c-apps.md
+    displayName: Teams meeting, Teams call, Teams meeting and call for external apps, external apps
+- name: Build webhooks and connectors
+  items:
+  - name: Overview
+    href: webhooks-and-connectors/what-are-webhooks-and-connectors.md
+    displayName: Webhooks, Connectors, endpoint, message in channel, Teams message
+  - name: Create Outgoing Webhooks
+    href: webhooks-and-connectors/how-to/add-outgoing-webhook.md
+    displayName: HMAC security token, message in channel, Teams message
+  - name: Create Incoming Webhooks (Deprecated)
+    href: webhooks-and-connectors/how-to/add-incoming-webhook.md
+    displayName: share content in Microsoft Teams channels, external applications, message in channel, Teams message, incoming webhook
+  - name: Create connectors for Microsoft 365 Groups (Deprecated)
+    href: webhooks-and-connectors/how-to/connectors-creating.md
+  - name: Create and send messages (Deprecated)
+    href: webhooks-and-connectors/how-to/connectors-using.md
+    displayName: MessageCard, Attachments, potentialAction, Send messages using cURL and PowerShell, Rate limiting for connectors, ActionCard, message in channel, Teams message
+- name: Build cards and dialogs
   items:
     - name: Manifest schema for agents or apps
       href: resources/schema/manifest-schema.md