Skip to main content

Audience

  • Workspace admins responsible for telephony setup
  • Operators validating routing and test-call readiness

Prerequisites

  • You have admin-level access in the target workspace.
  • Your workspace has an active plan that supports number purchase.
  • You know whether you need AU or US number provisioning.

Steps

1) Purchase a number

  1. Open platform.voqo.ai/numbers.
  2. Select Add Number.
  3. Choose country/region (AU or US where available).
  4. Confirm purchase and save.
Expected in-product signal:
  • New number appears in your numbers list with active status.

2) Configure number routing

  1. Open the purchased number details.
  2. Assign the number to the target agent (or keep unassigned temporarily).
  3. Save any routing/label updates.
Expected in-product signal:
  • Number shows correct assignment and configuration values.

3) Verify with test call

  1. Place a test call to the configured number.
  2. Confirm the target agent handles the call path.
  3. Check Call Logs for completed outcome.
Expected in-product signal:
  • Test call is handled and visible in logs with expected artifacts.

Known constraints

  • Availability and pricing can vary by country and provider inventory.
  • Some operations require workspace admin/owner role.
  • Additional purchased numbers may incur recurring charges by plan.

Troubleshooting

Cannot purchase number

  • Confirm plan and billing status are active.
  • Retry with another available number option.
  • If inventory is unavailable, try again later or another region.

Number purchased but call routing fails

  • Confirm number is assigned to the intended agent.
  • Confirm agent is enabled and phone connection setup is complete.
  • Re-run a test call after saving configuration.

Test call worked once but not consistently

  • Check signal/network quality and agent availability.
  • Verify no conflicting forwarding/routing setup is active.
If unresolved, contact support@voqo.ai with workspace ID, number ID, agent ID, and test call timestamps.