This article is for Twilio developers, partners, and solutions engineers. It provides a step-by-step guide to best showcase the combined flexibility and power of Spoke Phone and Twilio.
Subjects covered in this article:
- Setting up the environment
- Deploying Spoke Phone
- Deploying Spoke Phone's plugins for Twilio Flex
- Deploying Spoke Phone's open-source functions for Twilio Studio
- Deploying Spoke Phone's example Twilio Studio flows
- Configuring Spoke Phone with good demonstration data
- Creating basic Twilio Studio examples to enhance/replace Spoke's default IVR
- A series of best-practice demonstration scripts, so you can effectively illustrate the combined power of Spoke Phone and Twilio
- A free Spoke Phone account
- A Twilio Flex Project
- Administrator Access to a Twilio Flex Project
An appropriately skilled developer who has a reasonably technical level of knowledge and competence in working with Twilio Accounts, Twilio SIDs, Flex projects and configurations, and general use of the Twilio Console
Setting up the environment
The flowchart below highlights the steps you will take. Detailed instructions and links to resources for each step are provided below.
Deploying Spoke Phone into your Twilio account
Step #1: Create a Twilio Flex Project
- If you do not have one already, create a new Twilio Flex project
- Ensure the account has credit on it, so you can buy more than one phone number from Twilio
Important: Do not use/create a Twilio Account using BETA Twilio Regions.
Spoke Phone will support Twilio Regions once it is in GA, not before.
Steps #2 and #3: Create a new Spoke Phone Account & deploy it into your Twilio Flex Project
- Follow these instructions, deploying into your Twilio Flex project.
Step #4: Deploy Spoke Phone's Directory Plugin for Twilio Flex
This plugin adds another tab to the WorkerDirectory in Twilio Flex. The tab is an employee directory containing all the Spoke Phone back-office users, call groups and their availability. Flex Agents use this tab to transfer calls out of Twilio Flex over to back-office users on Spoke Phone.
Step #5: Deploy Spoke Phone's Open-Source functions to Twilio Serverless
These functions make it easy to build scalable and rich IVR flows in Twilio Studio, fully integrated into Spoke Phone, giving you full control over the customer experience.
Step #6: Deploy Spoke Phone's example Twilio Studio flows
Deploy these example Twilio Studio Flows into the same Twilio Flex project, so you have everything in one place. These example flows are quick-starts to help you quickly build customer demonstrations that include sending calls from Studio our to Spoke users and call groups, and back.
- Go to the Spoke Phone Github page
- Go to the twilio-runtime-spoke-api repository
- Go to the sub-folder /studio_flow_examples
- Follow the instructions in the FLOWS.MD
Configuring Spoke Phone with demonstration data
These steps help you set up the minimum users, call groups, phone numbers, and other data in Spoke Phone, that:
- Help you understand how Spoke Phone works
- Give you an ideally setup demonstration and development environment
- Allow you to quickly personalize the demonstration environment before each demo
- Showcase the integrated power of Spoke Phone and Twilio
👍 By doing these steps now and practicing a little,
you'll be able to perform rich and personal customer demonstrations
with very little advanced warning or pre-demo setup.
Step #1: Add at least two more users to Spoke
You ideally need three users to run great Spoke Phone demonstrations.
- Login to the Spoke Account Portal
- You will already be added as a User in Spoke
- Add at least two more users to Spoke
- FYI: Google Email Users can use the "name+...@" method (sometimes known as a task-specific email address), to add demo users under a single email account.
- Download the Spoke app to your desktop and mobile
- Log in as one of the users on your mobile, and a different user on your desktop
Step #2: Create at least two more Call Groups
Spoke Call Groups automatically route calls to Spoke Users you put into the groups. This is sometimes known as ACD, Automatic Call Distribution, or Hunt Groups, as they hunt for an available Spoke User to take a call. Call Groups make for a great demo, especially when integrated into Twilio Studio.
- By default, Spoke comes with a single pre-configured Call Group "Reception Desk"
- You, as the Spoke account admin, will already be added into this Call Group.
- Add these three new Call Groups:
- Sales, Parts, and Customer Support
- Set the Spoke Extension Key as #1, #2, and #3 to each group respectively. This will set up the default IVR on Spoke.
- As you create each Call Group, ensure you add one or two of your Users into each group, so you can answer calls to Call Groups during your demos
- Learn more about Spoke Call Groups here
Step #3: Add two new numbers to your Twilio Account
These phone numbers will be used as DIDs (Direct In Dial numbers) so you can demonstrate directly calling a Spoke User or a Call Group (thereby bypassing the IVR or receptionist.)
- Buy two new numbers from your Twilio Console.
- If you've already got two spare numbers in your Twilio Account, go to the next step.
Step #4: Assign two numbers as DIDs
- Go to the Manage Phone Numbers management page in the Spoke Account Portal
- Look for your new numbers. They will show with the Twilio logo under the Active On column
- Pick one of the numbers, Edit it, and Assign it to yourself. This will now be your DID. You can have customers call this DID during Demos to directly ring your Spoke app.
- Edit the other number and Assign it to the call group, Sales. You can use this number to demonstrate customers bypassing the IVR/receptionist, and calling a Sales team directly.
Step #5: Add a hard phone device
A lot of your customers will ask about hard-phones. Spoke supports a number of (~90) physical desk-phone options for conference rooms, common area phones, and executives. For the purposes of demonstrating, it's often good enough to simply show a hard-phone in the Spoke directory and talk to it. We've found you don't actually need to set up a hard-phone in demos.
- Go to Phones & Devices in the Spoke Account Portal
- Add a new device with the name Kitchen Area
- Select the Type as Physical Phone
Final Step: Add some example customer data 🎉
By adding example customer data, your demonstrations will be much richer and easier for people to follow along. Using a simple CSV upload, Spoke will show customer names as they call (Replicating a CRM data dip), and, customer records will show in Spoke's external directory. You can even go so far as to integrate your actual CRM using Spoke's one-click CRM integrations. This will also showcase searching external CRM data and automatically logging calls to the CRM records. As a minimum, we suggest adding one example customer record via CSV upload. To go further, check out these CRM integration articles.
- Create a CSV with the columns: FirstName, LastName, Phone, Email
- Make up a fictitious customer that you will use in your demonstrations and enter their details into the CSV file
- For this customer's phone number, use a phone number that you can easily place and answer calls from when pretending to be the customer in your demo
- Upload the CSV File in the Spoke Phone Account portal, using the CSV Upload integration
Learn and Play
It's a good idea to play around, use Spoke, run through the demo scenarios (below), and generally get a good feel for how Spoke works, and how you can customize Spoke using Twilio Studio, Task Router, etc.
Download the Spoke Phone User Manual
The Spoke app is designed as a mobile-first application with a goal of "zero-user-training". However, there are a lot of features to the Spoke Phone app you may not realize.
Working with Twilio Studio to enhance/replace Spoke Phone's default IVR
By default, Spoke Phone comes with an automated single-level IVR that supports up to 10 IVR keys (key press 0-9), and unlimited dial by extensions. IVR key press options 0-9 can be configured to route to Spoke users, call groups, or devices. This basic IVR uses text-to-speech to read out a welcome greeting and the IVR options. Customers can replace this text-to-speech automation with pre-recorded audio. Read more about Spoke's pre-built IVR and audio library.
However, 95% of your Twilio customers will want a much richer custom IVR solution, which you can build on Twilio Studio. Spoke Phone is fully integrated to Twilio Studio and provides a set of example Studio flows and several open-source functions to assist you connecting Twilio Studio to Spoke.
- Read this article when to use Spoke's default IVR or Twilio Studio
- Follow this Quick-Start Developer Guide: Integrating Twilio Studio to Spoke’s Programmable Softphone
- Watch the Twilio Developer How-To Video series
- Access the example Spoke/Twilio Studio flows
How to demo like a pro with these demonstration use-cases
Core demonstration scenarios
🦫 🛠️ - WORK-IN-PROGRESS! Please bear with us as we bake these out for you.
Also, feel free to suggest new demo scenarios.
- Use Spoke's simple IVR to route calls to available Spoke users in a Call Group. E.g. Sales
- Use Twilio Studio to replace Spoke's simple IVR, and send calls to Spoke Users or Call Groups
- Use Spoke's dial-by-extension to bypass any IVR and reach a Spoke user directly
- Use Spoke's dial-by-extension to bypass any IVR and reach a Spoke Call Group directly. E.g. Sales
- Use Spoke DIDs to call a user or Call Group directly from the PSTN, without calling the company line or using extensions
- Transfer a call from Twilio Flex to an individual back-office Spoke user
- Transfer a call from Twilio Flex to any available back-office Spoke user in a Call Group. E.g. Sales
- Transfer a call from the back-office (Spoke User) into a Flex Queue
Best-Practice Pre Demonstration Activities
Before any demonstration, it's a good idea to do these set up and testing tasks to ensure you have a good demo.
Open Web pages to make demonstrating easy:
It's a good idea to run through your actual demo to ensure phone numbers, Twilio Studio Flows, etc., are still active and working as you expect.
Using multi-desktops on a Mac and switch between the Spoke app and Console/Flex/ etc.
Demonstration scenario #1
Scenario: Use Spoke's simple IVR to route calls to available Spoke users in a Call Group. E.g. Sales
Showcases: Automatic call distribution to one or more available users in a call group.
Running the demonstration:
If you need to dive deeper to Call Groups:
Your excellent demo wins the sale!