Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Bots/Messaging Extension

Bots allow users to interact with your web service through text, interactive cards, and task modules. Messaging extensions allow users to interact with your web service through buttons and forms in the Microsoft Teams client. They can search, or initiate actions, in an external system from the compose message area, the command box, or directly from a message.



Configure Ngrok

Your app will be run from a localhost server. You will need to setup Ngrok in order to tunnel from the Teams client to localhost.

Run Ngrok

Run ngrok - point to port 3978

ngrok http -host-header=rewrite 3978

Update Bot Framework Messaging Endpoint

Note: You can also do this with the Manifest Editor in App Studio if you are familiar with the process.

  • For the Messaging endpoint URL, use the current https URL you were given by running ngrok and append it with the path /api/messages. It should like something work

  • Click on the Bot menu item from the toolkit and select the bot you are using for this project. Update the messaging endpoint and press enter to save the value in the Bot Framework.

  • Ensure that you've enabled the Teams Channel

Build and run

In the project directory, you can run:

npm install

Installs the required packages to run the tab.

Run your bot at the command line:

npm start

Deploy to Teams

Development account

Ensure you have access to a Teams account with the appropriate permissions to install an app. If this is your first time developing a Teams app, go through each of the steps in the Prepare your Office 365 tenant page.

Upload the from the .publish folder to Teams (in the Apps view click Upload a custom app


No description, website, or topics provided.






No releases published


No packages published