Question

我正在开发一个Teams机器人，该机器人需要能够与已知用户（即我们知道Teams用户ID）开始新的1：1对话。

我已经查看了GitHub（https://github.com/OfficeDev/microsoft-teams-sample-complete-csharp）上的“ complete-csharp” OfficeDev示例以及Graph API中与Teams相关的部分，但我看不出有什么必要进行新的对话

我们的目标是通过邀请1：1聊天并请求他们的反馈，使我们的机器人按计划调度已知用户。机器人消息中的按钮将显示反馈表单（通过任务模块）。

Answer 1

团队将其称为“主动消息”。只要您获得Teams使用的用户ID，就很容易做到。

根据文档，Proactive messaging for bots：

只要您的机器人在个人，groupChat或团队范围内拥有通过先前添加获得的用户信息，机器人就可以与单个Microsoft Teams用户创建新的对话。该信息使您的机器人可以主动通知他们。例如，如果您的机器人被添加到团队中，它可以查询团队花名册并在个人聊天中向用户发送个人消息，或者用户可以@提及其他用户以触发该机器人向该用户发送直接消息。

最简单的方法是通过Microsoft.Bot.Builder.Teams中间件。

注意：Microsoft.Bot.Builder.Teams扩展名仍在V4的预发行版中，这就是为什么很难为其找到示例和代码的原因。

添加中间件

在Startup.cs中：

var credentials = new SimpleCredentialProvider(Configuration["MicrosoftAppId"], Configuration["MicrosoftAppPassword"]);

services.AddSingleton(credentials);

[...]

services.AddBot<YourBot>(options =>
{
    options.CredentialProvider = credentials;

    options.Middleware.Add(
        new TeamsMiddleware(
            new ConfigurationCredentialProvider(this.Configuration)));
[...]

准备机器人

在您的主要<YourBot>.cs中：

private readonly SimpleCredentialProvider _credentialProvider;

[...]

public <YourBot>(ConversationState conversationState, SimpleCredentialProvider CredentialProvider)
{
     _credentialProvider = CredentialProvider;

[...]

发送消息

var teamConversationData = turnContext.Activity.GetChannelData<TeamsChannelData>();
var connectorClient = new ConnectorClient(new Uri(activity.ServiceUrl), _credentialProvider.AppId, _credentialProvider.Password);

var userId = <UserIdToSendTo>;
var tenantId = teamConversationData.Tenant.Id;
var parameters = new ConversationParameters
{
    Members = new[] { new ChannelAccount(userId) },
    ChannelData = new TeamsChannelData
    {
        Tenant = new TenantInfo(tenantId),
    },
};

var conversationResource = await connectorClient.Conversations.CreateConversationAsync(parameters);
var message = Activity.CreateMessageActivity();
message.Text = "This is a proactive message.";
await connectorClient.Conversations.SendToConversationAsync(conversationResource.Id, (Activity)message);

注意：如果需要获取用户ID，则可以使用：

var members = (await turnContext.TurnState.Get<IConnectorClient>().Conversations.GetConversationMembersAsync(
    turnContext.Activity.GetChannelData<TeamsChannelData>().Team.Id).ConfigureAwait(false)).ToList();

此外，我在测试中不需要此功能，但是如果遇到401错误，则可能需要trust the Teams ServiceUrl：

MicrosoftAppCredentials.TrustServiceUrl(turnContext.Activity.ServiceUrl);

我的团队机器人如何与已知用户开始新的1：1聊天

1 个答案:

添加中间件

准备机器人

发送消息

资源