Skip to content

Agent Integration with Microsoft Teams

Resource Deployment

To proceed with deploying your agent to Teams, we need you to provide:

  • The name you want for the agent
  • The introduction for your agent
  • The description of your agent

With this information, the deployment of your agent can proceed.

Creating the Application in Microsoft Teams

After the deployment is completed, the next step to finalize the integration with Microsoft Teams is to create the Teams application.

  1. Go to the Teams Developer Portal:
    https://dev.teams.microsoft.com/home

  2. Within the portal, create a new application, which will be the app added to Teams.

  3. After creating the application, replace the manifest with the base template below. It contains all the necessary configurations for the bot to function correctly in Teams. This is done by going to the App Package Editor tab.

Base Manifest

{
    "$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.21/MicrosoftTeams.schema.json",
    "manifestVersion": "1.21",
    "version": "1.0.0",
    "id": "${{TEAMS_APP_ID}}",
    "developer": {
        "name": "name",
        "websiteUrl": "https://www.example.com",
        "privacyUrl": "https://www.example.com/privacy",
        "termsOfUseUrl": "https://www.example.com/termofuse"
    },
    "icons": {
        "color": "color.png",
        "outline": "outline.png"
    },
    "name": {
        "short": "name",
        "full": "name"
    },
    "description": {
        "short": "short description",
        "full": "full description"
    },
    "accentColor": "#FFFFFF",
    "bots": [
        {
            "botId": "${{BOT_ID}}",
            "scopes": [
                "personal",
                "team",
                "groupChat"
            ],
            "supportsFiles": false,
            "isNotificationOnly": false,
            "commandLists": [
                {
                    "scopes": ["personal", "team", "groupChat"],
                    "commands": [
                        {
                            "title": "Hi",
                            "description": "Say hi to the bot."
                        }
                    ]
                }
            ]
        }
    ],
    "composeExtensions": [],
    "configurableTabs": [],
    "staticTabs": [],
    "permissions": [
        "identity",
        "messageTeamMembers"
    ],
    "validDomains": []
}

  1. Replace the TEAMS_APP_ID variables. The TEAMS_APP_ID is the ID of the application created in the portal

  2. You may make changes to the names and icons that will be used. Special care should be taken when modifying the icons due to the rules imposed by Microsoft. These rules can be found here: https://learn.microsoft.com/en-us/microsoftteams/platform/concepts/design/design-teams-app-icon-store-appbar.

  3. Download the application’s app package, and you can now upload it to Teams, either for individual use or to publish it for your organization.