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.
When sending messages, use the send endpoint for Number Pool. You will need to omit the “From” field from the request and instead specify the Messaging Profile (via the
messaging_profile_id parameter) with the number pool you'd like to utilize for sending your message.
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, but the weight must be a non-negative number, and when equal to zero it will remove the number type from the pool.
If this feature is enabled, Telnyx takes into the account the health of a number when choosing a number from the pool. Numbers are flagged as unhealthy if deliverability is under 25%. 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.
To configure Number Pool in your Portal:
- 1Click on “Messaging” in the navigation menu on the left-hand side of the Telnyx Mission Control Portal.
- 2Click the edit symbol next to the Messaging Profile you want to use.
- 3Under Outbound, toggle on “Number Pool” to enable.
- 4Once 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.
- 5Click “Save”.
Congrats, you're ready to use Number Pool.