使用此处的“Hello World”Microsoft Teams 应用程序示例:https://github.com/OfficeDev/msteams-samples-hello-world-csharp https://github.com/OfficeDev/msteams-samples-hello-world-csharp
在调用来自消息传递扩展的操作命令后,尝试获取个人 Microsoft Teams 1:1 聊天的参与者列表。具体来说,我需要其他参与者的电子邮件地址,而我是第一个参与者。
这是消息控制器的代码:
[BotAuthentication]
public class MessagesController : ApiController
{
[HttpPost]
public async Task<HttpResponseMessage> Post([FromBody] Activity activity)
{
using (var connector = new ConnectorClient(new Uri(activity.ServiceUrl)))
{
if (activity.IsComposeExtensionQuery())
{
// Invoke the command handler
var response = await MessageExtension.HandleMessageExtensionQuery(connector, activity).ConfigureAwait(false);
return response != null
? Request.CreateResponse<ComposeExtensionResponse>(response)
: new HttpResponseMessage(HttpStatusCode.OK);
}
else
{
await EchoBot.EchoMessage(connector, activity);
return new HttpResponseMessage(HttpStatusCode.Accepted);
}
}
}
}
代码来自MessageExtension.HandleMessageExtensionQuery
如下:
public static async Task<ComposeExtensionResponse> HandleMessageExtensionQuery(ConnectorClient connector, Activity activity)
{
var query = activity.GetComposeExtensionQueryData();
if (query == null)
{
return null;
}
// Exception thrown here - error 403, there is no additional data except "Operation returned an invalid status code 'Forbidden'"
var members = await connector.Conversations.GetConversationMembersAsync(activity.Conversation.Id);
var handler = GetCommandHandler(query.CommandId); // Gets a handler based on the command, irrelevant for this question
if (handler == null)
{
return null;
}
return await handler.HandleCommand(query, members); // Should handle the command, but never comes here if we are in a 1:1 conversation
}
致电给GetConversationMembersAsync
失败并显示以下消息:Operation returned an invalid status code 'Forbidden'
如果该命令是从两个人之间 1:1 的个人对话中调用的。
如果从组通道调用,则呼叫不会失败。
如何获取1:1私人对话的参与者名单?我是否必须通过机器人对我的用户进行身份验证才能执行此操作,或者我是否必须授予我的机器人某些特定权限?我的帐户是否需要具有某些特定权限才能执行此操作?
编辑 - 添加了应用程序清单
{
"$schema": "https://developer.microsoft.com/en-us/json-schemas/teams/v1.5/MicrosoftTeams.schema.json",
"manifestVersion": "1.5",
"version": "1.0.0",
"id": "1ce95960-0417-4469-ab77-5052758a4e7e",
"packageName": "com.contoso.helloworld",
"developer": {
"name": "Contoso",
"websiteUrl": "https://8112abe3.ngrok.io",
"privacyUrl": "https://8112abe3.ngrok.io/privacy-policy",
"termsOfUseUrl": "https://8112abe3.ngrok.io/terms-service"
},
"icons": {
"color": "color.png",
"outline": "outline.png"
},
"name": {
"short": "Hello World",
"full": "Hello World App"
},
"description": {
"short": "Hello World App for Microsoft Teams",
"full": "This sample app provides a very simple app. You can extend this to add more content and capabilities."
},
"accentColor": "#60A18E",
"configurableTabs": [
{
"configurationUrl": "https://526d7c43.ngrok.io/configure",
"canUpdateConfiguration": true,
"scopes": [
"team",
"groupchat"
]
}
],
"staticTabs": [
{
"entityId": "com.contoso.helloworld.hellotab",
"name": "Hello Tab",
"contentUrl": "https://8112abe3.ngrok.io/hello",
"websiteUrl": "https://8112abe3.ngrok.io/hello",
"scopes": [
"personal"
]
}
],
"bots": [
{
"botId": "bfbcb607-5c29-4438-85a5-15e63fb0b273",
"scopes": [
"personal",
"team",
"groupchat"
],
"supportsFiles": false,
"isNotificationOnly": false
}
],
"composeExtensions": [
{
"botId": "bfbcb607-5c29-4438-85a5-15e63fb0b273",
"canUpdateConfiguration": true,
"commands": [
{
"id": "getRandomText",
"type": "query",
"title": "Get random text",
"description": "",
"initialRun": true,
"fetchTask": false,
"context": [
"commandBox",
"compose",
"message"
],
"parameters": [
{
"name": "cardTitle",
"title": "Subject",
"description": "",
"inputType": "text"
}
]
}
]
}
],
"permissions": [
"identity",
"messageTeamMembers"
],
"validDomains": [
"8112abe3.ngrok.io"
]
}
编辑 2 - 尝试后,基于示例 51 - TeamsMessagingExtensionsAction
按照建议,我尝试了示例 51 名为“TeamsMessagingExtensionsAction” https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/csharp_dotnetcore/51.teams-messaging-extensions-action代码是:
MicrosoftAppCredentials.TrustServiceUrl(turnContext.Activity.ServiceUrl);
var members = (await turnContext.TurnState.Get<IConnectorClient>().Conversations.GetConversationMembersAsync(
turnContext.Activity.Conversation.Id).ConfigureAwait(false)).ToList();
异常以及堆栈跟踪:
Microsoft.Bot.Schema.ErrorResponseException: Operation returned an invalid status code 'Forbidden'
at Microsoft.Bot.Connector.Conversations.GetConversationMembersWithHttpMessagesAsync(String conversationId, Dictionary`2 customHeaders, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Connector\Conversations.cs:line 1462
at Microsoft.BotBuilderSamples.Bots.TeamsMessagingExtensionsActionBot.ShareMessageCommand(ITurnContext`1 turnContext, MessagingExtensionAction action) in D:\Visual Studio Projects\botbuilder-samples\samples\csharp_dotnetcore\51.teams-messaging-extensions-action\Bots\TeamsMessagingExtensionsActionBot.cs:line 68
at Microsoft.BotBuilderSamples.Bots.TeamsMessagingExtensionsActionBot.OnTeamsMessagingExtensionSubmitActionAsync(ITurnContext`1 turnContext, MessagingExtensionAction action, CancellationToken cancellationToken) in D:\Visual Studio Projects\botbuilder-samples\samples\csharp_dotnetcore\51.teams-messaging-extensions-action\Bots\TeamsMessagingExtensionsActionBot.cs:line 29
at Microsoft.Bot.Builder.Teams.TeamsActivityHandler.OnTeamsMessagingExtensionSubmitActionDispatchAsync(ITurnContext`1 turnContext, MessagingExtensionAction action, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\Teams\TeamsActivityHandler.cs:line 201
at Microsoft.Bot.Builder.Teams.TeamsActivityHandler.OnInvokeActivityAsync(ITurnContext`1 turnContext, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\Teams\TeamsActivityHandler.cs:line 88
at Microsoft.Bot.Builder.Teams.TeamsActivityHandler.OnTurnAsync(ITurnContext turnContext, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\Teams\TeamsActivityHandler.cs:line 39
at Microsoft.Bot.Builder.BotFrameworkAdapter.TenantIdWorkaroundForTeamsMiddleware.OnTurnAsync(ITurnContext turnContext, NextDelegate next, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\BotFrameworkAdapter.cs:line 1158
at Microsoft.Bot.Builder.MiddlewareSet.ReceiveActivityWithStatusAsync(ITurnContext turnContext, BotCallbackHandler callback, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\MiddlewareSet.cs:line 55
at Microsoft.Bot.Builder.BotAdapter.RunPipelineAsync(ITurnContext turnContext, BotCallbackHandler callback, CancellationToken cancellationToken) in d:\a\1\s\libraries\Microsoft.Bot.Builder\BotAdapter.cs:line 182
编辑 3 - 尝试使用示例 57
所以我开始了样本 57 名为“TeamsConversationBot” https://github.com/microsoft/BotBuilder-Samples/tree/master/samples/csharp_dotnetcore/57.teams-conversation-bot和 TLDR;在频道中有效,在私人对话中无效。
以下是执行的步骤:
注意:ngrok 已经使用命令启动ngrok http -host-header=rewrite 3978
我现有的机器人注册已配置为侦听给定的 URL
- 更新了项目的 appsettings.json 配置,以使用 Bot Framework 注册中的 Microsoft 应用程序 ID 和应用程序密码。
- 使用所需的 GUID 编辑 TeamsAppManifest 中包含的 Manifest.json,将其与 PNG 图标一起压缩到 Manifest.zip 中,并使用“上传到 Teams App Studio”导入现有应用程序”,这产生了一个名为“TeamsConversationBot”的新应用程序
- 在 Teams App Studio 中,打开新应用程序进行编辑,转到“测试和分发”,点击“Install“ 进而 ”Add“在下一个屏幕上。
- 再次导航到上面的屏幕,但不是“Add“ 我选择了 ”添加到团队“从下拉菜单中,我将机器人添加到了我所拥有的团队的频道中。
- 在 Visual Studio 中,转到TeamsConversationsBot.cs并设置断点消息所有成员异步方法,在一行中写着
var members = await TeamsInfo.GetMembersAsync(turnContext, cancellationToken);
- 启动项目,转到我在 Teams 中的频道,发送“给所有会员留言” 对于我的机器人,等待上述断点被击中并观察到上述调用成功,即返回成员列表。到目前为止,一切都很好!
- 返回 Teams 应用程序生成器编辑我的“Teams 对话机器人”应用程序。
- 在清单编辑器中,转到“消息传递扩展”选项卡并设置我现有的机器人来侦听消息传递扩展调用。
- 添加了一个新的基于操作的命令,其中包含已定义的参数数量。给它一个 Id、命名一个参数并输入其他必填字段,这并不重要。对于“选择撰写扩展应该工作的上下文”,我选择了“命令盒" and "撰写框“,勾选”初始运行”并点击“Save".
- 使用“再次安装该应用程序测试和分发” -> “Install“ 进而 ”Add“ 按钮。
-
在Visual Studio中,添加以下方法TeamsConversationBot.cs:
protected override async Task<InvokeResponse> OnInvokeActivityAsync(ITurnContext<IInvokeActivity> turnContext, CancellationToken cancellationToken)
{
var connector = turnContext.TurnState.Get<IConnectorClient>();
var conversation = turnContext.Activity.Conversation;
var members = await connector.Conversations.GetConversationMembersAsync(conversation.Id, cancellationToken);
return await base.OnInvokeActivityAsync(turnContext, cancellationToken);
}
在行上设置一个断点var members = await connector.Conversations.GetConversationMembersAsync(conversation.Id, cancellationToken);
并启动项目
- 进入频道,在撰写框下选择消息传递扩展并调用新添加的命令。这触发了上面的断点。执行一步并观察到
members
变量包含频道的所有成员。所以这也有效!
- 进行我和其他团队成员之间的私人对话(我和他们之前都已互相发送消息,以确保对话不为空),选择撰写框下的消息扩展并调用新添加的命令。这再次触发了上述断点。执行了一步并bam!调用导致了未处理的异常
Microsoft.Bot.Schema.ErrorResponseException: Operation returned an invalid status code 'Forbidden'