Skip to content

Latest commit

 

History

History
 
 

nodejs

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
Bots
Bots
 
 
pages
pages
 
 
resources
resources
 
 
teamsAppManifest
teamsAppManifest
 
 
.env
.env
 
 
.eslintrc.js
.eslintrc.js
 
 
README.md
README.md
 
 
index.js
index.js
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 

README.md

page_type description products languages extensions contentType createdDate
sample
Microsoft Teams sample app for demonstrating deeplink from Bot chat to Tab consuming Subentity ID
office-teams
office
office-365
nodejs
samples
07-07-2021 13:38:27

DeepLink

This sample displays how to consume SubEntity Id to DeepLink from Bot to Tab and Tab to Tab.

Prerequisites

  • Node.js version 10.14 or higher

    # determine node version
node --version

  • Ngrok (Only for devbox testing) Latest (any other tunneling software can also be used)

     # run ngrok locally
ngrok http -host-header=localhost 3978

  • Teams Microsoft Teams is installed and you have an account

To try this sample

  1. Clone the repository

    git clone https://github.com/OfficeDev/Microsoft-Teams-Samples.git

    • In a terminal, navigate to samples/tab-deeplink/nodejs

      cd samples/tab-deeplink/nodejs

    • Install modules

      npm install

    • Start the bot

      npm start

  2. If you are using Visual Studio code

    • Launch Visual Studio code
    • Folder -> Open -> Project/Solution
    • Navigate to samples\DeepLinkBotnode\ folder
    • Select DeepLinkBotnode Folder

  3. To run the application required node modules.Please use this command to install modules npm i

  4. Run ngrok - point to port 3978 (This is your Base_URL) ngrok http -host-header=rewrite 3978

  5. Create a new Bot by following steps mentioned in Build a bot documentation.

  6. Go to .env file and add MicrosoftAppId , MicrosoftAppPassword and Base_URL information.

  7. Run your app, either from Visual Studio code with npm start or using Run in the Terminal.

  8. Update the manifest.json file with Microsoft-App-ID,ContentUrl, WebsiteUrl and EntityID value.

  9. Install the app in Teams.

Interacting with the bot

Enter text in the emulator. The text will be echoed back by the bot.

  1. Interact with DeepLink bot by pinging it in personal or channel scope.
  2. Select the option from the options displayed in the adaptive card. This will redirect to the respective Task in the Tab.
  3. Click on Back to List to view all the options. User can select an option which will redirect to the respective Task in the Tab.