Share via

AppNavigationParameters interface

  • Reference
Package:
@microsoft/teams-js

Type-safer version of parameters for the navigateToApp function

Properties

appId

ID of the app to navigate to
channelId

For apps installed as a channel tab, this ID can be supplied to indicate in which Teams channel the app should be opened This property has no effect in hosts where apps cannot be opened in channels
chatId

Optional ID of the chat or meeting where the app should be opened This property has no effect in hosts where apps cannot be opened in chats or meetings
pageId

Developer-defined ID of the page to navigate to within the app (formerly called entityId)
subPageId

Developer-defined ID describing the content to navigate to within the page. This ID is passed to the application via the subPageId property on the Context object (retrieved by calling getContext)
webUrl

Fallback URL to open if the navigation cannot be completed within the host (e.g., if the target app is not installed)

Property Details

appId

ID of the app to navigate to

appId: AppId

Property Value

AppId

channelId

For apps installed as a channel tab, this ID can be supplied to indicate in which Teams channel the app should be opened This property has no effect in hosts where apps cannot be opened in channels

channelId?: string

Property Value

string

chatId

Optional ID of the chat or meeting where the app should be opened This property has no effect in hosts where apps cannot be opened in chats or meetings

chatId?: string

Property Value

string

pageId

Developer-defined ID of the page to navigate to within the app (formerly called entityId)

pageId: string

Property Value

string

subPageId

Developer-defined ID describing the content to navigate to within the page. This ID is passed to the application via the subPageId property on the Context object (retrieved by calling getContext)

subPageId?: string

Property Value

string

webUrl

Fallback URL to open if the navigation cannot be completed within the host (e.g., if the target app is not installed)

webUrl?: URL

Property Value

URL