Teams Bot Notification Error: “operation returned an invalid status code ‘NotFound’” for Some Users

Question

Teams Bot Notification Error: “operation returned an invalid status code ‘NotFound’” for Some Users

Lahib Youssef 0

I have developed a Teams bot that sends notifications to users who have the bot installed. The bot is working correctly for most users, but two specific users are consistently failing to receive notifications. When trying to send a message to these users, I receive the following error:

[OnTurnError] unhandled error : operation returned an invalid status code 'NotFound'

What I Have Tried:

• Checked if GetPagedInstallationsAsync() returns a valid installation reference ✅

• Logged the ConversationReference before sending messages ✅

• Ensured that ServiceUrl is valid ✅

• Checked if users have uninstalled/reinstalled the bot ✅

Key Questions:

Why would SendMessage() return a NotFound error only for some users while working for others?
Could ServiceUrl be stale for these users? How can I refresh it properly?
What other reasons could cause SendMessage() to fail with NotFound for specific users?
Is there a way to validate conversation references before sending a message to prevent failures?

Nivedipa-MSFT 3,646 Reputation points Microsoft External Staff Moderator

2025-03-17T06:28:19.66+00:00

@Lahib Youssef - Thank you for bringing this issue to our attention.
1.There might be user-specific issues causing the NotFound error. Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.
2.The ServiceUrl can indeed become stale. To refresh it, you can capture the ServiceUrl from any incoming activity, such as a message or a conversation update event. Ensure that your bot updates the stored ServiceUrl whenever it receives a new activity.
3.Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.

4.To validate conversation references before sending a message, you can use the GetConversationMembersAsync method to check if the user is still part of the conversation. This can help ensure that the conversation reference is still valid.
Lahib Youssef 0 Reputation points

2025-03-25T07:20:26.4333333+00:00

Hi, is there any news on this ?
Nivedipa-MSFT 3,646 Reputation points Microsoft External Staff Moderator

2025-04-02T09:28:04.28+00:00

@Lahib Youssef - Have you verified the below checkpoints?
1.There might be user-specific issues causing the NotFound error. Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.
2.The ServiceUrl can indeed become stale. To refresh it, you can capture the ServiceUrl from any incoming activity, such as a message or a conversation update event. Ensure that your bot updates the stored ServiceUrl whenever it receives a new activity.
3.Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.

4.To validate conversation references before sending a message, you can use the GetConversationMembersAsync method to check if the user is still part of the conversation. This can help ensure that the conversation reference is still valid.
Lahib Youssef 0 Reputation points

2025-04-04T08:58:37.3833333+00:00

This is a One Way Conversation bot. The user never interacts with the bot at all. Is it possbile to handle an event that has an updated serviceUrl for the user when the user never responds to the bot?
Lahib Youssef 0 Reputation points

2025-05-14T09:35:51.7466667+00:00

Hi, is there any news on giving me information about how to update serviceUrl when the bot is a one way conversation bot?

Your answer

Nivedipa-MSFT 3,646 Reputation points Microsoft External Staff Moderator

2025-03-17T06:28:19.66+00:00

@Lahib Youssef - Thank you for bringing this issue to our attention.
1.There might be user-specific issues causing the NotFound error. Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.
2.The ServiceUrl can indeed become stale. To refresh it, you can capture the ServiceUrl from any incoming activity, such as a message or a conversation update event. Ensure that your bot updates the stored ServiceUrl whenever it receives a new activity.
3.Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.

4.To validate conversation references before sending a message, you can use the GetConversationMembersAsync method to check if the user is still part of the conversation. This can help ensure that the conversation reference is still valid.
Lahib Youssef 0 Reputation points

2025-03-25T07:20:26.4333333+00:00

Hi, is there any news on this ?
Nivedipa-MSFT 3,646 Reputation points Microsoft External Staff Moderator

2025-04-02T09:28:04.28+00:00

@Lahib Youssef - Have you verified the below checkpoints?
1.There might be user-specific issues causing the NotFound error. Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.
2.The ServiceUrl can indeed become stale. To refresh it, you can capture the ServiceUrl from any incoming activity, such as a message or a conversation update event. Ensure that your bot updates the stored ServiceUrl whenever it receives a new activity.
3.Ensure that the users have not disabled the bot or changed their Teams settings in a way that might affect the bot's functionality.

4.To validate conversation references before sending a message, you can use the GetConversationMembersAsync method to check if the user is still part of the conversation. This can help ensure that the conversation reference is still valid.
Lahib Youssef 0 Reputation points

2025-04-04T08:58:37.3833333+00:00

This is a One Way Conversation bot. The user never interacts with the bot at all. Is it possbile to handle an event that has an updated serviceUrl for the user when the user never responds to the bot?
Lahib Youssef 0 Reputation points

2025-05-14T09:35:51.7466667+00:00

Hi, is there any news on giving me information about how to update serviceUrl when the bot is a one way conversation bot?

Share via

Teams Bot Notification Error: “operation returned an invalid status code ‘NotFound’” for Some Users

Your answer