diff --git a/msteams-platform/resources/bot-v3/bots-files.md b/msteams-platform/resources/bot-v3/bots-files.md index e0d1cd77f54..897e503e4b7 100644 --- a/msteams-platform/resources/bot-v3/bots-files.md +++ b/msteams-platform/resources/bot-v3/bots-files.md @@ -1,6 +1,6 @@ --- title: Send and receive files from a bot -description: Learn send and receive files from bot using Graph APIs for personal, channel, groupchat scopes. Use Teams bot APIs using code samples based on v3 Bot Framework SDK. +description: Learn send and receive files from bot using Graph APIs for personal, channel, groupchat scopes. Use Teams bot APIs using code samples based on v3 Agents SDK. keywords: teams bots files send receive ms.topic: how-to ms.localizationpriority: medium diff --git a/msteams-platform/resources/bot-v3/bots-message-format.md b/msteams-platform/resources/bot-v3/bots-message-format.md index 2f453b05155..7655cd73a54 100644 --- a/msteams-platform/resources/bot-v3/bots-message-format.md +++ b/msteams-platform/resources/bot-v3/bots-message-format.md @@ -1,6 +1,6 @@ --- title: Bot message format -description: Learn how to format bot messages in Microsoft Teams using Bot Framework SDK including Markdown and HTML tags with platform-specific limitations. +description: Learn how to format bot messages in Microsoft Teams using Agents SDK including Markdown and HTML tags with platform-specific limitations. ms.topic: reference ms.localizationpriority: medium ms.owner: ginobuzz diff --git a/msteams-platform/resources/bot-v3/bots-overview.md b/msteams-platform/resources/bot-v3/bots-overview.md index b088cfe7d13..2e161db628c 100644 --- a/msteams-platform/resources/bot-v3/bots-overview.md +++ b/msteams-platform/resources/bot-v3/bots-overview.md @@ -10,12 +10,12 @@ ms.owner: angovil > [!IMPORTANT] > -> This article is based on the v3 Bot Framework SDK. +> This article is based on the v3 Agents SDK. > > * If you want to create an AI bot, see [create an AI bot](~/bots/how-to/teams-conversational-ai/teams-conversation-ai-overview.md). > * If you want to create a basic bot, see [get started](~/get-started/get-started-overview.md), and if you want to look for current documentation version 4.6 or later of the SDK, see [conversational bots](~/bots/what-are-bots.md). -Build and connect intelligent bots to interact with Microsoft Teams users naturally through chat. Or provide a simple commands-based bot, to be used as your "command-line" interface for your broader Teams app experience. You can make a notification-only bot, which can push information relevant to your users directly to them in a channel or direct message. You can even bring your existing Bot Framework-based bot and add Teams-specific support to make your experience shine. +Build and connect intelligent bots to interact with Microsoft Teams users naturally through chat. Or provide a simple commands-based bot, to be used as your "command-line" interface for your broader Teams app experience. You can make a notification-only bot, which can push information relevant to your users directly to them in a channel or direct message. You can even bring your existing Agents SDK-based bot and add Teams-specific support to make your experience shine. > [!IMPORTANT] > Bots are available in [Government Community Cloud (GCC), GCC High, Department of Defense (DoD)](../../concepts/cloud-overview.md#teams-app-capabilities), and [Teams operated by 21Vianet](../../concepts/sovereign-cloud.md) environments. @@ -38,7 +38,7 @@ With Teams apps, you can make the bot the star of your experience, or just a hel ## Bot APIs -Teams supports most of the [Microsoft Bot Framework](https://dev.botframework.com/). (If you already have a bot that's based on the Bot Framework, you can easily adapt it to work in Teams.) We recommend you use either C# or Node.js to take advantage of our [SDKs](/microsoftteams/platform/#pivot=sdk-tools). These packages extend the basic Bot Builder SDK classes and methods: +Teams supports most of the [Microsoft Bot Framework](https://dev.botframework.com/). (If you already have a bot that's based on the Agents SDK, you can easily adapt it to work in Teams.) We recommend you use either C# or Node.js to take advantage of our [SDKs](/microsoftteams/platform/#pivot=sdk-tools). These packages extend the basic Bot Builder SDK classes and methods: * Using specialized card types like the connector card for Microsoft 365 Groups. * Consuming and setting Teams-specific channel data on activities. @@ -51,7 +51,7 @@ The SDK extensions install dependencies, including the Bot Builder SDK. > [!IMPORTANT] > You can develop Teams apps in any other web-programming technology and call the [Bot Framework REST APIs](/bot-framework/rest-api/bot-framework-rest-overview) directly, but you must perform all token handling yourself. -*Developer Portal for Teams* helps you create and configure your app manifest, and can create your Bot Framework bot for you. It also contains a React control library and an interactive card builder. +*Developer Portal for Teams* helps you create and configure your app manifest, and can create your Agents SDK bot for you. It also contains a React control library and an interactive card builder. ## Outgoing webhooks @@ -61,7 +61,7 @@ Outgoing webhooks allow you to create a simple bot for basic interaction, like k The following articles guide you through the process of creating a great bot for Teams: -* [Create a bot](~/resources/bot-v3/bots-create.md): Take advantage of the great tools, documentation, and community provided by the Bot Framework team. +* [Create a bot](~/resources/bot-v3/bots-create.md): Take advantage of the great tools, documentation, and community provided by the Agents SDK team. * [Talk to your bot](~/resources/bot-v3/bot-conversations/bots-conversations.md): Add basic conversation flow and use channel-specific functionality. If you develop in .NET or Node.js, use our extensions for the Bot Builder SDK to simplify your work. * [Using cards in your bot](~/resources/bot-v3/bots-cards.md): Design cards to communicate and accept user response. * [Respond to bot events](~/resources/bot-v3/bots-notifications.md) @@ -78,7 +78,7 @@ The following articles guide you through the process of creating a great bot for > [!IMPORTANT] > -> This article is based on the v3 Bot Framework SDK. +> This article is based on the v3 Agents SDK. > > * If you want to create an AI bot, see [create an AI bot](~/bots/how-to/teams-conversational-ai/teams-conversation-ai-overview.md). > * If you want to create a basic bot, see [get started](~/get-started/get-started-overview.md), and if you want to look for current documentation version 4.6 or later of the SDK, see [conversational bots](~/bots/what-are-bots.md). @@ -90,27 +90,27 @@ The following articles guide you through the process of creating a great bot for ![Bot Framework registration page](~/assets/images/bots/bfregister.png) > [!NOTE] -> If you don't wish to create your bot in Azure, you **must** use this link to create a new bot: [Bot Framework](https://dev.botframework.com/bots/new). If you select **Create a bot** in the Bot Framework portal instead, you'll [create your bot in Microsoft Azure](#bots-and-microsoft-azure) instead. +> If you don't wish to create your bot in Azure, you **must** use this link to create a new bot: [Bot Framework](https://dev.botframework.com/bots/new). If you select **Create a bot** in the Agents SDK portal instead, you'll [create your bot in Microsoft Azure](#bots-and-microsoft-azure) instead. -2. Build the bot using the [Microsoft.Bot.Connector.Teams](https://www.nuget.org/packages/Microsoft.Bot.Connector.Teams) NuGet package, the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), or the [Bot Connector API](/bot-framework/rest-api/bot-framework-rest-connector-api-reference). +1. Build the bot using the [Microsoft.Bot.Connector.Teams](https://www.nuget.org/packages/Microsoft.Bot.Connector.Teams) NuGet package, the [Bot Framework SDK](https://github.com/microsoft/botframework-sdk), or the [Bot Connector API](/bot-framework/rest-api/bot-framework-rest-connector-api-reference). -3. Test the bot using the [Bot Framework Emulator](/bot-framework/debug-bots-emulator). +2. Test the bot using the [Bot Framework Emulator](/bot-framework/debug-bots-emulator). -4. Deploy the bot to a cloud service, such as [Microsoft Azure](https://azure.microsoft.com/). Alternatively, run your app locally and use a tunneling service such [ngrok](https://ngrok.com) to expose an https:// endpoint for your bot, such as `https://45az0eb1.ngrok-free.app/api/messages`. +3. Deploy the bot to a cloud service, such as [Microsoft Azure](https://azure.microsoft.com/). Alternatively, run your app locally and use a tunneling service such [ngrok](https://ngrok.com) to expose an https:// endpoint for your bot, such as `https://45az0eb1.ngrok-free.app/api/messages`. > [!NOTE] > > ### Bots and Microsoft Azure > -> The Bot Framework portal is optimized for registering bots in Microsoft Azure. Here are some things to know: +> The Agents SDK portal is optimized for registering bots in Microsoft Azure. Here are some things to know: > > * The Microsoft Teams channel for bots registered on Azure is free. Messages sent over the Teams channel won't count towards the consumed messages for the bot. -> * While it's possible to [create a new Bot Framework bot](https://dev.botframework.com/bots/new) without using Azure, you must use [create a new Bot Framework bot](https://dev.botframework.com/bots/new), which is no longer exposed in the Bot Framework portal. +> * While it's possible to [create a new Bot Framework bot](https://dev.botframework.com/bots/new) without using Azure, you must use [create a new Bot Framework bot](https://dev.botframework.com/bots/new), which is no longer exposed in the Agents SDK portal. > * When you edit the properties of an existing bot in the [list of your bots in Bot Framework](https://dev.botframework.com/bots) such as its "messaging endpoint," which is common when first developing a bot, especially if you use [ngrok](https://ngrok.com), you'll see "Migration status" column and a blue "Migrate" button that takes you into the Microsoft Azure portal. Don't select the "Migrate" button unless that's what you want to do; instead, select the name of the bot and you can edit its properties:
![Edit Bot Properties](~/assets/images/bots/bf-migrate-bot-to-azure.png) > * If you register your bot using Microsoft Azure, your bot code doesn't need to be *hosted* on Microsoft Azure. > * If you do register a bot using Azure portal, you must have a Microsoft Azure account. You can [create one for free](https://azure.microsoft.com/free/). To verify your identity when you create one, you must provide a credit card, but it won't be charged; it's always free to create and use bots with Teams. -> * You can now use Developer Portal for Teams to register/update app and bot information directly within Teams. You'll only have to use the Azure portal for adding or configuring other Bot Framework channels such as Direct Line, Web Chat, Skype, and Facebook Messenger. +> * You can now use Developer Portal for Teams to register/update app and bot information directly within Teams. You'll only have to use the Azure portal for adding or configuring other Agents SDK channels such as Direct Line, Web Chat, Skype, and Facebook Messenger.