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

Set a phone number's inbound processing Region using the Console


This guide explains how to control which Twilio Region handles incoming calls to your phone numbers.

The examples in this guide target the Australia (AU1) Region.

To get the most out of this guide, familiarize yourself with the concepts described in the Inbound Call Processing overview.


Pin the Phone Numbers product menu for your target Region

pin-the-phone-numbers-product-menu-for-your-target-region page anchor

Pinning the Phone Numbers product menu for your target Region allows you to manage your phone number configuration in the context of the target Region. This feature is available in the legacy Twilio Console. If you're using the new Twilio Console, confirm that your phone numbers are configured for your target Region.

Twilio ConsoleLegacy Console

To confirm that your Phone Numbers are configured for your target Region in the Twilio Console.

  1. Navigate to Numbers & Senders > Phone Numbers, then select your phone number.
  2. In the Regional tab, check that your phone number's active Region is set to your target Region. If not, click Change active region.
  3. Select the Region you want to switch to, and click Update region.

Access your phone number's configuration in the target Region

access-your-phone-numbers-configuration-in-the-target-region page anchor
(warning)

Legacy Console only

The following instructions apply to the legacy Twilio Console. If you're using the new Twilio Console, confirm that your phone numbers are configured for your target Region as described in Pin the Phone Numbers product menu for your target Region.

To find the configuration page for a phone number in your target Region:

  1. Expand the menu section for your target Region (skip this step if there are no Region sections present in the navigation menu because you only have one Region pinned).
  2. Under the expanded target Region section, click to expand Phone Numbers , followed by Manage.
  3. Finally, click on Active numbers .

All of your account's phone numbers are listed here. Click on a number to go to the configuration page for that number in the context of your target Region.


Review the phone number's Region-specific configuration

review-the-phone-numbers-region-specific-configuration page anchor
(warning)

Legacy Console only

The following instructions apply to the legacy Twilio Console. If you're using the new Twilio Console, confirm that your phone numbers are configured for your target Region as described in Pin the Phone Numbers product menu for your target Region.

Review the phone number's configuration in the target Region. The configuration might be different to the configuration for the same number in other Regions, so ensure that the configuration values are appropriate before activating incoming call routing to the Region.

For example, you should check that the Incoming Call webhook URL settings are correct for your application.

(information)

Test incoming call handling in the Region

To test incoming call handling in the Region without interacting with your application, consider using the demonstration URL for your Incoming Call webhook: https://demo.twilio.com/welcome/voice/(link takes you to an external page)

This URL returns a TwiML Response that instructs Twilio to play a sample message to the caller.


Review and change the phone number's incoming call routing setting

review-and-change-the-phone-numbers-incoming-call-routing-setting page anchor
(warning)

Legacy Console only

The following instructions apply to the legacy Twilio Console. If you're using the new Twilio Console, confirm that your phone numbers are configured for your target Region as described in Pin the Phone Numbers product menu for your target Region.

Go to Routing to see the number's current incoming call routing setting in this Region.

This panel indicates whether the target Region is the "Active" Region for incoming call routing or not.

  • If the target Region is identified as "Active": incoming calls to the number are routed to this Region.
  • If the target Region is identified as "Inactive": incoming calls to the number are routed to another Region.

If the target Region is not set to Active, you can opt to set it to Active by clicking on the Re-route button. You must confirm the change for it to take effect.

(error)

Changing incoming call routing can lead to errors

Changing a phone number's incoming call routing Region can lead to call handling errors in certain cases. Test call routing in the target Region in a pre-production environment before changing routing in production.


Verify the incoming call routing Region

verify-the-incoming-call-routing-region page anchor

To verify that calls to your phone number are being handled in the appropriate Region after a routing change:

  1. Place a call to your phone number from any phone.
  2. Visit the phone number's Call Logs from the target Region.
  3. Verify that you find a new call log that corresponds with your sample call from step 1.
  4. Visit the phone number's Call Logs in a different, non-Active Region.
  5. Verify that you do not find a Call Log that corresponds with your sample call.

Now that you can handle incoming calls in a specific Twilio Region, check out these resources to learn more about building with Twilio Regions.