azure - 通过 Teams 聊天机器人从外部流程向组织用户发送主动消息

Question

我通过 Teams 在我的组织中安装了 Azure 机器人。与机器人的交互正常运行。

我们有一个场景，需要从外部进程(在 Azure 中运行的 C# 应用程序)向用户发送通知。

我尝试使用 Bot Framework REST API与用户创建对话，然后向他们发送通知，如 here 所示

此方案不起作用，因为我无法获取不使用全局机器人框架租户的机器人的访问 token 。我们的机器人作为 SingleTenant BotType 安装在我们的 Azure 租户上，因此我收到以下错误:

 Application with identifier 'BOT-APP-ID' was not found in the directory 'Bot Framework'

我尝试过各种选项，包括 DirectLine channel 、BotConnector SDK 和 Power Automate - 但似乎没有一个能满足我的需求。

有没有办法对我们安装的机器人使用 Rest API 来创建对话和发送消息？这将是理想的选择，因为这样我就可以直接从触发这些通知的事件中启动这些通知。

更新

希尔顿的以下回答使情况变得更加清晰。最终，我不得不部署一个新的机器人集来使用 Multi-Tenancy BotType。

这配置了与 Bot 绑定(bind)的 AppRegistration，也设置为使用 MultiTenant。

此外，在托管 api/messages 端点的 WebApp 中，您必须包含一个名为 MicrosoftAppType 的属性，并将其设置为 MultiTenant以及。以下是 Web 应用程序所需的完整配置:

MicrosoftAppId: [The AppId of the AppRegistration]
MicrosoftAppPassword: [The Secret of the AppRegistration]
MicrosoftAppTenantId: [Your Tenant Id]
MicrosoftAppType: MultiTenant

为了捕获 ConversationId、ServiceUrl 和 UserId，我将以下内容添加到 OnMembersAddedAsync

foreach (var member in membersAdded)
{
    if (!string.IsNullOrEmpty(member.AadObjectId))
    {
        //This is a user in our AAD. Store the conversation id reference:
        var userId = member.AadObjectId;
        var serviceUrl = turnContext.Activity.ServiceUrl;
        var conversationId = turnContext.Activity.Conversation.Id;

        //Save variables to your state store here...
    }
    else
    {
         // This is likely a test outside of Teams 
         //var userId = member.Id; //<-- Not used in my scenario
    }
}

然后在我的外部应用程序(本例中为控制台)中，我可以使用这些变量(以及 AppRegistration 凭据)来创建 Bot ConnectorClient 并更新对话:

using Microsoft.Bot.Connector;
using Microsoft.Bot.Connector.Authentication;
using Microsoft.Bot.Schema;


var botAppId = "[BOT_ID/APP_REG_ID]";
var botAppKey = "[APP_REG_SECRET]";
var conversationId = "[CONVERSATION_ID]";
var serviceUrl = "[SERVICE_URL]";

MicrosoftAppCredentials.TrustServiceUrl(serviceUrl);
var connector = new Microsoft.Bot.Connector.ConnectorClient(new Uri(serviceUrl), botAppId, botAppKey);

var activity = new Activity()
{
    Text = "Proactively saying **Hello**",
    Type = ActivityTypes.Message,
    Conversation = new ConversationAccount(false, "personal", conversationId)
};

try
{
    var result = await connector.Conversations.SendToConversationAsync(conversationId, activity);

    Console.WriteLine("Notification sent!");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

Answer 1

主动消息传递绝对是您所寻找的，但有一些重要的事情需要注意。这是一个示例 https://github.com/pnp/teams-dev-samples/tree/main/samples/bot-proactive-messaging希望这会很有用 - 我包含了 C# 和 Node 版本以及一些进一步阅读的链接，这里有一个视频 session 的链接，我在其中详细讨论了这个概念:https://www.youtube.com/watch?v=mM7-fYdcJhw&t=1398s .

简单来说，请记住 Bot Framework 可以在许多环境中使用，Teams 只是其中之一。重要的是，与其他环境不同，当您在 Teams 中时，不存在与用户“创建”对话的概念。只有一次“对话”，而你基本上是在“继续”对话。因此，您想要调用 continueConversation。在我上面链接的同一示例中，这里是 relevant line 。在幕后，这确实是在调用 REST API，但像这样包装起来更容易。

但是，正如示例所示，由于您无法开始对话，并且只能继续一个对话，因此您需要确保已经拥有对话上下文，这也可能意味着确保用户已将机器人安装到个人上下文中(这实际上是开始对话的原因)。 Here就是样本中发生这种情况的地方。

如果您的用户已经安装了机器人，那么它只是存储对话上下文的情况，就像我在示例中所示的那样。如果没有，并且您想了解如何预安装机器人，请参阅此问题:Proactively Install / Push Apps in Teams for Multiple Users