📖 Overview
Use AI Phone Numbers to manage phone numbers that work with your AI assistants. You can see all AI numbers for your organization, give them names, choose which assistant answers incoming calls and which one places outgoing calls, connect existing Rizz numbers to AI, buy new numbers on another page, and optionally enroll numbers in spam protection so carriers are less likely to treat them as unwanted calls.
🔘 Buttons at the top of the page
| What you see | What it does |
|---|---|
| Rizz Numbers | Opens a window to connect an existing Rizz phone number (from your account) to inbound and/or outbound AI assistants. |
| Purchase No | Takes you to another page where you can search for and buy a new number (from available providers) and attach AI assistants at purchase time. |
🗂️ The main table — columns explained
Each row is one AI phone number. Columns are:| Column | Meaning |
|---|---|
| # | Row number (1, 2, 3, …). |
| Name | The nickname you gave this number so you can recognize it in lists. |
| Phone Number | The full phone number. |
| Spam Status | The current spam-reputation status tracked for this number (for example whether it is clean, in progress of checking, or flagged). |
| Code | The three-digit code associated with this number. |
| Renewel At | If this number is billable for your account, this shows when the next renewal date/time is, in your time zone. If the number is not billable in that way, this cell may be empty. |
| Updated At | When this record was last changed, in your time zone. |
| Action | Buttons for Spam Protect (when allowed), Edit, and Delete. A Token control exists in the page for advanced inbound contact mapping but is normally hidden. |
⚙️ Actions on a row
🛡️ Spam Protect- Appears only when this AI number is not already in the spam protection program.
- After you confirm, the system checks your company’s messaging profile setup. If something is missing, you may be asked to contact support.
- If the number is already listed under spam protection, you will see a message instead of adding it twice.
- On success, the Spam Protect button is hidden for that row.
🏷️ Token
If available, this opens Inbound User Information, where you link your contact fields to fields in GoHighLevel (GHL) and pick a GHL Location. You must map at least one field before saving. This helps inbound call information line up with your CRM fields. Changing the location can load that location’s custom fields for mapping.
phone_number / phone_number1), Email / Email Address, First Name, Last Name, address fields (address, city, zip_code, country), and custom fields such as AudienceLabelId (audiencelabelid), aligned with your GHL setup.
⚙️ Phone Number Settings
This window is used in two situations:
- Adding a new AI number (when opened without editing an existing row — for example from flows that open this modal with empty or default values).
- Editing an existing number (via Edit on a row).
| Field | Purpose |
|---|---|
| Enter Code | The three-digit code for the region where you want the new number, or the code tied to this number when editing. Help text: Enter the 3-digit code for the location where you want to purchase a number. |
| Inbound Agent | The AI assistant that answers incoming calls to this number. Help text: Select the AI agent that will handle incoming calls to this number. |
| Outbound Agent | The AI assistant used for outgoing calls from this number. Help text: Select the AI agent that will handle outgoing calls from this number. |
| Nickname | A short label so you can find this number easily. Help text: Give this number a descriptive name for easy identification. |
- Code and nickname are required before the system will proceed.
- If you are creating a new number, the system requests a new number for that code, applies your assistant choices and nickname, and records a usage charge for obtaining that phone number where your plan requires it.
- If you are updating an existing number, the system updates the phone connection and nickname, and adjusts assignments so that another number in your account cannot use the same inbound assistant or the same outbound assistant at the same time—those other numbers are cleared for that assistant type when needed.
🔗 Connect Rizz Number
This connects an existing Rizz number from your account (one that is already set up for voice routing and is not reserved only for the dialer) to AI assistants.
| Field | Purpose |
|---|---|
| Setup Number | Choose which existing Rizz number to connect. Help text: Select an existing Rizz number from your account to setup with AI agents. |
| Nickname (Optional) | A label for this connection. Help text: Give this Rizz number a descriptive name for easy identification. |
| Inbound Agent | Which AI assistant answers calls to this Rizz number. Help text: Select the AI agent that will handle incoming calls to this Rizz number. |
| Outbound Agent | Which AI assistant places calls from this Rizz number. Help text: Select the AI agent that will handle outgoing calls from this Rizz number. |
🛒 Purchase No
On the purchase page you typically:- Choose a nickname (required).
- Choose inbound and outbound AI assistants.
- Search for and select an available phone number.
- Choose a provider (for example Twilio or Plivo).
