Pools
A pool is a named group of phones that send as one. Messages sent to a pool are spread round-robin over its online phones, and when one of them goes offline, stops answering or rejects a message, the message moves to another phone in the same pool, with no duplicates. Use a pool when one phone isn’t enough for your volume, or when you can’t afford a gap while a phone is down.
You manage pools in the Pools panel at the bottom of Devices. The panel appears once at least one phone is paired.
Create a pool
Section titled “Create a pool”-
Open Devices. The Pools panel lists each pool with its phones and how many are online. Click New pool. (With no pools yet, the panel says so and offers Create a pool.)
Click New pool. -
Under Pool name, name it after what it serves, like a branch or a shift, and click Create pool.
Name the pool and click Create pool. -
The new pool appears in the panel, empty. Until it has two phones, it warns that one can’t cover for another yet.
The pool is created, with no phones yet.
Add and remove phones
Section titled “Add and remove phones”A phone belongs to at most one pool.
-
Open Add a phone to the pool and choose a phone. A phone that is already in another pool is marked (moves from that pool**)**: choosing it moves it.
Choose a phone to add. -
The phone joins the pool’s list with its state and carriers. Click Remove beside a phone to take it out; it stays paired and keeps sending on its own.
The phone is in the pool. Remove takes it out.
A pool shows a warning while fewer than two of its phones are online: Fewer than two phones in this pool are online, so nothing can take over right now. Bring a phone back online (see Devices) or add another.
Rename or delete a pool
Section titled “Rename or delete a pool”Click ⋮ beside the pool’s name.
- Rename changes the name only. The pool’s ID stays the same, so integrations that send to it keep working.
- Delete pool… removes the pool after you type
deleteto confirm. Its phones stay paired and keep sending on their own, but anything that sends to the pool by its ID starts failing.
Send to a pool
Section titled “Send to a pool”-
On Send, under Send from, choose Pool · and the pool’s name. The option shows how many of its phones there are and how many are online. A pool with no phones can’t be chosen.
Choose the pool under Send from. -
Send as usual. The result line confirms the messages are queued, and the path under the preview runs through the pool.
The message is queued for the pool.
Pools work the same way elsewhere:
- Campaigns: under Phones in the campaign builder, choose A pool, then pick it under Pool.
- The API: pass
poolIdtoPOST /v1/messages. Pools are also managed withGET,POST,PATCHandDELETEon/v1/pools, and a phone joins or leaves withPATCH /v1/devices/:idandpoolId. See the pools reference.
How failover works
Section titled “How failover works”| Situation | What happens |
|---|---|
| Every phone in the pool is online | Messages go to each online phone in turn. |
| A phone doesn’t confirm a message in time, or rejects it | The message is routed to another online phone in the pool. |
| A phone goes offline | Its messages move to the pool’s other online phones. |
| Every phone in the pool is offline | Messages wait in the queue until one comes back. |
Each phone still keeps your sending settings: the pause between messages, the send window and SIM daily limits.
Pools on your plan
Section titled “Pools on your plan”Pools and failover are part of the Pro plan and above. On a plan without them, New pool shows why it’s unavailable and links to Plan and usage.
Who can manage pools
Section titled “Who can manage pools”Creating, renaming and deleting pools and moving phones need devices:manage, which the Owner, Admin and Developer roles have. An API key needs the devices:manage scope. See Team.