/// <summary>
/// Sends a sender action to a recipient via Facebook Messenger.
/// </summary>
/// <param name="recipient">The recipient in form of a valid <see cref="Recipient"/> subclass.</param>
/// <param name="action">The sender action.</param>
/// <returns></returns>
public async Task SendAction(Recipient recipient, SenderAction action)
{
var message = new SendRequestContainerEntity
{
Recipient = recipient.ToEntity()
};
switch (action)
{
case SenderAction.TypingOn:
message.SenderAction = "typing_on";
break;
case SenderAction.TypingOff:
message.SenderAction = "typing_off";
break;
case SenderAction.MarkAsSeen:
message.SenderAction = "mark_seen";
break;
default:
throw new SenderActionNotSupportedException(action);
}
var result = await _client.Post <SendMessageResponse, MessengerErrorWrapperEntity>(ApiUri.ToString(), message);
if (result.Error != null)
{
throw new MessengerRequestFailedException("text", ApiUri.GetLeftPart(UriPartial.Path), result.HttpCode, result.Error.MessengerError.Code,
result.Error.MessengerError.Message, result.Error.MessengerError.TraceId, result.Error.MessengerError.SubCode);
}
}
/// <summary>
/// Sends a message to a recipient via Facebook Messenger.
/// </summary>
/// <param name="recipient">The message recipient. Must be a valid <see cref="Recipient"/> subclass.</param>
/// <param name="message">The completed message.</param>
/// <param name="messageType">The message type. Defaults to <see cref="MessageType.Standard"/>.</param>
/// <param name="messagingType">The messaging type. Defaults to <see cref="MessagingType.Response"/>.</param>
/// <param name="notificationType">The notification type. Defaults to <see cref="NotificationType.Regular"/>.</param>
/// <param name="tag">An optional message reference tag.</param>
/// <returns>The id of the sent message.</returns>
public async Task <string> SendMessage(
Recipient recipient,
CompletedMessage message,
MessageType messageType = MessageType.Standard,
MessagingType messagingType = MessagingType.Response,
NotificationType notificationType = NotificationType.Regular,
string tag = default
)
{
//todo: split messages every 2000 characters
string messagingTypeString;
switch (messagingType)
{
case MessagingType.Response:
messagingTypeString = "RESPONSE";
break;
case MessagingType.MessageTag:
messagingTypeString = "MESSAGE_TAG";
break;
case MessagingType.Update:
messagingTypeString = "UPDATE";
break;
default:
throw new MessagingTypeNotSupportedException(messagingType);
}
string notificationTypeString;
switch (notificationType)
{
case NotificationType.Regular:
notificationTypeString = "REGULAR";
break;
case NotificationType.SilentPush:
notificationTypeString = "SILENT_PUSH";
break;
case NotificationType.NoPush:
notificationTypeString = "NO_PUSH";
break;
default:
throw new MessagingTypeNotSupportedException(messagingType);
}
var requestContainer = new SendRequestContainerEntity
{
MessagingType = messagingTypeString,
Recipient = recipient.ToEntity(),
NotificationType = notificationTypeString,
Message = message.GetMessageEntity()
};
if (tag != default)
{
requestContainer.Tag = tag;
}
if (messageType == MessageType.Subscription)
{
requestContainer.Tag = "NON_PROMOTIONAL_SUBSCRIPTION";
}
var result = await _client.Post <SendMessageResponse, MessengerErrorWrapperEntity>(ApiUri.ToString(), requestContainer);
if (result.Error != null)
{
throw new MessengerRequestFailedException("text", ApiUri.GetLeftPart(UriPartial.Path), result.HttpCode, result.Error.MessengerError.Code, result.Error.MessengerError.Message, result.Error.MessengerError.TraceId, result.Error.MessengerError.SubCode);
}
return(result.Success.MessageId);
}
