> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect Agent to Phone (US)
> Carrier-by-carrier US setup with success validation and failure recovery steps.
## Audience
* US-based users connecting forwarding for the first time
* Support/admin users validating failed connection attempts
## Prerequisites
* Active Voqo workspace with an enabled agent
* Agent phone number copied from agent settings
* Mobile carrier account with call forwarding enabled
* Stable cellular signal during setup
## Device and carrier checks before setup
* iPhone users: disable Live Voicemail before enabling forwarding.
* Dual-SIM users: use the intended SIM line for forwarding commands.
* If your carrier blocks forwarding by default, request forwarding activation first.
## Table of Contents
* [AT\&T](#att)
* [T-Mobile](#t-mobile)
* [Verizon](#verizon)
* [Sprint](#sprint)
* [Going overseas — forward every call](#going-overseas-forward-every-call)
## Validation checks (run after any carrier setup)
1. Your phone confirms forwarding was enabled.
2. A test call from another number routes to your AI agent.
3. The completed call appears in call logs.
If any validation fails, use the fallback troubleshooting section at the end of this page.
## AT\&T
Use this guide to enable forwarding to your agent for AT\&T numbers.
## T-Mobile
Use this guide to enable forwarding to your agent for T-Mobile numbers.
## Verizon
Use this guide to enable forwarding to your agent for Verizon numbers.
## Sprint
Use this guide to enable forwarding to your agent for Sprint numbers.
## Going overseas — forward every call
The carrier setups above are *conditional* — your phone rings first, and only missed calls route to your AI agent. When you're travelling overseas (where your phone may not ring at all), you can switch to a *permanent* transfer so that **every** incoming call goes straight to your agent.
1. Get your agent's phone number in full international format (with the leading `+` and `+1` country code).
2. Open the dial pad on your phone.
3. Dial `**21*#` (i.e. `**21*+12184800980#`).
4. Press the call button and wait for the confirmation message.
Every call now goes straight to your AI agent.
**To cancel permanent transfer** when you're back, dial `##21#` and press the call button.
Some US carriers handle call forwarding through their own app or network settings rather than dial codes. If `**21*` doesn't work on your line, contact your carrier for their "forward all calls" (unconditional forwarding) option.
## Fallback troubleshooting (US)
### Setup code accepted but calls still ring your phone
* Confirm forwarding was applied to the same SIM/line receiving calls.
* Disable and re-enable forwarding, then retest.
* Restart device and retry from a strong signal area.
### Setup code rejected by network
* Confirm your carrier supports the forwarding command used.
* Check agent number formatting (country code and no extra characters).
* Contact carrier to confirm forwarding is enabled for your plan.
### Agent answered but no completed call record appears
* Wait a few minutes for processing and refresh call logs.
* Confirm you are viewing the correct workspace and agent context.
If unresolved, contact [support@voqo.ai](mailto:support@voqo.ai) and include workspace ID, carrier, device model, exact command used, and timestamp/timezone.