How to deploy Azure Bot (linked with AI Agent) in Teams via JSON and PNG

Core Services AgentBuilder
1

How to deploy Azure Bot in Teams (linked with AI Agent) via JSON and PNG?

Pre-work：
Create an AI Agent
Create an Azure Bot

Standard Publication Process

Alternative Publication Method

When to Use the Alternative Method

However, there are situations where the standard publication process may not be suitable:

  • Insufficient organizational permissions: Your organization may restrict app publishing capabilities
  • Testing purposes: You may want to test the application privately before wider deployment

Self-Publishing via JSON File

In these cases, you can publish the app independently using:

  • A JSON configuration file
  • A PNG image file (105 * 105 piexels)

Important Limitation

Note: When publishing via JSON file, the application will only be accessible to you personally. This method creates a private deployment that other users cannot access.

Recommendation

Choose the publication method based on your specific needs:

  • Use the standard tutorial process for organization-wide deployment
  • Use the JSON file method for personal testing or when organizational permissions are limited

JSON Format

  • File name：manifest.json, icon_ai_chatbot.png
  • Content：
    {
    “$schema”: “https://developer.microsoft.com/json-schemas/teams/v1.11/MicrosoftTeams.schema.json”,
    “manifestVersion”: “1.11”,
    “version”: “1.0.0”,
    “id”: “MICROSOFT_APP_ID”,
    “packageName”: “com.example.agentbuilder”,
    “developer”: {
    “name”: “AI Agent”,
    “websiteUrl”: “https://www.example.com”,
    “privacyUrl”: “https://www.example.com/privacy”,
    “termsOfUseUrl”: “https://www.example.com/terms”
    },
    “name”: {
    “short”: “AI Agent”,
    “full”: “AI Agent for Teams”
    },
    “description”: {
    “short”: “AI Agent”,
    “full”: “This is an AI Agent that processes activities from Teams via a webhook endpoint.”
    },
    “icons”: {
    “outline”: “icon_ai_chatbot.png”,
    “color”: “icon_ai_chatbot.png”
    },
    “accentColor”: “#FFFFFF”,
    “bots”: [
    {
    “botId”: “MICROSOFT_APP_ID”,
    “scopes”: [
    “personal”,
    “team”,
    “groupchat”
    ],
    “supportsFiles”: false,
    “isNotificationOnly”: false
    }
    ],
    “permissions”: [
    “identity”,
    “messageTeamMembers”
    ],
    “validDomains”: [ ]
    }

Upload the configuration to Teams

After creating the configuration file and icon, put the two files in the same folder and compress them into a ZIP file.

I hope this content can help you.

See you.