Skip to main content

AI Voice End User Guide

This guide covers everything you need to know about configuring and managing your AI Voice agent: getting started, what the agent can do, call forwarding, call transfers, which calls still need your team, reading call results, and blocked numbers. The same topics are available inside the app. Open the Help button on the AI Voice dashboard.

Getting Started

Before You Forward Real Calls

  1. Add your business knowledge. Scan your website or add topics by hand. Cover the questions callers ask most.
  2. Set the agent’s name, voice, and greeting in Settings → Agent Customization. Use the business name callers would recognize, not your full legal name.
  3. Fix pronunciation in Settings → Pronunciation Guide. Your business name is a good first word to add.
  4. Place a test call from the Test & Activate tab. Ask the questions your callers ask and listen for wrong or missing answers.
  5. Turn on forwarding once the test calls sound right (see Call Forwarding).
Browser test calls cannot transfer, because there is no real phone line to hand off. Call the agent from a real phone to test a transfer.

Writing Knowledge That Works on a Call

The agent repeats what you give it, so the wording matters.
  • Be specific about your service area. If you list only one zip code and a caller names the one next door, the agent has nothing to go on. Add city and neighborhood names alongside zip codes.
  • Keep each topic short and factual. Clear, direct statements work better than long paragraphs.
  • Leave gaps as gaps. When the agent does not know an answer, it says so and offers to take a message.

When the Agent Gets an Answer Wrong

Open the call, read or listen to what the agent said, then fix the source:
  • Wrong or missing fact: edit or add the topic in your knowledge. The next call uses the new wording.
  • Mispronounced word: add it to the Pronunciation Guide.
  • Poorly handled call: leave feedback on the call.
The in-app Help Center explains how the product works; the agent does not read it. The knowledge you add in the dashboard is what the agent uses to answer callers.

What Your Agent Can Do

Accounts with a Capabilities tab see everything the agent follows, does, and knows:
  • Guidance: how the agent behaves on every call.
  • Skills: complete jobs the agent can carry out on a call, such as taking in a new client.
  • Escalations: when the agent hands a call to a person (see Call Transfers).
  • Knowledge: the facts about your business the agent looks up to answer callers.
Some skills use tools, which let the agent act in a connected system during the call, such as checking availability or saving a request. Tools are connected per account, so the available actions differ for every business.

What You Can Change

Each row shows who supplied it. Rows with a switch are optional: turn one off and the agent stops using it. Rows without a switch are always on. Knowledge and custom escalations are yours to add, edit, and delete. Changes are saved together with the Save button.

Taking a Request Is Not Completing It

  • Taking a request means the agent wrote down what the caller wants. Your team still has to do it.
  • Sending a booking link means the caller can book. It does not mean they did.
  • A booking or cancellation is complete only when the agent has a tool that makes it and the tool confirms it worked.

Call Forwarding

What is Call Forwarding?

Call forwarding routes calls from your existing business phone number to your new AI phone number. When customers call your regular number, the call is automatically forwarded to your AI agent, which can handle the conversation, answer questions, and even transfer calls to you when needed.

Forwarding Types

You can choose how calls are forwarded:
  • Missed Calls Only: Your phone rings first, giving you a chance to answer. If you don’t pick up, the call forwards to the AI agent. This is the recommended option for most businesses.
  • All Calls: Every call to your business number is immediately forwarded to the AI agent without ringing your business phone first. This means you or your team only need to answer calls that the AI could not answer. Note: this requires careful configuration to avoid infinite loops (see below).
  • None: Calls to your business phone number are never forwarded to the AI agent. The only way calls will reach the AI agent is by calling the agent’s number directly.
If you use Blocked Numbers (see Blocked Calls), what callers experience depends on which forwarding type you chose—especially whether your business phone rings before the AI is involved.

How to Set Up Call Forwarding

Use Mobile & Landlines below if your carrier uses activation dial codes. If you use VoIP (Google Voice, Dialpad, Quo, TextNow, Grasshopper, RingCentral, Weave, or another provider listed in the app), skip the dial-code tables and follow VoIP Providers—the product walks you through provider-specific steps there.

Mobile & Landlines

  1. Select Your Phone Type: Choose cell phone, landline, or VoIP, then pick your carrier in the app.
  2. Select Your Carrier: Choose your phone carrier from the list.
  3. Enter Your Forwarding Number: Enter the phone number from which you want to forward calls to your AI agent (typically your business line or the phone that receives your business calls).
  4. Choose Forwarding Type: Select All Calls, Missed Calls Only, or None.
  5. Dial the Activation Code: Use the carrier-specific dial code provided in the app. The code will include your AI phone number formatted correctly for your carrier.
After dialing the code, the system will test the forwarding to ensure it’s working correctly. Required: Disable these settings before testing These phone settings must be turned off before running the test. Otherwise, they will prevent the AI voice agent from receiving your calls.
  • Live Voicemail: Turn off in Settings → Phone → Live Voicemail (iOS).
  • Screen Unknown Callers: Turn off in Settings → Phone → Screen Unknown Callers → set to “Never” (iOS).

Carrier-Specific Dial Codes

Activation Codes
Dial these codes from your phone to activate call forwarding. Replace (XXX) XXX-XXXX with your AI phone number in the format shown. Don’t see your carrier? Search your carrier name plus “call forwarding” (or “call forwarding code”) to find your provider’s instructions.
Deactivation Codes
Dial these codes from your phone to disable call forwarding: Don’t see your carrier? Search your carrier name plus “call forwarding” (or “call forwarding code”) to find your provider’s instructions.

VoIP Providers

If you’re using a supported VoIP provider (Dialpad, Quo, Google Voice, TextNow, Grasshopper, RingCentral, Weave, or another listed in the app), call forwarding is set up in that provider’s dashboard or app—not with carrier dial codes. The in-app flow shows step-by-step instructions for the provider you select; the summary below stays aligned with those steps.

Dialpad

  1. In Dialpad, open Your Settings → Your Devices.
  2. Click Add New → Add a forwarding number, enter your AI phone number, and select Verify. Dialpad calls the AI phone number and asks for 1 to be pressed; the AI presses it.
  3. Check that the AI phone number now shows under Your Devices.
Dialpad rings forwarding numbers at the same time as your Dialpad apps, so the AI often answers first. To send it only unanswered calls, ask Dialpad Support to enable forwarding unanswered calls to an external number. To disable, delete the AI phone number from Your Devices. See Manage your Dialpad devices.

Quo

  1. Log in to Quo and open Settings → Phone Numbers. Click your business number and scroll to Call Flows.
  2. All Calls: open the Default call flow dropdown, choose Forward all calls, enter your AI phone number, and click Create new call flow. Click Enable this call flow and check that it shows Live.
  3. Missed Calls Only: add a Forward call step after the Ring users step, with your AI phone number as an external number.
To disable, switch back to Default call flow and click Enable this call flow, or remove the Forward call step. See Quo call forwarding.

Grasshopper

  1. Sign in to the Grasshopper admin portal and open Call management → Extensions. Click the edit icon next to the extension your calls ring. (Older portal: Extensions → Edit.)
  2. Under Call forwarding numbers, select Add call forwarding, enter your AI phone number, and set Status to Active.
  3. Set Call handling to Calls will connect as soon as you pick up, then Save.
  4. Missed Calls Only: keep your own phone on the extension, choose Ring in specific order with the AI phone number last, and under Preferences choose Once per number in the pre-determined order.
To disable, edit the AI phone number and set Status to Inactive. Keep at least one other number on the extension, or its calls go to voicemail. See Forward incoming calls for an extension.

RingCentral

In the RingCentral app, click your profile picture (top left) → Call rules → Forward all calls. In the Incoming calls dropdown, select Forward the call, click Number, and enter your AI agent number as the external forwarding destination, then Save. To disable, return to Call rules → Forward all calls and turn Forward all calls off (or remove the rule). See Forwarding calls to an external number.

Weave

  1. As a Weave admin, open Settings → Phone → Call Routes and select your business number’s route.
  2. Click + Add Step → Forwarding Number and enter your AI phone number. For Missed Calls Only, place it after your staff’s Call Group; for All Calls, route directly to it.
  3. Set Ring Duration and review Forwarded Caller ID. Click Done, then Save Changes.
  4. Call your business number from another phone. For missed calls, let it ring unanswered. Check that the AI answers and receives the caller’s number.
Using a Call Queue? Check that calls reach the AI when the hold time runs out. Ask Weave Support if needed. See Call Queue setup. See Weave’s forwarding guide or disable forwarding below.

Google Voice

Google Voice uses linked numbers and custom call forwarding rules at voice.google.com. Full steps appear in the app when you choose Google Voice; use this checklist so documentation matches the product:
  1. Link your AI number — In Google Voice, open Settings (gear) → under Account, New linked number, and enter your AI agent phone number. Use Verify by phone (the small blue link); SMS verification may not be available—phone verification is required. Google Voice will call your AI number with a code; complete verification in Voice (e.g. from the Calls tab / recording or transcript, as the app describes).
  2. Forwarding rule — Calls → Create a rule → choose who should forward (e.g. All contacts) → under Forward to these numbers, select your linked AI number. Turn call screening off; if you hear “To accept the call, press 1”, screening is still on—go back and disable it. See Use custom call forwarding with Google Voice.
  3. Caller ID when forwarding (required) — In Settings → Calls, turn off Show my Google Voice number as caller ID when forwarding calls. If this stays on, the line that receives the forward (your AI number) may only see your Google Voice number instead of each caller’s real number, which breaks correct caller identification for your agent. See Change caller ID for incoming calls (Google Voice Help). Google notes this setting does not apply to Voice calls placed over the internet—those already show the caller’s number.

TextNow

Call forwarding on TextNow requires an Ad-Free+ subscription. Once you have Ad-Free+, configure forwarding from the TextNow app: tap the main menu (top left) → Settings → Calling → Call Forwarding, toggle Call Forwarding to ON, and enter your AI agent phone number when prompted. To change the number later, tap Forward To on the Call Forwarding page. See What is Ad-Free+.

How to Disable Call Forwarding

Mobile & Landlines

Follow the deactivation instructions we provide in the app. The dial codes are also listed in the table above for convenience—use the code that matches your carrier and the forwarding type you activated. The deactivation code does not require your phone number; just dial the code directly. After you’ve deactivated with your carrier, the app will ask you to confirm so our settings stay in sync with your actual call forwarding state. If you turned off Live Voicemail or Screen Unknown Callers (iOS) when setting up forwarding, you can turn them back on in Settings → Phone once call forwarding is disabled.

VoIP: disable forwarding

Follow the disable instructions we provide in the app for your VoIP provider. After you’ve deactivated with your provider, the app will ask you to confirm so our settings stay in sync with your actual call forwarding state. Google Voice: On a computer, open voice.google.com → Calls → find the rule that forwards to your AI number → open it and delete the rule. Optionally, in Settings → Account, remove your AI number from linked numbers if you no longer want it linked. TextNow: In the TextNow app, tap the main menu (top left) → Settings → Calling → Call Forwarding, then toggle Call Forwarding to OFF. Weave:
  1. Open Settings → Phone → Call Routes and select the route you changed.
  2. Remove the AI Forwarding Number step (Trashcan icon) and restore your usual phones or voicemail.
  3. Click Save Changes. If you also changed a Call Queue fallback, restore its previous destination and save the queue settings.
  4. Call your business number to confirm forwarding is off.
See Weave’s routing guide.

Call Transfers

What are Call Transfers?

Call transfers allow your AI agent to route live calls to a human agent (like you or your team) when the caller needs to speak with a real person. The AI agent intelligently recognizes when a transfer is needed based on the prompts you configure.

Why Call Transfers Matter

As capable as AI voice agents are, it’s important that customers can still reach a real person when needed. Some situations require human judgment, empathy, or expertise that only a person can provide. Call transfers ensure your customers always have a path to human assistance when necessary.

How Call Transfers Work

Transfer rules come in two groups. On accounts with a Capabilities tab they are called escalations and live there; on other accounts they are Transfer Rules in Settings. They work the same way.
  • Default rules are written by your provider. You cannot edit their wording. They all transfer to one default transfer number that you choose, and they stay off until you add that number. Where a default rule shows a switch, you can turn it off without affecting the others.
  • Custom rules are written by you. Each has its own name, its own condition, and its own phone number. You can add up to 10.
Changes to transfer rules are collected and take effect when you press Save. Each custom rule consists of:
  • Name: A descriptive name for the transfer (e.g., “Sales Team” or “Support Line”)
  • Phone Number: The number where calls in this category should be transferred
  • Prompt: The specific condition that tells the AI when to use this transfer

Warm Handoffs

When the AI agent transfers a caller to you, you will receive a phone call from the agent’s phone number. The agent first provides a summary of the conversation so far. This warm handoff gives you immediate context about what the caller has called about, what information has already been discussed, and any important details. You don’t have to ask the same questions the AI already asked—you can pick up right where the conversation left off, providing a seamless experience for your customer.

Writing Effective Transfer Prompts

Transfer prompts must be explicit and specific for the AI to recognize when to use them. Be clear about the scenarios that should trigger a transfer. Good examples:
  • “Transfer to sales when the caller asks about pricing or wants to make a purchase”
  • “Transfer to support when the caller reports a technical issue or needs troubleshooting help”
  • “Transfer to billing when the caller has questions about their invoice or payment”
Less effective examples:
  • “Transfer if they need help” (too vague)
  • “Transfer for important calls” (not specific enough)

Caller ID and Saving Your Number

Important: When the AI agent transfers a call to you, the incoming call appears as coming from your AI agent’s phone number, not the original caller’s number. You must save your AI agent’s phone number in your contacts so you recognize incoming transfers and answer them. If you don’t recognize the number, you might miss important customer calls.

When Nobody Answers a Transfer

The agent rings the transfer number once and does not retry. If the transfer is busy, goes unanswered, or reaches voicemail, the agent tells the caller it could not reach anyone and offers to take a message or a callback request. The call then shows a next step asking your team to call them back. A transfer is a handoff, not a resolution. Transferred calls stay open until your team confirms the caller was helped (see Which Calls Need Your Team).

Which Calls Need Your Team

Every call is either open or resolved. A resolved call shows who finished it:
  • Resolved by your agent: the caller asked for something, the agent completed it during the call through a tool, and nothing was left unfinished.
  • Resolved by your team: someone on your team marked the call resolved.
A call with no next step is not automatically resolved. The agent gets credit only for a request it completed.

Needs Follow-up vs. Unresolved

Both filters on the Calls tab show open calls:
  • Needs follow-up is your to-do list: open calls that have a next step for your team.
  • Unresolved is every open call, including ones with no next step.

How Common Calls End Up

Changing a Call’s Status

Use the menu on a call in the list, or the buttons in the call’s details.
  • Mark resolved when your team has finished with the call.
  • Mark unresolved reopens a call, including one the agent resolved by mistake. Its next step comes back, so it returns to Needs follow-up.

Understanding Calls and Results

What Each Call Shows

  • Summary: a short written account of what the caller wanted and what the agent did.
  • Recording and transcript: the full call, to listen to or read.
  • Next step: what your team still needs to do, if anything.
  • Booking: when the agent books an appointment through a connected tool, the call shows the appointment and its date and time. A booking link sent to the caller does not show as a booking.

Statistics

The Statistics tab totals your calls for the date range you pick: all calls, time saved, calls transferred, spam calls blocked, caller sentiment, popular topics, and when people call.

Leads

Accounts with a Leads tab see the people the agent captured as leads and the call each one came from. A lead is a contact, not a sale: it counts as converted only after that person makes a purchase. Three results are easy to mix up:
  • Capturing a lead means the agent saved who called and what they want. Your team still follows up.
  • Confirming a booking means an appointment exists.
  • Completing the caller’s request means nothing is left to do. Only then is the call resolved by the agent.

Agent Actions

What are Agent Actions?

During a call, your AI agent can take actions in the systems connected to your account—checking availability, looking up an account, or starting a booking. The agent does this mid-conversation, so the caller gets an answer on the spot instead of waiting for a callback. The actions available depend on what has been set up for your account.

Results That Arrive Later

Some actions take longer than a caller can wait—a booking that needs confirmation, or a quote that takes time to price. When the result is ready, it is delivered to the AI agent while the call is in progress, and the agent uses it in its next response. The caller is not interrupted, and the agent does not announce the update. If the result arrives after the call has ended, it cannot reach the caller—follow up with them directly.

Infinite Loop Prevention

What is an Infinite Loop?

An infinite loop occurs when a call forwarding configuration creates a circular routing pattern where calls bounce endlessly between numbers. The app automatically detects and prevents these configurations.

When Infinite Loops Occur

Infinite loop detection only applies to “All Calls” forwarding. Here’s why:
  • With “All Calls” forwarding: Every inbound call is immediately redirected to the AI agent, including calls the agent itself places back to that number during a transfer. This creates an infinite loop: Call → Forward to AI → AI calls back → Forward to AI again → Loop continues.
  • With “Missed Calls Only” forwarding: Your phone rings first, giving you a chance to answer before the call forwards. If you don’t pick up, the call goes to the agent. The agent can then try to call you back, and your phone rings again—no loop, just another opportunity for you to answer. The delay from ringing prevents the loop.

How the App Prevents Infinite Loops

The app automatically detects when a call forwarding + call transfer configuration could create a loop. The system warns you and blocks the configuration before it can be saved, preventing the issue from occurring. If you see an infinite loop warning, consider:
  • Changing your forwarding type from “All Calls” to “Missed Calls Only”
  • Adjusting your call transfer configuration to transfer to a different number

Blocked Calls

What are Blocked Calls?

You can block phone numbers in the app. Blocked numbers will not be picked up by the AI voice—they will not be responded to and will not go to voicemail. Blocking is best used for spam and other junk callers, and it saves you money since the AI won’t answer those calls or use any AI processing on them.

Important: Blocking does not stop calls to your business line

Blocking a number in Reach does not prevent that person from calling your business phone. The call can still reach your line as usual—it is only blocked from being handled by your AI agent. This means:
  • The blocked caller can still reach you or your team if someone answers the phone
  • Blocked calls do not consume AI Voice usage
  • Blocked calls do not incur AI processing charges
To stop a spam or junk caller from ringing your phone at all, block them on your phone or through your carrier—not only in Reach.

How blocking works with call forwarding

What happens when a blocked number calls depends on how the call reaches your AI agent.

Scenario A: Caller dials your AI agent number directly

The call goes straight to your AI agent. The AI will not answer, and the call will not use AI processing.

Scenario B: Caller dials your business number (Missed Calls Only forwarding)

  1. Your business phone rings and you see the caller.
  2. If you do not answer, the call forwards to your AI agent.
  3. The AI will not answer the forwarded call.
Blocking only stops the AI—the caller can still ring your business line. Use phone or carrier blocking if you want those calls to never ring your phone.

Scenario C: Caller dials your business number (All Calls forwarding)

  1. The call is forwarded to your AI agent immediately—your business phone does not ring first.
  2. The AI will not answer, and the call will not use AI processing.
The caller may hear ringing or silence depending on your carrier; they will not reach a live person or the AI.

Choosing the right approach

How to Block a Number

You can block numbers in two ways:
  1. From Call Details: After viewing a call in your call history, click the “Block number” button in the call details view.
  2. From Settings: Go to Settings → Blocked Numbers and add a number manually.
Once blocked, your AI agent will not answer calls from that number. Depending on your call forwarding setup, the caller may still be able to ring your business phone (see How blocking works with call forwarding).

How to Unblock a Number

To unblock a number, go to Settings → Blocked Numbers, find the number in your blocked list, and remove it. The number will immediately be able to reach your AI agent again.