0

I have a Bot Framework V3 SDK implementation (working fine) that can initiate a 1:1 private chat with any user in a specific Team using a Microsoft Teams Bot (installed on the same team). I am having problems trying to migrate it to the V4 SDK.

I read on various articles and other questions that it's not possible to do it unless the user contacts the the bot first (to avoid spamming to users), but this is not true with the V3 version and not an option for the functionality that I need.

The original solution uses the "CreateOrGetDirectConversation" extension method from the Microsoft.Bot.Connector.Teams assembly, but it's not available in the V4 version of the assembly.

I tried using the CreateDirectConversation/CreateDirectConversationAsync methods but with no success (they always result in "Bad Request" errors).

This is the code actually working using the V3 libraries:

// Create 1:1 conversation
var conversation = connectorClient.Conversations.CreateOrGetDirectConversation(botAccount, user, tenantId);
// Send message to the user
var message = Activity.CreateMessageActivity();
message.Type = ActivityTypes.Message;
message.Text = "My message";
connectorClient.Conversations.SendToConversation((Activity)message, conversation.Id);

And I am finding it very hard to migrate. Am I missing something?

Giorgio Nobili
  • 3
  • 2

1 Answers1

2

Per the docs, Proactive messaging for bots:

Bots can create new conversations with an individual Microsoft Teams user as long as your bot has user information obtained through previous addition in a personal, groupChat or team scope. This information enables your bot to proactively notify them. For instance, if your bot was added to a team, it could query the team roster and send users individual messages in personal chats, or a user could @mention another user to trigger the bot to send that user a direct message.

Note: The Microsoft.Bot.Builder.Teams extension is still in Prerelease for V4, which is why samples and code are kind of hard to find for it.

Adding the Middleware

In 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)));
[...]

Prepping Your Bot

In your main <YourBot>.cs:

private readonly SimpleCredentialProvider _credentialProvider;

[...]

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

[...]

Sending the Message

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);

Note: If you need to get user ID's, you can use:

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

Also, I didn't need this in my testing, but if you get 401 errors, you may need to trust the Teams ServiceUrl:

MicrosoftAppCredentials.TrustServiceUrl(turnContext.Activity.ServiceUrl);

Resources

mdrichardson
  • 7,141
  • 1
  • 7
  • 21
  • Hi, thanks for the answer. The serviceUrl is trusted and the Teams V4 NuGet package is installed, but your code gives me this error: "'IConversations' does not contain a definition for 'CreateOrGetDirectConversation' and no accessible extension method 'CreateOrGetDirectConversation' accepting a first argument of type 'IConversations' could be found (are you missing a using directive or an assembly reference?)" I am referencing both Microsoft.Bot.Builder.Teams (4.3.0) and Microsoft.Bot.Connector.Teams (4.3.0) – Giorgio Nobili Jun 12 '19 at 07:48
  • @GiorgioNobili I am sooo sorry! I linked to the wrong NuGet package. Updated the answer with [this](https://www.nuget.org/packages/Microsoft.Bot.Builder.Teams). I also didn't realize that despite those docs being updated recently, they still use code from V3. [This sample](https://github.com/OfficeDev/BotBuilder-MicrosoftTeams-dotnet/blob/1d557dbd9a3196a7eb668f8ebe8e2424f9a31964/CSharp/Samples/Microsoft.Bot.Builder.Teams.RemindMeBot/ReadMe.md) shows how to do proactive messaging. I'll update my answer once I can simplify it. – mdrichardson Jun 12 '19 at 15:39
  • Sorry for the delay but I was able to see your update only today... And it works fine! As you said the documentation is not so clear at the moment, so thanks a lot for your support. – Giorgio Nobili Jun 17 '19 at 08:53