/// <summary>
/// Checks the given activity for back channel messages and handles them, if detected.
/// Currently the only back channel message supported is for creating connections
/// (establishing 1:1 conversations).
/// </summary>
/// <param name="activity">The activity to check for back channel messages.</param>
/// <returns>
/// The result:
/// * MessageRouterResultType.Connected: A connection (1:1 conversation) was created
/// * MessageRouterResultType.NoActionTaken: No back channel message detected
/// * MessageRouterResultType.Error: See the error message for details
/// </returns>
public MessageRouterResult HandleBackChannelMessage(Activity activity)
{
MessageRouterResult messageRouterResult = new MessageRouterResult();
if (activity == null || string.IsNullOrEmpty(activity.Text))
{
messageRouterResult.Type = MessageRouterResultType.Error;
messageRouterResult.ErrorMessage = $"The given activity ({nameof(activity)}) is either null or the message is missing";
}
else if (activity.Text.Equals(BackChannelId))
{
if (activity.ChannelData == null)
{
messageRouterResult.Type = MessageRouterResultType.Error;
messageRouterResult.ErrorMessage = "No channel data";
}
else
{
// Handle accepted request and start 1:1 conversation
Party conversationClientParty = null;
try
{
conversationClientParty = ParsePartyFromChannelData(activity.ChannelData);
}
catch (Exception e)
{
messageRouterResult.Type = MessageRouterResultType.Error;
messageRouterResult.ErrorMessage =
$"Failed to parse the party information from the back channel message: {e.Message}";
}
if (conversationClientParty != null)
{
Party conversationOwnerParty = MessagingUtils.CreateSenderParty(activity);
messageRouterResult = RoutingDataManager.ConnectAndClearPendingRequest(
conversationOwnerParty, conversationClientParty);
messageRouterResult.Activity = activity;
}
}
}
else
{
// No back channel message detected
messageRouterResult.Type = MessageRouterResultType.NoActionTaken;
}
return(messageRouterResult);
}
