How to Schedule Appointments on your WordPress Website through Amazon Alexa

Many of the WordPress-based websites have some kind of appointment scheduling functionality. To be more precise, there are a dozen most popular plugins which are powering at least 150K websites. Hairdresser salons, dentists, online events, there are many use cases which require booking functionality. Wouldn’t it be great to be able to offer your customers the same functionality via smart speakers (e.g. Amazon Alexa)? Voice assistants are in constant rise and are proving themselves as the user interface that you will not be able to avoid in the future. Right now, developing voice apps seems reserved for the enterprise market only, primarily because of high development costs, but in the WordPress world it can be easily changed. That is exactly what we have done and you can have your appointment booking Alexa skill in no time, for free. Appointment booking plugins compatibility As each appointment scheduling plugin has its own functions, database structure, … you must be wondering how we plan to overcome that issue. As we can not completely solve it, we designed our solution in such a manner that it consists of two parts. is our package, generic appointment booking solution, not tied to any plugin, not even to WordPress. The first convo-appointments This part is focused on solving requirements, while the real data (load, create …) is delegated to the appointments context component (data source). This package comes with one dummy appointments context implementation that can serve you as an example how to implement it for your own plugin, or just testing the skill workflow. conversation design This package also contains a ready to use Alexa skill template. You can find more about this package on the . GitHub repository part is concrete , which internally calls required plugin functions and does required data transformations. At the moment, we are providing implementation for the WordPress plugin and you can find it in components package. In the ideal case, your appointments plugin will already include its own custom package with an appointments context implementation. The second appointments context implementation Simply Schedule Appointments convo-wp-plugin-pack In this article, we will explain basic functionality of the skill itself, how to install it on your own installation and if you have plugin, how to switch the skill to use it. Simply Schedule Appointments If this is your first contact with Convoworks, you might want to first check some basics in our or the video tutorial series. documentation Convoworks basics “Schedule Appointments” – Alexa skill template overview The appointments package is shipped with the ready-to-use Alexa skill template, which functionality will be described in this section. This template is created to be used as Amazon Alexa only and the skill itself requires access to user's full name and email address, which can be enabled in the Alexa app during the skill activation. When we are talking about booking appointments scenarios, we should notice two main conversation flows depending on if the user already has or doesn’t have an appointment. No appointments flow & first-time users During the introduction phase, the user is greeted, told introductory information like business hours, and asked if they want to schedule an appointment. If the first-time user answers in the negative, the service offers the user some info about the skill owner’s business, and if that answer is negative as well, it reminds users that they can ask for information about the company anytime and exits. If the user answers in the affirmative, the service asks about the appointment date, then if not provided along with the date, the appointment time. Finally, the service checks availability. If the date and time are available, the service asks for booking confirmation. If the requested date and time are not available, the user is asked to choose another time slot. In addition, our app is even capable of offering free slot suggestions. Anytime during the service run, users can ask for help and get help in accordance with the service step they’re on. Users are also able to ask Alexa to repeat the last response, by simply saying . “Repeat” To skip most of the steps, a user can rely on a one-shot request when opening the skill, for example: . This will send the user, if the date and time are available, right to the confirm step. “Ask Schedule appointment to schedule an appointment on Monday at 9 am” Existing appointments flow – returning user The returning user no appointments flow is similar to the first-time user one. The exception is some changes in the text, omission of tips and introduction, as well as skipping offering to hear more about the company. The introduction message in existing appointments flow slightly differs depending on if the user has one or more than one appointment. If the user has an upcoming appointment, after the welcome back message, the service informs the user about the one upcoming appointment with the date and time of that appointment. The service then offers the option to cancel or reschedule the appointment. If the user has asked to cancel the appointment, the service asks for confirmation and if the answer is yes, deletes the appointment and exits. If the answer is no the service exits after a brief message. Alexa skill setup Here are the instructions on how to enable appointment scheduling as an Alexa skill on your WordPress installation. You have to have installed Convoworks WP properly connected with your Amazon developer account (check or ). You will start with creating a new service (from template), you will do some basic configuration and push it to the Amazon Alexa skill store. Amazon Alexa Configuration Docs Video tutorials at YouTube Create new service from template We will start with creating a new service from the template – which is part of the package. Schedule Appointments convo-appointments First, open the open Convoworks WP services view and click on the button. Enter your service name, then select the template and press the button. The service name will be used as the default for your Amazon Alexa skill invocation phrase, so it might be useful to find a nice name for it. Check about choosing the right invocation for your skill . Create new Schedule Appointments Submit here Change the app name and other variables This template is ready to use, but you will probably want to do some modifications to make it a better fit for your needs. Besides the appointment scheduling functionality, this template has sections with the company info and about business hours that your customers might be interested in hearing. One thing you will certainly want to change is the variable ( in service editor). This variable is used in several places in the skill (e.g. ) and you should change it to fit your chosen name. Another one that you might want to change is which can limit the number of active appointments one user can have. APP_NAME Variables view “Welcome to ${APP_NAME}” MAX_APPOINTMENTS_PER_PERSON There are also two variables related to formatting date and time values when speaking to the end-user. There is no actual need to change this, but you might want to play around to fit your needs in a better way. More about date format options can be found at . PHP docs Change or remove business hours info In some cases, like with first-time users, the skill will inform users about business hours that are available to him. The related texts are defined in and service fragments. Working days and hours – intro Working days and hours – not_allowed Business hours definition is right now hardcoded in the service definition, so if you need to change it navigate to these two fragments and change the values to the ones which will describe your case. Change or remove About Your users might be interested in hearing more info about your business. The related text is defined on the conversation step. Navigate to that step and change the info about your business. Read about us To remove the flow, you’ll need to delete the element containing the fragment in the block. delete the block and delete the processor in the . About Run once Home About About Service processors Time zones When we are talking about appointment scheduling and time zones, there are two main scenarios. The first is when the appointments are in-person meetings, like hairdresser salon or dentist visits. So if you are in LA and you are scheduling your visit to the dentist in NY, you will operate in the target time zone (NY). This is the default behavior for our appointment scheduling template. The second mode is more appropriate for online meetings. In such a case, the user is trying to book time in his own time zone and the system will do required transformations and check the availability correctly. Our components and the whole system design are supporting both variants and it is achieved with the and properties on the appointments package related elements. The template is configured to use the mode which will use the appointments plugin default timezone (the first case). Timezone mode Timezone Default If you want to change the time zone mode your service is working with, right now you will have to go through the template and update manually time zone component parameters. In the next release, we will move those two configuration options to the variables, so you will be able to change it from a single place. Amazon Alexa Configuration In order to work, we have to publish it to the Amazon Alexa skill store. Navigate to the service view, and select . configuration Amazon Alexa This skill requires some user information, so do not forget to select and in the panel (see below). If you want to be able to enable a beta test for the skill, you’ll have to enter the in the section. Full Name Customer Email Address Amazon Alexa Skill Permissions Privacy Policy URL Edit Skill Store Preview After filling in the information and clicking “Save” your service will be propagated to Amazon and you can head on over to the skill’s to test. Alexa Skills Kit developer console Simply Schedule Appointments integration If you have plugin activated on your website, you can switch the service to use it and have full-blown appointment scheduling Alexa skill. In this case, while in service editor switch toolbox to packages view and enable package. Simply Schedule Appointments convo-wp-plugin-pack After you enable it, you will be able to add the under the tab. Once you add it, enter desired and select the you want to handle. Simply Schedule Appointments source Contexts context id Appointment Type Copy the and head on over to the panel. Use it to set the variable. Do not forget to save changes. Context ID Variables APPOINTMENTS That’s it. You’ve created a functional appointment scheduling Amazon Alexa skill using the . It is good to know that the appointments created are the same as those created through the web interface. If you installed some additional plugins, to send email notifications or do any other additional functionality, everything will work the same. Simply Schedule Appointments Conclusion There are many plugins that are extending WordPress functionality in many different ways. At the same time, it is a blessing and a curse. With our appointments package, we demonstrated how such issues can be avoided in a cheap and efficient way. If you use some other appointment scheduling plugin, or even better if you are a developer of such one, please contact us and we will be glad to help you with integration.