Skip to contentSkip to navigationSkip to topbar
Rate this page:
On this page

Dialpad (Legacy) - End User Guide



A fully supported, native Flex Dialpad is now available to replace this version.

Important: Flex Dialpad does not support agent-to-agent direct calls or external transfers yet. If you need these functions, we recommend you continue to use this experimental Legacy Dialpad.

Refer to this guide for more information


Pilot Feature

The Dialpad is offered as a Pilot Feature and has some important limitations.

With pilot releases, our focus is to verify functionality and gather feedback from a limited set of customers. Pilot Features are not covered by a Twilio SLA or support plan. Due to known limitations, we don't recommend using these features in production.

With the dialpad, agents are able to:

  • Make outbound calls to customers
  • Add internal employees or an external number to a call
  • Send DTMF tones to connected calls

Enabling Dialpad

enabling-dialpad page anchor

You can enable the dialpad on the pre-release features page(link takes you to an external page) within Flex Admin. Dialpad calls require three parameters to be set:

  • A phone number, which will be used as the from Caller ID
  • A display name, which will appear to the agent as the primary name on the task
  • A TaskRouter Workflow Sid, which identifies the workflow that will handle the task


From Number

The 'From Number' must be a number that Twilio recognizes as owned by your account. It must also be provided in the E.164 format. You can view your Active Numbers(link takes you to an external page) within the Twilio Console.

Workflow Sid

Any TaskRouter Workflow will work, but it must reference flexOutboundDialerTargetWorker. If you haven't already customized your workflow to reference the Target Worker in a filter expression, then we will add this as the first filter at the beginning of your Workflow.


The dialpad is accessed from the 'Dialpad' menu item, identified by a phone icon. You can type a phone number or use the buttons to provide a number to dial.

Dialpad Menu.

A menu on the dialpad also allows you to quickly place an outbound call to another user within the contact center. When the call is active, the agent will receive and auto-accept a task. Their normal call controls will display, and the task will be identified with the Display Name provided within the dialpad configuration.

Task Display Name.

Adding other Agents or External Numbers to a Call

adding-other-agents-or-external-numbers-to-a-call page anchor

You can add additional participants to a live call placed with the dialpad. To add a participant:

  • Place a call with the dialpad
  • Click on the +people icon to open a dialpad within the call controls
  • Dial a new number or select an agent to add to the live call
Dialpad Add Participant.

Troubleshooting Dialpad Calls

troubleshooting-dialpad-calls page anchor

1. Check your From Number

Your From Number must be a number registered with your Twilio Account and provided in E.164 format. If you attempt to place a dialpad call with an invalid From Number, you will receive a Twilio Debugger(link takes you to an external page) warning: failed to add participant to conference

2. Check your TaskRouter configuration

When the dialpad is enabled, we update your TaskRouter workflow with a Dialpad filter to handle task assignment to the agent who placed the call. Represented in JSON, the filter would look like:

"expression":"flexOutboundDialerTargetWorker != null",
"expression":"task.flexOutboundDialerTargetWorker == worker.contact_uri",

json filter.

There are a few reasons a workflow may not get a dialpad call to your agent:

  • Your agent may be Unavailable , or they may already be assigned a task on the custom1 channel
  • Your Dialpad workflow filter may be ordered after another workflow expression. If the dialpad task matches another filter expression first, then it may get assigned to a different agent.
  • The queue associated with your Dialpad workflow filter may not contain the intended agent. We attempt to associate the workflow filter with the Everyone queue that is provisioned on account setup. But if this queue has been repurposed or deleted, then you may need to adjust the workflow filter.

3. Check your task channels

The Dialpad creates tasks on the custom1 task channel. If this channel does not exist, you can create it using the REST API or using the Twilio Console. Make sure that your agents have at least a capacity of 1 on this channel.

Rate this page: