Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Doc Improvement][Update hyperlinks text] #11967

Open
wants to merge 12 commits into
base: main
Choose a base branch
from
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ The next section enables you to create a new bot or add calling capabilities to

## Create new bot or add calling capabilities

For information on creating bots, see [create a bot for Teams](../how-to/create-a-bot-for-teams.md).
For information on creating bots, see [create a bot for Teams](../../sbs-gs-bot.yml).

To create a new bot for Teams:

Expand Down
4 changes: 2 additions & 2 deletions msteams-platform/concepts/build-and-test/apps-package.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,9 +33,9 @@ You can create an app and configure the app manifest through one of the followin

* **Teams Toolkit**: A set of tools and extensions in Microsoft Visual Studio Code and Visual Studio to create, debug, and deploy an app. When creating an app, the app manifest generates from a template file based on the selected capabilities. You can then customize in [Visual Studio Code](../../toolkit/TeamsFx-preview-and-customize-app-manifest.md) or [Visual Studio](../../toolkit/toolkit-v4/TeamsFx-preview-and-customize-app-manifest-vs.md) based on your requirements, validate the manifest file, and zip the app package.

* **Teams Developer Portal**: A web-based platform that helps you create your app, configure your app manifest, and generate an app package. To create an app through Teams Developer Portal, see [create and register an app](teams-developer-portal.md).
* **Developer Portal for Teams**: A web-based platform that helps you create your app, configure your app manifest, and generate an app package. To create an app through Developer Portal for Teams, see [create and register an app](teams-developer-portal.md).

You can add bot, tab, message extensions, and other capabilities to your app by updating the app manifest with the required app capability. For more information, see [build app with app capabilities](../../get-started/get-started-overview.md).
You can add bot, tab, message extensions, and other capabilities to your app by updating the app manifest with the required app capability. For more information, see [build app with app capabilities](../../get-started/get-started-overview.md#build-your-first-teams-app).

When you publish your app to the Microsoft Teams Store, ensure your app manifest references to the latest [app manifest schema](~/resources/schema/manifest-schema.md). For sample app manifest, see [Hello world sample app](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/app-hello-world/csharp/demo-manifest/app-hello-world.zip).

Expand Down
14 changes: 2 additions & 12 deletions msteams-platform/concepts/build-and-test/deep-link-teams.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,16 +12,6 @@ ms.date: 01/31/2023

You can create a deep link to a Teams chat, such as to start a new chat, go to a channel conversation, and access a file within a channel.

In this article, you’ll learn to create:

- [Deep link to start a new chat](#deep-link-to-start-a-new-chat)<br>
- [Deep link to navigate to a chat](#deep-link-to-navigate-to-a-chat)<br>
- [Deep link to navigate to channel conversation](#deep-link-to-navigate-to-channel-conversation)<br>
- [Deep link to navigate to chat messages](#deep-link-to-navigate-to-chat-messages)<br>
- [Deep link to navigate to a team](#deep-link-to-navigate-to-a-team)<br>
- [Deep link to navigate to channel](#deep-link-to-navigate-to-channel)<br>
- [Generate deep link to a file in a channel](#generate-deep-link-to-a-file-in-a-channel)

## Deep link to start a new chat

You can navigate to or create private chats between users with the Microsoft Teams JavaScript client library (TeamsJS) by specifying the set of participants. If a chat doesn’t exist with the specified participants, the user is navigated to an empty new chat.
Expand Down Expand Up @@ -112,7 +102,7 @@ The query parameters are:

Example: `https://teams.microsoft.com/l/message/19:253f5895-9a62-4362-8d38-43f0205c702c_f1b94dcf-0aa3-4989-bcdf-ef4a5ed00f86@unq.gbl.spaces/1563480968434?context=%7B%22contextType%22:%22chat%22%7D`

You can start a conversation with a bot using a prepopulated message through a deep link. Use the bot ID prefixed with `28:` in place of an email address. The format of the deep link is:
You can start a conversation with a bot using a prepopulated message through a deep link. Use the bot ID prefixed with `28:` in place of an email address. The format of the deep link is:

`https://teams.microsoft.com/l/chat/0/0?users=28:[bot guid]&message=This%20message%20was%20triggered%20by%20a%20link!`

Expand All @@ -133,7 +123,7 @@ The query parameters are:
* `channelId`: Channel ID of the conversation (URL encoded). For example, 19%3ATWLPKo8lD4v8zDxyw4FnDYY-ovnBJG5CSjmrHUAoOz41%40thread.tacv2.
* `groupId`: Group ID of the file. For example, 72602e12-78ac-474c-99d6-f619710353a9.
* `tenantId`: Tenant ID, such as 72f988bf-86f1-41af-91ab-2d7cd011db47.

> [!Note]
> You can get `channelId` and `groupId` in the URL from the team.

Expand Down
2 changes: 1 addition & 1 deletion msteams-platform/concepts/build-and-test/deep-links.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ You can use deep links in Teams in the following ways:

:::image type="content" source="~/assets/images/deeplink-chat.gif" alt-text="Graphical representation shows the user experience of deep links in chat.":::

* **Deep link to teams and channels**: Use a deep link to navigate to a particular team or channel. For more information, see [deep link to a channel](~/concepts/build-and-test/deep-link-teams.md).
* **Deep link to teams and channels**: Use a deep link to navigate to a particular team or channel. For more information, see [deep link to a channel](deep-link-teams.md#deep-link-to-navigate-to-channel).

:::image type="content" source="~/assets/images/deeplink-teams-and-channels.gif" alt-text="Graphical representation that shows the user experience of deep links in group chat.":::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -212,7 +212,7 @@ You must implement the following:
* If you want to define explicit size in pixels, define it for the width or height. Setting explicit size for any one parameter preserves the image's aspect ratio.
* We recommend that you set the width of the image, though some scenarios might allow for exceptions.

For more information to create plugins for teams meetings, see [enable message extension as a plugin for Copilot for meetings](../../../../messaging-extensions/build-bot-based-plugin.md#enable-message-extension-as-a-plugin-for-copilot-for-meetings).
For more information to create plugins for teams meetings, see [enable message extension as a plugin for Copilot for meetings](../../../../messaging-extensions/build-bot-based-agent.md#enable-message-extension-as-a-plugin-for-copilot-for-meetings).

[Back to top](#validation-guidelines-for-agents)

Expand Down
2 changes: 1 addition & 1 deletion msteams-platform/samples/integrate-web-apps-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ ms.date: 12/15/2022

# Integrate web apps

You can provide an enriched user experience by integrating the features of an existing web application into Microsoft Teams platform. Ensure to follow [Teams design guidelines](~/concepts/design/understand-use-cases.md) to make your app native to Teams.
You can provide an enriched user experience by integrating the features of an existing web application into Microsoft Teams platform. Ensure to follow [Teams design guidelines](../concepts/design/design-teams-app-overview.md) to make your app native to Teams.
This document gives an overview of prerequisites to integrate web applications with Teams, Power platform to create Power apps, Power Virtual Agents, Virtual Assistant, app templates, Shift connectors, Moodle LMS, create a Share-to-Teams button for your website, adding a Teams tab in SharePoint, creating deep links, and integrate device capabilities.

## Prerequisites
Expand Down
8 changes: 2 additions & 6 deletions msteams-platform/tabs/what-are-tabs.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,8 +51,7 @@ The following images show tabs added to different contexts in Teams:
**Teams mobile**

:::image type="content" source="~/assets/images/tabs/mobile-personal-tab-meeting.png" alt-text="Example shows a configurable tab added to a meeting in mobile." lightbox="~/assets/images/tabs/mobile-personal-tab-meeting.png":::
***

---

Following are a few benefits of static tabs in chats, channels, and meetings:

Expand Down Expand Up @@ -127,7 +126,7 @@ You can have multiple channels or group tabs, and up to 16 static tabs per app.
### Tools to build tabs

* [Teams Toolkit for Visual Studio Code](../toolkit/teams-toolkit-fundamentals.md)
* [Teams Toolkit for Visual Studio](../toolkit/visual-studio-overview.md)
* [Teams Toolkit for Visual Studio](../toolkit/toolkit-v4/teams-toolkit-fundamentals-vs.md)

## Next step

Expand All @@ -137,10 +136,7 @@ You can have multiple channels or group tabs, and up to 16 static tabs per app.
## See also

* [Design your tab for Microsoft Teams](design/tabs.md)
* [Device capabilities](../concepts/device-capabilities/device-capabilities-overview.md)
* [Tabs on mobile](design/tabs-mobile.md#tabs-on-mobile)
* [App capabilities mapped to features](../concepts/design/map-use-cases.md#app-capabilities-mapped-to-features)
* [Instrumenting for Teams app specific analytics](../concepts/design/overview-analytics.md#instrumenting-for-teams-app-specific-analytics)
* [Extend tab app with Microsoft Graph permissions and scopes](how-to/authentication/tab-sso-graph-api.md)
* [Microsoft Teams update](../resources/teams-updates.md)
* [Grant tab device permission in Teams](~/sbs-tab-device-permissions.yml)
4 changes: 2 additions & 2 deletions msteams-platform/toolkit/tools-prerequisites.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ Ensure that you have the following accounts before you start building your Teams

If you have a Visual Studio Enterprise or Professional subscription, both programs include a free Microsoft 365 [developer subscription](https://aka.ms/MyVisualStudioBenefits). It's active as long as your Visual Studio subscription is active. For more information, see [Microsoft 365 developer subscription](https://developer.microsoft.com/microsoft-365/dev-program).

If you don't have any Microsoft 365 tenant, you might qualify for a Microsoft 365 E5 developer subscription through the [Microsoft 365 Developer Program](https://aka.ms/m365devprogram); for details, see the [FAQ](/office/developer-program/microsoft-365-developer-program-faq#who-qualifies-for-a-microsoft-365-e5-developer-subscription-). Alternatively, you can sign up for a [1-month free trial](https://www.microsoft.com/microsoft-365/try) or [purchase a Microsoft 365 plan](https://www.microsoft.com/microsoft-365/business/compare-all-microsoft-365-business-products-g).
If you don't have any Microsoft 365 tenant, you might qualify for a Microsoft 365 E5 developer subscription through the [Microsoft 365 Developer Program](https://aka.ms/m365devprogram); for details, see the [FAQ](/office/developer-program/microsoft-365-developer-program-faq#who-qualifies-for-a-microsoft-365-e5-developer-subscription-). Alternatively, you can sign up for a [1-month free trial](https://www.microsoft.com/microsoft-365/try) or [purchase a Microsoft 365 plan](https://www.microsoft.com/microsoft-365/business/compare-all-microsoft-365-business-products).

You can sign up for the developer program using one of the following account types:

Expand Down Expand Up @@ -194,7 +194,7 @@ If you have admin rights, you can enable custom app upload:
5. Select **Save**.

> [!Note]
> It can take up to 24 hours for custom app upload to become active. In the meantime, you can use **upload for your tenant** to test your app. To upload the .zip package file of the app, see [upload custom apps](/microsoftteams/teams-app-setup-policies).
> It can take up to 24 hours for custom app upload to become active. In the meantime, you can use **upload for your tenant** to test your app. To upload the .zip package file of the app, see [upload custom apps](/microsoftteams/teams-custom-app-policies-and-settings).

Ensure that you have the app upload permission using the steps mentioned in [verify custom app upload permission using Visual Studio Code or Teams client](#verify-custom-app-upload-permission).

Expand Down