Skip to content

Latest commit

 

History

History

03-msteams-msgext

README.md

Demo: Implement link unfurling messaging extensions

This completed project is the result of the lab exercise Implement link unfurling messaging extensions that is referenced in the README in this repo.

Prerequisites

Developing Microsoft Teams apps requires an Office 365 tenant, Microsoft Teams configured for development, and the necessary tools installed on your workstation.

For the Office 365 tenant, follow the instructions on Microsoft Teams: Prepare your Office 365 tenant for obtaining a developer tenant if you do not currently have an Office 365 account and to enable Microsoft Teams for your organization.

In order to build custom apps for Microsoft Teams, you must configure Microsoft Teams to enable custom apps and allow custom apps to be uploaded to your tenant. Follow the instructions on the same Prepare your Office 365 tenant page mentioned above.

In this module, you will use Node.js to create custom Microsoft Teams tabs. The exercises in this module assume you have the following tools installed on your developer workstation.

Important

In most cases, installing the latest version of the following tools is the best option. The versions listed here were used when this module was published and last tested.

If you do not have the minimum versions of these prerequisites installed on your workstation, follow the install instructions for each of these tools before proceeding with the exercise.

Run this Completed Project

  • Download the required dependencies for this project by executing the following command in the console:

    npm install

  • Create a new Bot Channel Registration in an Azure subscription & obtain the Azure AD App ID and secret (see the lab exercise referenced above for details on how to do this)

  • Rename the file .env.example to .env.

    Update the MICROSOFT_APP_ID and MICROSOFT_APP_PASSWORD properties with the bot's Azure AD app ID and secret.

    You do not need to edit any values in this file unless you have an existing ngrok license with a reserved subdomain name & auth key. These are only available to paid paid ngrok accounts, but it is not necessary to run the demo.

  • Update the ./src/manifest/manifest.json file's placeholders to reference the Azure AD app's ID.

  • Download the required dependencies for this project by executing the following command in the console:

    gulp ngrok-serve

  • Update the Bot Channel Registration to point to the to the dynamic NGrok URL.

  • In a browser, navigate to https://teams.microsoft.com and sign in with the credentials of a Work and School account.

  • Using the app bar navigation menu, select the Mode added apps button. Then select Browse all apps followed by Upload for me or my teams.

  • In the file dialog that appears, select the Microsoft Teams package in your project. This app package is a ZIP file that can be found in the project's ./package folder.

  • Select the Add button to install the app.