using BotSharp.Abstraction.Files; using BotSharp.Abstraction.Infrastructures; using BotSharp.Abstraction.Repositories; using BotSharp.Core.Infrastructures; using BotSharp.Plugin.Twilio.Interfaces; using BotSharp.Plugin.Twilio.Models; using BotSharp.Plugin.Twilio.Services; using Microsoft.AspNetCore.Http; using Microsoft.AspNetCore.Mvc; using System.ComponentModel.DataAnnotations; using Twilio.Http; namespace BotSharp.Plugin.Twilio.Controllers; public class TwilioVoiceController : TwilioController { private readonly TwilioSetting _settings; private readonly IServiceProvider _services; private readonly IHttpContextAccessor _context; private readonly ILogger _logger; public TwilioVoiceController(TwilioSetting settings, IServiceProvider services, IHttpContextAccessor context, ILogger logger) { _settings = settings; _services = services; _context = context; _logger = logger; } /// /// https://github.com/twilio-labs/twilio-aspnet?tab=readme-ov-file#validate-twilio-http-requests /// /// /// /// /// // [ValidateRequest] [HttpPost("twilio/voice/welcome")] public async Task InitiateConversation(ConversationalVoiceRequest request) { foreach(var header in Request.Headers) { _logger.LogWarning($"{header.Key}: {header.Value}"); } _logger.LogWarning($"{Request.Path}{Request.QueryString}"); var text = JsonSerializer.Serialize(request); if (request?.CallSid == null) { throw new ArgumentNullException(nameof(VoiceRequest.CallSid)); } VoiceResponse response = null; var instruction = new ConversationalVoiceResponse { SpeechPaths = ["twilio/welcome.mp3"], ActionOnEmptyResult = true }; await HookEmitter.Emit(_services, async hook => { await hook.OnSessionCreating(request, instruction); }, new HookEmitOption { OnlyOnce = true }); request.ConversationId = $"TwilioVoice_{request.CallSid}"; instruction.CallbackPath = $"twilio/voice/{request.ConversationId}/receive/0?{GenerateStatesParameter(request.States)}"; var twilio = _services.GetRequiredService(); if (string.IsNullOrWhiteSpace(request.Intent)) { response = twilio.ReturnNoninterruptedInstructions(instruction); } else { int seqNum = 0; var messageQueue = _services.GetRequiredService(); var sessionManager = _services.GetRequiredService(); await sessionManager.StageCallerMessageAsync(request.ConversationId, seqNum, request.Intent); var callerMessage = new CallerMessage() { ConversationId = request.ConversationId, SeqNumber = seqNum, Content = request.Intent, From = request.From, States = ParseStates(request.States) }; await messageQueue.EnqueueAsync(callerMessage); response = new VoiceResponse(); response.Redirect(new Uri($"{_settings.CallbackHost}/twilio/voice/{request.ConversationId}/reply/{seqNum}?{GenerateStatesParameter(request.States)}"), HttpMethod.Post); } await HookEmitter.Emit(_services, async hook => { await hook.OnSessionCreated(request); }, new HookEmitOption { OnlyOnce = true }); return TwiML(response); } /// /// Wait for caller's response /// /// /// // [ValidateRequest] [HttpPost("twilio/voice/{conversationId}/receive/{seqNum}")] public async Task ReceiveCallerMessage(ConversationalVoiceRequest request) { var twilio = _services.GetRequiredService(); var messageQueue = _services.GetRequiredService(); var sessionManager = _services.GetRequiredService(); var messages = await sessionManager.RetrieveStagedCallerMessagesAsync(request.ConversationId, request.SeqNum); string text = (request.SpeechResult + "\r\n" + request.Digits).Trim(); if (!string.IsNullOrWhiteSpace(text)) { messages.Add(text); await sessionManager.StageCallerMessageAsync(request.ConversationId, request.SeqNum, text); } VoiceResponse response = null; if (messages.Any()) { var messageContent = string.Join("\r\n", messages); var callerMessage = new CallerMessage() { ConversationId = request.ConversationId, SeqNumber = request.SeqNum, Content = messageContent, Digits = request.Digits, From = string.Equals(request.Direction, "inbound") ? request.From : request.To, States = ParseStates(request.States) }; callerMessage.RequestHeaders = new KeyValuePair[Request.Headers.Count]; Request.Headers.CopyTo(callerMessage.RequestHeaders, 0); await messageQueue.EnqueueAsync(callerMessage); response = new VoiceResponse(); response.Redirect(new Uri($"{_settings.CallbackHost}/twilio/voice/{request.ConversationId}/reply/{request.SeqNum}?{GenerateStatesParameter(request.States)}"), HttpMethod.Post); await HookEmitter.Emit(_services, async hook => { await hook.OnReceivedUserMessage(request); }, new HookEmitOption { OnlyOnce = true }); } else { if (request.Attempts > _settings.MaxGatherAttempts) { await HookEmitter.Emit(_services, async hook => { await hook.OnAgentHangUp(request); }, new HookEmitOption { OnlyOnce = true }); response = twilio.HangUp(null); } // keep waiting for user response else { var instruction = new ConversationalVoiceResponse { SpeechPaths = new List(), CallbackPath = $"twilio/voice/{request.ConversationId}/receive/{request.SeqNum}?{GenerateStatesParameter(request.States)}&attempts={++request.Attempts}", ActionOnEmptyResult = true }; if (request.Attempts == 3) { instruction.SpeechPaths.Add($"twilio/say-it-again-{Random.Shared.Next(1, 5)}.mp3"); } await HookEmitter.Emit(_services, async hook => { await hook.OnWaitingUserResponse(request, instruction); }, new HookEmitOption { OnlyOnce = true }); response = twilio.ReturnInstructions(instruction); } } return TwiML(response); } /// /// Polling for assistant reply after user responsed /// /// /// // [ValidateRequest] [HttpPost("twilio/voice/{conversationId}/reply/{seqNum}")] public async Task ReplyCallerMessage(ConversationalVoiceRequest request) { var nextSeqNum = request.SeqNum + 1; var sessionManager = _services.GetRequiredService(); var twilio = _services.GetRequiredService(); var fileStorage = _services.GetRequiredService(); if (request.SpeechResult != null) { await sessionManager.StageCallerMessageAsync(request.ConversationId, nextSeqNum, request.SpeechResult); } var reply = await sessionManager.GetAssistantReplyAsync(request.ConversationId, request.SeqNum); VoiceResponse response; if (reply == null) { var indication = await sessionManager.GetReplyIndicationAsync(request.ConversationId, request.SeqNum); if (indication != null) { _logger.LogWarning($"Indication: {indication}"); var speechPaths = new List(); int segIndex = 0; foreach (var text in indication.Split('|')) { var seg = text.Trim(); if (seg.StartsWith('#')) { speechPaths.Add($"twilio/{seg.Substring(1)}.mp3"); } else { var completion = CompletionProvider.GetAudioCompletion(_services, "openai", "tts-1"); var data = await completion.GenerateAudioFromTextAsync(seg); // add hold-on var holdOnIndex = Random.Shared.Next(1, 10); if (holdOnIndex < 7) { speechPaths.Add($"twilio/hold-on-short-{holdOnIndex}.mp3"); } var fileName = $"indication_{request.SeqNum}_{segIndex}.mp3"; fileStorage.SaveSpeechFile(request.ConversationId, fileName, data); speechPaths.Add($"twilio/voice/speeches/{request.ConversationId}/{fileName}"); // add typing var typingIndex = Random.Shared.Next(1, 7); if (typingIndex < 4) { speechPaths.Add($"twilio/typing-{typingIndex}.mp3"); } segIndex++; } } var instruction = new ConversationalVoiceResponse { SpeechPaths = speechPaths, CallbackPath = $"twilio/voice/{request.ConversationId}/reply/{request.SeqNum}?{GenerateStatesParameter(request.States)}", ActionOnEmptyResult = true }; await HookEmitter.Emit(_services, async hook => { await hook.OnIndicationGenerated(request, instruction); }, new HookEmitOption { OnlyOnce = true }); response = twilio.ReturnInstructions(instruction); await sessionManager.RemoveReplyIndicationAsync(request.ConversationId, request.SeqNum); } else { var instructions = new List { }; // add hold-on var holdOnIndex = Random.Shared.Next(1, 15); if (holdOnIndex < 9) { instructions.Add($"twilio/hold-on-long-{holdOnIndex}.mp3"); } // add typing var typingIndex = Random.Shared.Next(1, 7); if (typingIndex < 4) { instructions.Add($"twilio/typing-{typingIndex}.mp3"); } var instruction = new ConversationalVoiceResponse { SpeechPaths = instructions, CallbackPath = $"twilio/voice/{request.ConversationId}/reply/{request.SeqNum}?{GenerateStatesParameter(request.States)}", ActionOnEmptyResult = true }; await HookEmitter.Emit(_services, async hook => { await hook.OnWaitingAgentResponse(request, instruction); }, new HookEmitOption { OnlyOnce = true }); response = twilio.ReturnInstructions(instruction); } } else { if (reply.HumanIntervationNeeded) { await HookEmitter.Emit(_services, async hook => { await hook.OnAgentTransferring(request, _settings); }, new HookEmitOption { OnlyOnce = true }); response = twilio.DialCsrAgent($"twilio/voice/speeches/{request.ConversationId}/{reply.SpeechFileName}"); } else if (reply.ConversationEnd) { response = twilio.HangUp($"twilio/voice/speeches/{request.ConversationId}/{reply.SpeechFileName}"); await HookEmitter.Emit(_services, async hook => { await hook.OnAgentHangUp(request); }, new HookEmitOption { OnlyOnce = true }); } else { var instruction = new ConversationalVoiceResponse { SpeechPaths = [$"twilio/voice/speeches/{request.ConversationId}/{reply.SpeechFileName}"], CallbackPath = $"twilio/voice/{request.ConversationId}/receive/{nextSeqNum}?{GenerateStatesParameter(request.States)}", ActionOnEmptyResult = true, Hints = reply.Hints }; await HookEmitter.Emit(_services, async hook => { await hook.OnAgentResponsing(request, instruction); }, new HookEmitOption { OnlyOnce = true }); response = twilio.ReturnInstructions(instruction); } } return TwiML(response); } // [ValidateRequest] [HttpPost("twilio/voice/init-call")] public TwiMLResult InitiateOutboundCall(VoiceRequest request, [Required][FromQuery] string conversationId) { var instruction = new ConversationalVoiceResponse { ActionOnEmptyResult = true, CallbackPath = $"twilio/voice/{conversationId}/receive/1", SpeechPaths = new List { $"twilio/voice/speeches/{conversationId}/intial.mp3" } }; string tag = $"twilio:{Request.Form["AnsweredBy"]}"; var db = _services.GetRequiredService(); db.AppendConversationTags(conversationId, new List { tag }); var twilio = _services.GetRequiredService(); var response = twilio.ReturnNoninterruptedInstructions(instruction); return TwiML(response); } // [ValidateRequest] [HttpGet("twilio/voice/speeches/{conversationId}/{fileName}")] public async Task GetSpeechFile([FromRoute] string conversationId, [FromRoute] string fileName) { var fileStorage = _services.GetRequiredService(); var data = fileStorage.GetSpeechFile(conversationId, fileName); var result = new FileContentResult(data.ToArray(), "audio/mpeg") { FileDownloadName = fileName }; return result; } private Dictionary ParseStates(List states) { var result = new Dictionary(); if (states is null || !states.Any()) { return result; } foreach (var kvp in states) { var parts = kvp.Split(':', StringSplitOptions.TrimEntries | StringSplitOptions.RemoveEmptyEntries); if (parts.Length == 2) { result.Add(parts[0], parts[1]); } } return result; } private string GenerateStatesParameter(List states) { if (states is null || states.Count == 0) { return null; } return string.Join("&", states.Select(x => $"states={x}")); } }