Teams bot update process.

Question

Teams bot update process.

yaroslav timaiv 0

Hello,

We have deployed our Teams bot to the Teams Bot Store and are planning to implement significant changes, such as updating the application from version 1.0.0 to 2.0.0. The changes include:

Updating the Teams bot connector endpoint domain (also known as 'api/messages')
Publishing a new manifest with additional commands and features (e.g., SSO).

Our goal is to minimize user downtime, as the version review and update process takes some time. One possible solution is to support both versions (e.g., v1.0.0 and v2.0.0) using different backends (different Azure App Services).

As a result, we have the following questions:

When will the Teams app (and bot, e.g., command list) be updated after the Microsoft Store review? For example, after a PC reboot, app restart, one week, etc.
How can we check from which version (de facto - manifest version) a user message/activity originates, whether from v1.0.0 or v2.0.0, considering:
- It is possible that the user does not restart the app or browser for a while (refer to question 1).
- The Microsoft review takes some time.
When can we be sure that all users have upgraded their Teams bot to the latest version

1 answer

Your answer

Answer 1

Prasad-MSFT 8,716 Microsoft External Staff

After the Microsoft Store review, the Teams app (including the bot) will be updated automatically in the contexts where the user is a member and where the previous version of the app was added. https://learn.microsoft.com/en-us/microsoftteams/apps-update-experience
The update process typically takes 1-2 business days based on your app's capabilities. Users might need to restart their Teams client or browser to see the updates immediately, but the app will eventually update even without a restart.
To determine which version a user message/activity originates from, you can include version-specific identifiers in the bot's responses or metadata. For example, you can add a custom property in the bot's activity payload that indicates the version of the bot.
To ensure that all users have upgraded to the latest version of the Teams bot, you can monitor the usage and adoption metrics through the Teams admin center or your backend analytics.

yaroslav timaiv 0

Hi!

I can't understand how to determine the installed bot version, particularly for plain message activities (not cards). What do you mean by "include version-specific identifiers in the bot's responses or metadata"? Do you mean adding some property to the response activity, like:

activity.Properties["botVersionTest"] = "1.0.0";

How can the bot's response activity impact the user's message activity? The user can also view the same bot message on different applications (with different versions). For example, if a user sends a "test-welcome" message, even if we respond before that with the code I mentioned above, we get the next user activity without any version-specific fields.

{
   "text":"test-welcome",
   "textFormat":"plain",
   "attachments":[
      {
         "contentType":"text/html",
         "content":"<p>test-welcome</p>"
      }
   ],
   "type":"message",
   "timestamp":"2024-08-09T16:36:31.7112974Z",
   "localTimestamp":"2024-08-09T19:36:31.7112974+03:00",
   "id":"1723221391679",
   "channelId":"msteams",
   "serviceUrl":"https://smba.trafficmanager.net/emea/",
   "from":{
      "id":"Redacted",
      "name":"[Redacted]",
      "aadObjectId":"Redacted"
   },
   "conversation":{
      "conversationType":"personal",
      "tenantId":"Redacted",
      "id":"Redacted"
   },
   "recipient":{
      "id":"Redacted",
      "name":"Redacted"
   },
   "entities":[
      {
         "locale":"en-US",
         "country":"US",
         "platform":"Windows",
         "timezone":"Europe/Kiev",
         "type":"clientInfo"
      }
   ],
   "channelData":{
      "tenant":{
         "id":"Redacted"
      }
   },
   "locale":"en-US",
   "localTimezone":"Europe/Kiev"
}

yaroslav timaiv 0

Hi!

I can't understand how to determine the installed bot version, particularly for plain message activities (not cards).

What do you mean by "include version-specific identifiers in the bot's responses or metadata"?

Do you mean adding some property to the response activity, like:

activity.Properties["botVersionTest"] = "1.0.0";

How can the bot's response activity impact the user's message activity?

The user can also view the same bot message on different applications (with different versions).

For example, if a user sends a "test-welcome" message, even if we respond before that with the code I mentioned above,

we get the next user activity without any version-specific fields.

{
   "text":"test-welcome",
   "textFormat":"plain",
   "attachments":[
      {
         "contentType":"text/html",
         "content":"<p>test-welcome</p>"
      }
   ],
   "type":"message",
   "timestamp":"2024-08-09T16:36:31.7112974Z",
   "localTimestamp":"2024-08-09T19:36:31.7112974+03:00",
   "id":"1723221391679",
   "channelId":"msteams",
   "serviceUrl":"https://smba.trafficmanager.net/emea/",
   "from":{
      "id":"Redacted",
      "name":"[Redacted]",
      "aadObjectId":"Redacted"
   },
   "conversation":{
      "conversationType":"personal",
      "tenantId":"Redacted",
      "id":"Redacted"
   },
   "recipient":{
      "id":"Redacted",
      "name":"Redacted"
   },
   "entities":[
      {
         "locale":"en-US",
         "country":"US",
         "platform":"Windows",
         "timezone":"Europe/Kiev",
         "type":"clientInfo"
      }
   ],
   "channelData":{
      "tenant":{
         "id":"Redacted"
      }
   },
   "locale":"en-US",
   "localTimezone":"Europe/Kiev"
}

Prasad-MSFT 8,716 Reputation points Microsoft External Staff

2024-08-12T11:19:39.68+00:00
We checked this at our end and also observed that there doesn't seem to be any way to get installed app version details from bot's response. The way possible to get the version details is as below:

Use the Microsoft Graph API to fetch the details of the installed app. https://learn.microsoft.com/en-us/graph/api/userteamwork-list-installedapps?view=graph-rest-1.0&tabs=http#example-2-get-the-names-and-other-details-of-apps-installed-for-the-user

Once you have the app details, you can extract the version information from the response.

Share via

Teams bot update process.

1 answer

Your answer