Number Pool

Number Pool distributes your outbound messaging traffic across multiple phone numbers to help you manage your messaging campaigns. The pool of numbers includes all long code and toll-free numbers assigned to your Messaging Profile. When you send a message, the “From” number is selected from the numbers in your Number Pool that aren’t currently being used to send a message.

Follow the instructions below to set up Number Pool on one of your Messaging Profiles. You will also need to associate at least one phone number with the Messaging Profile.

Weights

Long Code and Toll Free weight defines the ratio at which a number type will be selected when sending a message. For example, if Long Code weight is 5, and Toll Free weight is 1, then every five messages will be sent from a Long Code number in the number pool, and the sixth message will be sent from a Toll Free number. The sum of the weights for all number types does not necessarily need to add to 100. Weight must be a non-negative number, and when equal to zero it will remove the number type from the pool.

Skip Unhealthy

If this feature is enabled, Telnyx takes into the account the health of a number when choosing a number from the pool. If a number is deemed unhealthy, it's skipped until it's deemed to be healthy again.

Note: If no number in the pool is deemed healthy, number pool will not choose a number and will reject the message.

Using the Mission Control Portal

To configure Number Pool in your Portal:

  1. Click on “Messaging” in the navigation menu on the left-hand side of the Telnyx Mission Control Portal.
  2. Click the edit symbol next to the Messaging Profile you want to use.
  3. Under Outbound, toggle on “Number Pool” to enable.
  4. Once enabled, you can adjust the weighting of long code and toll-free numbers. For higher delivery rates, you can also select “Skip Unhealthy Numbers” to exclude any numbers with low delivery rates.
  5. Click “Save”.

That’s it. You’re all set to use Number Pool.

Note: You’ll need to keep the “From” field blank when sending messages for the feature to work.

Using the Telnyx API

Your Messaging Profile ID can found at the top of your Messaging Profile under the "Profile Info" section.

Note: Your Messaging Profile ID is different from the Profile Secret found in the “Outbound” section of the Messaging Profile.

The code below enables then disables Number Pool for a Messaging Profile:

Copy
Copied
curl -X PATCH \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "x-api-token: YOUR_TELNYX_API_TOKEN" \
  --header "x-api-user: YOUR_TELNYX_API_USER" \
  --data '{"number_pool_settings":{"long_code_weight":1,"toll_free_weight":10}}' \
  "https://api.telnyx.com/messaging/profiles/{YOUR_MESSAGING_PROFILE_ID}"


curl -X PATCH \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "x-api-token: YOUR_TELNYX_API_TOKEN" \
  --header "x-api-user: YOUR_TELNYX_API_USER" \
  --data '{"number_pool_settings":{}}' \
  "https://api.telnyx.com/messaging/profiles/{YOUR_MESSAGING_PROFILE_ID}"

Note: After pasting the above content, Kindly check and remove any new line added