修复 Teams 频道消息发送中的 Azure Bot 错误“Bot Not Part of the Conversation Roster”

解决方案 1：验证 Azure Bot Framework 中的机器人权限和范围

此解决方案在后端使用 JavaScript 和 Node.js，以确保将机器人正确添加到 Teams 频道的对话名册中。

// Import the necessary modules
const { ConnectorClient } = require('botframework-connector');
const { TeamsChannelData, ChannelInfo, TeamInfo, TenantInfo } = require('botbuilder');
// Function to add bot to conversation roster
async function addBotToConversationRoster(connectorClient, teamId, tenantId, activity) {
   try {
      // Define channel data with team, channel, and tenant info
      const channelData = new TeamsChannelData({
         Channel: new ChannelInfo(teamId),
         Team: new TeamInfo(teamId),
         Tenant: new TenantInfo(tenantId)
      });
      // Define conversation parameters
      const conversationParameters = {
         IsGroup: true,
         ChannelData: channelData,
         Activity: activity
      };
      // Create a conversation in the channel
      const response = await connectorClient.Conversations.createConversation(conversationParameters);
      return response.id;
   } catch (error) {
      console.error('Error creating conversation:', error.message);
      if (error.code === 'BotNotInConversationRoster') {
         console.error('Ensure bot is correctly installed in the Teams channel.');
      }
   }
}

解决方案 2：使用 REST API 验证对话名册

此解决方案使用 REST API 和 HTTP 请求来验证机器人在名册中的存在并加入 Teams 对话。

// Define REST API function for checking bot's roster membership
const axios = require('axios');
async function checkAndAddBotToRoster(teamId, tenantId, botAccessToken) {
   const url = `https://smba.trafficmanager.net/amer/v3/conversations/${teamId}/members`;
   try {
      const response = await axios.get(url, {
         headers: { Authorization: `Bearer ${botAccessToken}` }
      });
      const members = response.data; // Check if bot is in the roster
      if (!members.some(member => member.id === botId)) {
         console.error('Bot not in conversation roster. Adding bot...');
         // Call function to add bot to the roster
         await addBotToConversationRoster(teamId, tenantId);
      }
   } catch (error) {
      console.error('Error in bot roster verification:', error.message);
      if (error.response && error.response.status === 403) {
         console.error('Forbidden error: Check permissions.');
      }
   }
}

单元测试：验证机器人的存在和权限

使用 Mocha 和 Chai 框架在 Node.js 中进行单元测试，以验证机器人在 Teams 中的存在并检查访问问题的错误处理。

const { expect } = require('chai');
const { addBotToConversationRoster, checkAndAddBotToRoster } = require('./botFunctions');
describe('Bot Presence in Teams Roster', function() {
   it('should add bot if not in roster', async function() {
      const result = await checkAndAddBotToRoster(mockTeamId, mockTenantId, mockAccessToken);
      expect(result).to.equal('Bot added to roster');
   });
   it('should return error for forbidden access', async function() {
      try {
         await checkAndAddBotToRoster(invalidTeamId, invalidTenantId, invalidAccessToken);
      } catch (error) {
         expect(error.response.status).to.equal(403);
      }
   });
});

Azure Bot 名册问题的常见问题和解答

1. 机器人收到 BotNotInConversationRoster 错误的主要原因是什么？
2. 该机器人可能无法正确添加到 conversation roster，它管理 Teams 渠道内的机器人权限。
3. 如何将机器人添加到 Teams 对话名单中？
4. 使用类似命令 createConversation 在 Azure Bot Framework 中建立机器人对通道的访问。
5. 是否可以使用代码自动执行机器人名册检查？
6. 是的，使用 axios.get Node.js 或类似的 REST API 调用可以自动验证机器人是否在名册中。
7. 为什么机器人只在团队频道中失败而在私人消息中有效？
8. 团队频道有更严格的访问控制；确保机器人有正确的 TeamsChannelData 配置，包括正确的 TenantInfo。
9. 哪些工具可以帮助测试 Teams 中的机器人访问问题？
10. 使用 Mocha 和 Chai 用于设置单元测试的框架，以验证特定 Teams 通道的机器人权限和错误处理。
11. 如何解决 Teams 中机器人的 403 禁止错误？
12. 确保机器人在 Azure 中正确注册，并且 tenant 和 channel 权限更新于 Azure AD。
13. 每个团队都需要单独注册机器人吗？
14. 是的，每个团队和频道可能有独特的名单；证实 ChannelInfo 和 TenantInfo 对于每一个。
15. 机器人在团队频道中工作需要什么权限？
16. 确保权限，如 ChannelMessage.Read 和 ChannelMessage.Send 在 Azure AD 中设置为组访问。
17. 我可以手动查看或更新机器人的名册吗？
18. 是的，管理员可以直接在 Teams 管理中心或使用 Graph API 更新和管理机器人角色。
19. 如何查看租户和渠道ID？
20. 使用检索 ID TeamsChannelData 或通过 Teams 开发人员门户准确配置机器人访问。
21. Azure Bot Framework 是否自动处理机器人名册更改？
22. 并非总是如此；如果频道权限或团队成员发生变化，请重新检查机器人设置，因为它可能会失去访问权限，恕不另行通知。

解决 Microsoft Teams 频道中的 Azure 机器人访问问题

通过故障排除 机器人不在对话名册中 错误后，团队可以在渠道中重新获得高效的机器人功能，使机器人能够按预期传递通知和更新。测试配置和审查权限是持续操作的关键步骤，因为权限在动态环境中可能会频繁更改。

优化 Microsoft Teams 的机器人设置可确保依赖自动渠道更新的人员的工作流程更加顺畅。定期检查访问权限并使用有针对性的 API 调用进行验证有助于维持可靠的机器人体验，因此团队可以专注于协作工作而不是故障排除。 🤖