Sending Pools (multiple numbers)

In short

Groups several active numbers and picks which one sends each message.

Optional — without a pool, set from to the instance id, phone, or name.

Each pool is official or unofficial only; never mixed.

Useful for large campaigns, with protection if one number fails.

When to use

Situation	Use a pool?
Large campaigns (thousands of messages)	Yes
Want protection if one number fails	Yes
Low volume on a single number	Not needed
Need the same sender every time	Use `from` with a fixed instance id (pool ignored)

Without a pool, set from to the desired instance or let the workspace use its default routing.

API

The from field accepts instance id, pool id/name, E.164 phone, or instance name.

Default pool (no explicit sender)

{
  "to": ["5511999999999"],
  "type": "text",
  "payload": { "message": "Your order was confirmed!" }
}

Specific pool

{
  "from": "POOL_ID_OR_NAME",
  "to": ["5511999999999"],
  "type": "text",
  "payload": { "message": "Weekly promo!" }
}

Fixed number (ignores pool)

{
  "from": "INSTANCE_ID",
  "to": ["5511999999999"],
  "type": "text",
  "payload": { "message": "Message from this number only." }
}

In short