Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

Integrate Voice in Frontline


(warning)

Warning

Voice Calling in Frontline will follow the same routing logic used for Messaging. Make sure to first configure Inbound Routing and your Outgoing Conversation Callback URL.

The Voice in Frontline integration will allow you to make and receive voice calls to and from your customers, all from the Frontline mobile application. In order to integrate the voice feature, you will need a Twilio phone number with voice capabilities. You will also need to make some configuration changes in the Twilio Console to get up and running with making voice calls. Let's get started!


Verify you have a Voice-enabled Twilio Number

verify-you-have-a-voice-enabled-twilio-number page anchor

To check if your Frontline number is voice enabled, navigate to Phone Numbers > Manage >Active Numbers(link takes you to an external page) in the Twilio Console.

Each active phone number includes details on its capabilities. Verify that your Frontline number has the Voice icon, which means it is voice-enabled. If it does, you can skip down to the Enable Voice in Frontline section below to continue Voice feature integration!

Dashboard showing active phone numbers with voice capability filter applied.

Otherwise, you'll need to purchase a voice-capable phone number.

Buy a Voice-enabled Twilio Number

buy-a-voice-enabled-twilio-number page anchor

To purchase a number with Voice functionality, navigate to the Buy a Number(link takes you to an external page) page in the console, check the Voice box and click Search.

Interface for buying a number with options for country, capabilities, and search criteria.

You'll see a list of available phone numbers and their capabilities. Find a number that you like and click Buy to add it to your account.

Table of local phone numbers with capabilities and buy options.

Now that you have a voice-enabled phone number, we're ready to enable Voice functionality in Frontline!


Enable Voice in Frontline

enable-voice-in-frontline page anchor

There are two configuration steps you'll need to follow to enable Voice calling:

  1. Select the Enabled radio button on the Frontline Voice calling Console page.
  2. Connect the TwiML App to your Twilio phone number.

Navigate to the Frontline Console(link takes you to an external page). Go to Manage > Voice Calling section and click the Enabled radio button.

Voice calling settings with 'Enabled' option selected for managing inbound and outbound calls.

Click the Save button.

Once the Enabled option is selected, the following will occur:

  • A TwiML App named Voice in Frontline will be generated. You will later configure your voice capable phone number to use this TwiML App to handle calls. This TwiML App will act similarly to a webhook, and handle incoming and outgoing voice calls for your Frontline service.
  • You will see the Voice calling enabled notification in the upper right-hand corner of your console window, signifying that Voice calling is now enabled for your Frontline application.

Next, we will assign the voice capable phone number we purchased earlier to the newly generated TwiML App.

Connect a Phone Number to a Frontline TwiML App

connect-a-phone-number-to-a-frontline-twiml-app page anchor

You will need to tell Twilio to look to this newly-created TwiML App for instructions for any incoming or outgoing calls to your Twilio phone number.

  1. In the Console, navigate to Phone Numbers > Manage > Active Numbers
  2. Click on the phone number you purchased to use with Frontline. Scroll down to the Voice & Fax section
  3. In the Configure With dropdown, select TwiML App
  4. In the TwiML App dropdown, select the Voice in Frontline TwiML App
  5. Click the Save button
Twilio interface showing configuration of phone number with TwiML App for Voice in Frontline.
(information)

Info

If your Frontline TwiML App is associated with many Twilio phone numbers, this manual process likely won't be the best solution. For example, you could automate this process by writing a script using Twilio's Phone Numbers REST API.

Frontline workers will now be able to receive incoming voice calls and make outgoing voice calls.


Disable Voice in Frontline

disable-voice-in-frontline page anchor

To disable Voice calling functionality from your Frontline application, click the Disabled button on the Voice Calling(link takes you to an external page) console page and click the Save button.

Voice calling disabled with instructions to remove incoming call handling.

Once Voice calling is disabled:

  • You will need to remove any Frontline phone number configuration to block incoming voice calls to the Frontline application.
  • You will see the Voice calling disabled notification in the upper right-hand corner of your console window, signifying that Voice calling is now disabled for your Frontline application.
  • Workers in the Frontline app will no longer be able to place or receive new phone calls but will see records of any previously placed phone calls in their conversation history.

Remove Frontline Voice Configuration

remove-frontline-voice-configuration page anchor

In the Console, navigate to Phone Numbers > Manage > Active Numbers(link takes you to an external page). Once there, select the voice capable number you purchased earlier.

Scroll down to the Voice & Fax section. In the Configure With dropdown, select "Webhook, TwiML Bin, Function, Studio Flow, Proxy Service", as shown below.

Dropdown showing configuration options for TwiML App with save button highlighted.

Click the Save button. Now, the Voice configuration for a phone number is disabled.

You will see a notification message at the top of your console window, signifying that the number was successfully updated.

(information)

Info

If your Frontline TwiML App is associated with many Twilio phone numbers, this manual process likely won't be the best solution. For example, you could automate this process by writing a script using Twilio's Phone Numbers REST API.


To make an outgoing call from an ongoing conversation with a customer, click the blue phone icon in the upper right-hand corner of the conversation screen.

Chat interface with call icon highlighted for outgoing calls in Twilio Frontline.

You can also place a call from a particular customer's detail page. Navigate to a Customer Details page and under Contact details select the phone number that you want to call.

When you receive an incoming call, you'll see a Frontline notification banner at the top of your mobile device. Click the blue check icon (iOS) or the green answer button (Android) to accept the call.

Mobile screen showing Twilio Frontline incoming call from Ashley Johnson with recent messages list.

You may see two types of error messages in the Voice calling Frontline Twilio Console:

  • Frontline Missing Phone Numbers: You will see this error message if the Messaging service that is connected to the Frontline Conversation service doesn't have any assigned phone numbers in its Sender Pool.

    • To edit the Sender Pool in the Console:

      1. Click Messaging > Services in the left navigation.
      2. Click on Default Conversations Service.
      3. Then click Sender Pool in the left navigation pane.
  • Voice Calling Not Available: If the TwiML app required to enable Voice calling on the Frontline application was updated or removed, you will need to contact our support team(link takes you to an external page)to restore Voice calling functionality.


Advanced Voice Configuration

advanced-voice-configuration page anchor

Would you like to customize Frontline's Voice behavior? Go to the Advanced Voice Configuration page to learn how you can modify inbound and outbound call behavior in Frontline.