Introduction<\/h2>\n
A few years ago, I wrote a blog about an emerging technology called Amazon Echo<\/a>. That blog post chronicled my journey down the path of creating an Alexa Skill (the technical term for programming with Alexa) called Surf Check.<\/p>\n While that first post focuses on Alexa, the same principles apply to Google Home and some of the other chatbot technologies available on the market today.<\/strong><\/p>\n And though I\u2019d like to claim the skill is hugely popular with thousands of hits per day, in reality, Surf Check is just my playground for learning new concepts with Voice User Interfaces. Over the last few years, I tweaked and refactored the original skill as I discovered new Alexa and AWS features. I documented some of those updates, such as creating a Facebook Messenger interface, in a follow-up blog.<\/a><\/p>\n In this next iteration of the blog series, I take a more holistic view of the various modules to show how, with a little bit of refactoring and a microservice architecture, I transformed my original Surf Check Alexa Skill into a \u201cserverless, microservice, multi-modal chatbot monster\u201d!<\/strong> Hyperbole aside, the result is certainly serverless, leverages microservices, and provides several interfaces for interaction: Alexa, Facebook Messenger<\/a>, Text Messaging, and a good old fashioned Telephone Call.<\/p>\n As you will see, my journey involved a lot of exploration, experimentation, and trial-and-error. While I can\u2019t guarantee that you\u2019ll end up in the same place I did, I\u2019d like to walk you through my process in the hopes it may help you develop your own, if you aren\u2019t able to replicate mine exactly.<\/p>\n As I mentioned in the introduction, I\u2019ve implemented several iterations of my Surf Check Alexa Skill. Starting with a fundamental Alexa Skill<\/a> developed in C#, each successive iteration benefited from refactoring in some cases, and wholesale replacement with better components in others. The images in Figure 1 show the basic flow of the Alexa interaction.<\/p>\n The table in Figure 2 provides a glimpse into the components that served as a starting point for the current iteration.<\/p>\n Figure 2<\/p><\/div>\n With these existing components in mind, I set out to add two new ways of asking \u201cHow\u2019s the surf?\u201d My goal was to preserve much of the work already done. I wanted to add text messaging as the first new method. Several services now offer this capability, including my bank, which allows me to text simple commands to a phone number.<\/p>\n For example, I can check the balance of my account by texting the word \u201cbalance\u201d to a specific phone number. Likewise, I can withdraw money from my account by texting \u201cwithdraw.\u201d Amazon provides this capability through a relatively newer service called Pinpoint. Amazon Pinpoint positions itself as a marketing and analytics service that enables an organization to engage with users by sending email, SMS, and push notifications.<\/strong><\/p>\n The second new method is a bit more pedestrian, but it arguably covers a broader swath of users: a telephone service that allows callers to dial a phone number and ask the virtual assistant, \u201cHow\u2019s the surf?\u201d Amazon provides this capability through another of its newer services, called Connect.<\/p>\n Amazon Connect uses the same technology as Alexa and Lex<\/a> to deliver a cloud-based customer contact service via telephone. Older Interactive Voice Response (IVR) systems, based on decision trees and universally loathed by customers, force the customer to press numbers on their phone to arrive at pre-configured answers. Connect, on the other hand, users natural, intuitive conversation to assist callers.<\/p>\n In my case, a caller receives a couple of options, including the now-familiar \u201cHow\u2019s the surf?\u201d The caller can speak the instructions instead of pressing a number on his or her phone.<\/strong><\/p>\n The images in Figure 3 show some of the new methods for asking, \u201cHow\u2019s the surf?\u201d<\/p>\n Figure 3<\/p><\/div>\n The table in Figure 4 provides a glimpse into the components used to add the new functionality in the current iteration.<\/p>\n Figure 4<\/p><\/div>\n I also examined at how all four methods for asking “How’s the surf?” did their work, in addition to the two new methods. Developing software by breaking the modules in an application into loosely coupled services is now one of the more popular trends in software architecture. Developers designed these so-called microservices<\/em> to perform very fine-grained functions with little or no dependencies on other services in the system.<\/p>\n An application stitches together these microservices using lightweight messaging protocols to develop and scale the microservices independently. With this microservices thinking in mind, the original Alexa Skill leveraged several Python methods to answer the question. A request calls these methods, which get funneled through AWS Lambda<\/a>.<\/strong><\/p>\n When adding the two new methods (Text Messaging and Telephone Calls), I had a design goal to reuse all of the Python methods I developed previously. Conceptually, the only new code needed should be limited to the specifics of the new interfaces (Text Messaging and Telephone Calls). In that respect, I succeeded, mostly.<\/p>\nHow I Did It<\/h2>\n
1.\u00a0 Review of Existing Components<\/h4>\n
![\"\"](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2020\/01\/Tech_Alexa_Graphics_1162020-01.jpg\")
<\/p>\n![\"Blog](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2020\/01\/Blog_AlexaChart1_06_16_19.png\")
<\/a>2.\u00a0 Introducing Amazon Pinpoint and Connect<\/h4>\n
![\"Tech](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2020\/01\/Tech_Alexa_Graphics_1162020-02-1024x582.png\")
<\/a>![\"Blog](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2020\/01\/Blog_AlexaChart2_06_16_19.png\")
<\/a>3.\u00a0 Microservices Thinking<\/h4>\n
![\"Alexa](\"https:\/\/centricconsulting.com\/wp-content\/uploads\/2020\/01\/Alexa-Chatbot-fig-5.png\")
<\/a>