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

Manage SMS Addresses



This guide is for Flex UI 1.x.x and channels that use Programmable Chat and Proxy. If you are using Flex UI 2.x.x or you are starting out, we recommend that you build with Flex Conversations.

The simplest (and the default) way to route incoming SMS messages for a Phone Number into Flex is to:

  • Map the Phone Number using an Address (aka a Flex Flow)
  • Point the Phone Number to a Flex Proxy Service (happens implicitly if you use Flex Console to create the Address)
  • Set the Flex integration on the Address to use a Studio Flow
  • Make sure the Studio Flow invokes the Send to Flex widget

Follow these steps to set up a new SMS Address with the aforementioned configuration on the Flex Console.

1. Buy a Phone Number

1-buy-a-phone-number page anchor

If you haven't purchased an SMS-enabled Phone Number yet, refer to Purchase a new Twilio Phone Number.

2. Create an SMS Address (Flex Flow) for your Phone Number

2-create-an-sms-address-flex-flow-for-your-phone-number page anchor

Flex uses Addresses (aka Flex Flows) to describe how new conversations should be handled to connect them to Flex.

To create an Address for your new Phone Number:

  1. Navigate to Flex > Messaging(link takes you to an external page). Select the SMS Numbers tab. Alternatively, you can click "+ Create new Address" on the Addresses tab, and search for your Phone Number on the "Create Address" form.

  2. Search for and select your unregistered Phone Number. Previously configured Phone Numbers will have an "Address created" indicator.
  3. You can optionally enter a friendly name.
  4. Configure the integration to Flex - either by using Studio , Webhook , or Task . The most common configuration is to integrate a Phone Number to Flex using a Studio Flow. Unless you have removed or reconfigured it, you should be good to use the default "Messaging Flow" that came with your Flex account. To learn more about configuring Studio Flows, see Configure pre-agent workflow with Studio.
  5. Click Submit to save your new Flex SMS Address.

You can create, edit or delete Flex SMS Addresses at any point using the Flex Console.

Text the phone number that you purchased. Follow the steps in Respond to SMS to review the incoming SMS task on your Flex instance.

Under the hood: Proxy Service

under-the-hood-proxy-service page anchor
Inbound Message Flow.

Under the hood, Flex uses Twilio Proxy to send the messages back-and-forth between the end-customer and the agent. For this to work, the messaging handler for your Phone Number needs to be set to Flex Proxy Service. The Flex Proxy Service uses the Flex Flows configuration to route inbound messages into Flex.


If you use Flex Console to create an SMS Address (Flex Flow), the Phone Number Handler should be set to Proxy automatically when you create the Address. You can review and reconfigure at any time by finding your Phone Number under Phone Numbers > Manage > Active Numbers. For example, you need to configure this step manually if you use the Flex Flow API for creating Addresses, instead of the Flex Console.

Rate this page: