Build a basic app

  • 15 minutes

In the previous unit, you learned how to make the bot available on Microsoft Teams. Now, learn how to wrap the bot into a Teams app by using Developer Portal.

Use Developer Portal to create a basic app

Developer Portal for Teams makes it easy to start creating or integrating your own Teams apps, whether you develop custom apps for your enterprise or software as a service (SaaS) applications. Developer Portal streamlines the creation of the manifest and package for your app and provides useful tools like the Adaptive Cards editor and a Scene studio. For more information, see Developer Portal for Teams.

  1. Open Microsoft Teams.

  2. Select Apps in the lower-left corner of the window. All of the published applications display. Keep in mind that Microsoft Teams is an organization-specific platform.

  3. To create the health bot app, search for and select Developer Portal.

    Screenshot that shows search results for Developer Portal.

  4. Select Add.

    Screenshot that shows the Add button.

  5. The Developer Portal app opens. Select the Apps tab at the top of the page, and then select New App.

    Screenshot that shows the Apps tab and the New app button.

  6. Enter a short name for the app, such as ParamedicBot, and then select Add.

  7. Enter the following values under Basic information:

    • Full name: A paramedic bot built on Azure Health Bot platform
    • Short description: Simple bot collecting information from the user
    • Full description: Simple bot collecting information from the user and storing the data in the SQL database
    • Version: 1.0.0
    • Developer or company name: Contoso
    • Website: https://github.com/
    • App URLs: https://github.com/

    Because this bot is a demo, use https://github.com/ for all of the URL values.

    Screenshot that shows the Basic information values.

  8. You can also provide a Microsoft Entra app ID. To learn how to generate one, see create a Microsoft Entra application and service principal that can access resources. This step is optional.

  9. Under Configure, select Branding. Branding is about the appearance of the app, such as the icon.

  10. Select Color icon. Choose an image. The image dimensions should be 192 x 192 pixels. Because this bot is a health bot, we're using the official Health Bot icon. You can also choose an accent color.

    Screenshot that shows the Branding section with the Color Icon button selected.

  11. Under Advanced, select App content. Select the Loading indicator and Full-screen mode checkboxes.

    Screenshot that shows the App content menu and Loading Indicator and Full-screen mode checkboxes selected.

  12. Under Configure, select App features, and then select Bot.

    Screenshot that shows the App features section with Bot selected.

  13. Now set up the bot. Because we already have the bot configured on the Azure Health Bot platform, select Enter a bot ID. This ID is the same one you copied for the Teams channel in the previous unit. It's a unique ID that's specific to your bot.

  14. Under Select the scopes in which people can use this command, select Personal and Team, and then select Save.

    Screenshot that shows the Bot ID entered and the scopes selected.

  15. To preview the bot, select Preview in Teams.

  16. Under Publish, you can review your app package, publish to your organization, or publish to the Teams store. You must have IT admin rights to publish the bot for your organization.

The app is now ready! You've wrapped the bot into a Teams app. It can now be shipped to anyone in the organization.