--- title: "Inbound Numbers" slug: "inbound-inbound-numbers" description: "Purchase and manage numbers for your contact center." tags: ["Inbound", "dialed number", "buy number", "third-party number", "Caller ID", "CID", "Call Flow", "Script", "voice", "minimum service term"] updated: 2026-10-15T08:42:35Z published: 2026-10-15T08:42:35Z canonical: "docs.voiso.com/inbound-inbound-numbers" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.voiso.com/llms.txt > Use this file to discover all available pages before exploring further. # Numbers **Who should read this article**: Administrators Purchase and manage numbers for your contact center. ## Introduction Voiso enables you to [manage your existing numbers](/v1/docs/inbound-inbound-numbers#my-numbers), [purchase](/v1/docs/inbound-inbound-numbers#buy-numbers) new numbers globally, and add third-party numbers into your Voiso contact center. To display the **Numbers** page, from the Voiso navigation bar, select **Inbound > Numbers**. The **Numbers** page contains three main functionality areas: [Numbers](/v1/docs/inbound-inbound-numbers#numbers) [Buy numbers](/v1/docs/inbound-inbound-numbers#buy-numbers) [Add numbers](/v1/docs/inbound-inbound-numbers#2-add-thirdparty-number) (single or bulk) ![Inbound Numbers Default Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Default%20View.png) ## Numbers The **Numbers** page allows you to view and manage your numbers. The table includes the following columns: | Column | Description | | --- | --- | | Number | The phone number in {{glossary.E.164}} format. | | Added on | The date that the number was added to your contact center. | | Label | A label that you specify by [editing the details](/v1/docs/inbound-inbound-numbers#4-number-details) of the number. If you do not provide a label, then **Not assigned** is displayed. | | Country | The name and flag of the country to which the number belongs. | | City / Type | The phone number type: **Geographic**, **National**, **Toll-free**, **Shared-cost**, **Mobile**, and others. If the number type is **Geographic**, then the locality to which it belongs is displayed – for example, Los Angeles, CA. | | In use | Indicates whether the number is assigned to a workflow, Caller ID, or CID group. Numbers that have been automatically replaced by the [ASR performance optimization](/v1/docs/asr-performance-optimization) feature will have a warning icon next to them so you know they are no longer in use as a Caller ID in Dialer campaigns and Caller ID groups for manual and click-to-call dialing. | | Action icons | Click an icon to add the number to a [CID group](/v1/docs/outbound-cid-groups), add the number to a [workflow](/v1/docs/inbound-flows#assigned-numbers), or [delete](/v1/docs/inbound-inbound-numbers#7-delete-number) the number. | The functions available on the **Numbers** page are described in the following sections (1-9). ![Inbound My Numbers Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20My%20Numbers%20View.png) The **Buy numbers** feature is described in the [next section](/v1/docs/inbound-inbound-numbers#buy-numbers). 1. [Search](/v1/docs/inbound-inbound-numbers#1-search) 2. [Add numbers](/v1/docs/inbound-inbound-numbers#2-add-numbers) 3. [Select all](/v1/docs/inbound-inbound-numbers#3-select-all) 4. [Number details](/v1/docs/inbound-inbound-numbers#4-number-details) 5. [Add to CID group](/v1/docs/inbound-inbound-numbers#5-add-to-cid-group) 6. [Add to workflow](/v1/docs/inbound-inbound-numbers#6-add-to-workflow) 7. [Delete number](/v1/docs/inbound-inbound-numbers#7-delete-number) 8. [Action menu](/v1/docs/inbound-inbound-numbers#8-action-menu) 9. [Export selected numbers to CSV](/v1/docs/inbound-inbound-numbers#9-export-selected-numbers-to-csv) 10. [Select status or statuses](/v1/docs/inbound-inbound-numbers#10-select-status-or-statuses) ### Automatic number replacement Numbers that have been replaced or require replacement due to the number exceeding the **Max dialing attempts** and **Replacement interval** defined in **[System settings](/v1/docs/administration-system-settings#asr-performance-optimization)** are marked with yellow alert icons. Important Numbers with a yellow alert icon have been replaced and are no longer in use as a Caller ID. When there are no condidate replacement numbers remaining in your inventory, the number requiring replacement is marked with a red alert icon. Refer to [ASR performance optimization](/v1/docs/asr-performance-optimization) for more information about this feature. ### Restricted numbers In some countries and regions, telecom regulations require extra verification before certain phone numbers may be used. When you purchase a number that is classified as **restricted**, the provider must review and approve supporting documents before Voiso can activate the number for Caller ID or inbound calling. Because this approval happens outside of Voiso, restricted numbers may not work immediately after purchase. Voiso shows a red restricted indicator on the **Numbers** page to let you know that the number is awaiting document submission or validation. Once the provider approves the documents, Voiso automatically enables the number for use. ![Inbound Numbers Restricted Numbers](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Restricted%20Numbers.png) Contact your Voiso account manager or support@voiso.com for help with submitting documents. Tip Restricted status depends on local jurisdiction and number type. Approval time varies by provider and country. ### 1. Search To search through all of your numbers to find a specific number or set of numbers, enter at least two digits in the **Search** field. The search results include all numbers that *contain* the number string you entered. You can search by the following parameters: | Parameter | Description | | --- | --- | | Country | The name of the country to which the number belongs. | | Type | The phone number type: **Geographic**, **National**, **Toll-free**, **Shared-cost**, **Mobile**, and others. If the number type is **Geographic**, then the locality to which it belongs is displayed – for example, Los Angeles, CA. | | Label | User defined labels when the number is purchased. | Sort the results by **In use** to find numbers with **Yes**. Click an in-use number to determine whether it is assigned to a [User](/v1/docs/users-users) as the default Caller ID, in a [workflow](/v1/docs/inbound-flows) as an entry point, or is in an outbound [Caller ID (CID) group](/v1/docs/outbound-cid-groups). ### 2. Add numbers To use your own numbers in your Voiso contact center, click **Add numbers** to display the **Add numbers** panel. ![Inbound Numbers Add Third-party Number Panel](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Add%20Third-party%20Number%20Panel.png) Select the method that you want to use: - [Add a single number](/v1/docs/inbound-inbound-numbers#add-a-single-number-method) - [Add multiple numbers](/v1/docs/inbound-inbound-numbers#add-multiple-numbers-method) #### Add a single number method To add a single number, select **Add a single number** in the **Method** section. ![Inbound Numbers Add Number Panel Single Number Method](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Add%20Number%20Panel%20Single%20Number%20Method.png) Enter the information about the number in the following fields in the **General** section. | Field | Description | | --- | --- | | Number | Enter the phone number in E.164 format | | Domain | Select one of the domains specified for your contact center from the **Domain** menu. | | SIP URI | The Uniform Resource Identifier (URI). This value is automatically generated by Voiso and cannot be modified. The SIP URI can be used on your side for call redirection. | | Country | The name and flag of the country to which the number belongs. | | Type | The phone number type: **Geographic**, **National**, **Toll-free**, **Shared-cost**, **Mobile**, and others. If the number type is **Geographic**, then the locality to which it belongs is displayed – for example, Los Angeles, CA. | The cost for the numbers is provided in the **Pricing** section. Tip Depending on your role or security access group settings, pricing information may or may not be displayed. Click **Activate** to add the number to your contact center. #### Add multiple numbers method To add multiple numbers in bulk, select **Add multiple numbers** in the **Method** section. ![Inbound Numbers Add Number Panel Multiple Numbers Method](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Add%20Number%20Panel%20Multiple%20Numbers%20Method.png) Next, click **Download the CSV template** to obtain a template file for entering number information in the correct format for Voiso. Important The numbers must be in {{glossary.E.164}} format with no special characters. Add your numbers to the CSV file, then drag and drop or browse to the file in the **Import phone numbers** field. Voiso analyzes the contents of the file and provides you with a count of the valid, duplicate, and invalid numbers. You can fix the invalid numbers and reupload the CSV file. To learn which numbers are duplicates or invalid, click **Export invalid and duplicate numbers list**. Review the list and update your original CSV file. Then, click the 'X' next to the uploaded file to remove it. Drag and drop or browse to the modified file in the **Import phone numbers field** to upload it. The cost for the numbers is provided in the **Pricing** section. Tip Depending on your role or security access group settings, pricing information may or may not be displayed. Click **Activate** to add the numbers to your contact center. ### 3. Select all To perform bulk operations on all of your numbers, select this check box. To perform operations on one or more numbers, select them individually from the table. ### 4. Number details You can review the details of any number in the table. Click a row in the **Numbers** table to display the **Number details** panel, which contains the following information about each number: ![Inbound Number Details Panel](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Number%20Details%20Panel.png) | Parameter | Description | | --- | --- | | Label | Click the **Label** field to assign or edit an alpha-numeric tag for the number in the **Add label** panel. Enter a new label or select an existing label from the menu, then click **Save**. | | Date purchased | The date the number was purchased from Voiso or a third-party number was added. | | Type | The phone number type: **Geographic**, **National**, **Toll-free**, **Shared-cost**, **Mobile**, and others. | | Country | the country to which the number belongs | | City | If the number type is **Geographic**, then the city or locality to which it belongs is displayed – for example, Los Angeles, CA. | | Channels | The number of simultaneous calls that the number can handle. | | Provider | Voiso or third-party is displayed. | | Activation fee | The cost to activate the number for your contact center | | Monthly fee | The cost each month to use the number. | | Price per min | The cost for each minute that the number is used on a call. | | Auto-replaced on | The date that the number exceeded the Caller ID usage thresholds set on the **[System settings](/v1/docs/administration-system-settings#asr-performance-optimization)** page and was automatically replaced with a number with the same country prefix are no longer being used as a Caller ID in a Caller ID group or in a Dialer Caller ID set. | | As default Caller ID | The number is assigned to a [User](/v1/docs/users-users) as the default Caller ID. | | In workflow | The number is used in a [workflow](/v1/docs/inbound-flows) as an entry point. | | In CID group | The number is used in an outbound [Caller ID (CID) group](/v1/docs/outbound-cid-groups). | | In Dialer campaigns | The number is used in one or more [outbound Dialer campaigns](/v1/docs/outbound-dialer-campaigns). The campaign names appear to the right. Clicking a campaign name displays the **Edit Dialer campaign** page for the campaign. | Tip Click an assigned workflow or Caller ID group to link to the corresponding Edit workflow page or Edit Caller ID group page in your contact center. ### 5. Add to Caller ID groups For outbound calls from your contact center, you can add a number to one or more [CID groups](/v1/docs/outbound-cid-groups) . Select a number, click the **Add to CID groups** icon on the right of the number row to display the **CID groups** page which contains a table listing your CID groups. To assign a number to a CID group, select one or more CID groups in the table, then click **Add to Caller ID group(s)**. ![Inbound Numbers My Numbers CID Groups Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20My%20Numbers%20CID%20Groups%20View.png) Tip To remove a number or numbers from a CID group, navigate to **Outbound > Caller ID groups** and remove the number using the **Edit Caller ID group** page. ### 6. Add to workflow Numbers can be added to an [Inbound call workflow](/v1/docs/inbound-flows#assigned-numbers). 1. Navigate to **Automation > Workflow studio**, then either click **Add workflow** to create a new Inbound call workflow or click the name of an existing workflow. 2. On the **Edit workflow** page, scroll down to the **Assigned numbers** section. 3. Click **Manage** to open the **Number assignment** panel. 4. Select or deselect numbers, then click **Assign**. ![Flow Number Assignment Panel](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Flow%20Number%20Assignment%20Panel.png) ### 7. Delete number You can delete one or more numbers from the **Numbers** page. Select one or more numbers, then click the **Delete** icon at the top of the table. For a single number, click the **Delete** icon on the right of the number row. A warning panel is displayed to enable you to confirm whether you want to delete the number or numbers. If you try to delete numbers that are in use in a [workflow](/v1/docs/inbound-flows), [CID group](/v1/docs/outbound-cid-groups), or [user](/v1/docs/users-users) default Caller ID, a confirmation panel or error message is displayed showing you where the number or numbers are in use. If you click **Delete**, the number is removed from your **Numbers** list and from anywhere that it is used. ![Inbound Numbers My Numbers Are You Sure Delete Panel](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20My%20Numbers%20Are%20You%20Sure%20Delete%20Panel.png) ### 8. Row actions Each number row in the **Numbers** table includes a set of action icons on the right side. The action icons enable you to specify one of the following actions to be performed on the number: - [Add to Caller ID groups](/v1/docs/inbound-inbound-numbers#5-add-to-caller-id-groups) (1) - [Add to workflow](/v1/docs/inbound-inbound-numbers#6-add-to-workflow) (2) - [Delete](/v1/docs/inbound-inbound-numbers#7-delete-number) (3) ![Inbound Numbers My Numbers Action Menu](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20My%20Numbers%20Action%20Menu.png) ### 9. Export CSV You can export a CSV file of all or a subset of your numbers. The numbers in the CSV file are sorted in the order you display in the **Numbers** page. To export *all* numbers, clear the search field, then click **Export CSV**. To export a *subset* of your numbers, use the [search](/v1/docs/inbound-inbound-numbers#1-search) to display only the numbers to be exported, then click **Export CSV**. Tip If your subset of numbers requires more than a single page to be displayed in the **Numbers** page, the numbers from all pages are exported. The CSV formatted file is downloaded to your computer. ![Inbound Numbers CSV File](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20CSV%20File.png) The file includes the following columns of data for each number: - Date purchased - Number - Label - Country - City/Type - Additional services - Activation fee - Monthly fee - Price per min ### 10. Select status or statuses Use the **Select status or statuses** menu to filter the view of the **Numbers** table to display only numbers that have a specific status. Use it to identify numbers that are "first use" or numbers affected by the [ASR performance optimization feature](/v1/docs/asr-performance-optimization). ![Inbound My Numbers View Select Status Or Statuses Menu](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20My%20Numbers%20View%20Select%20Status%20Or%20Statuses%20Menu.png) | Status | Description | | --- | --- | | Select all | View all status filters. | | First use | View only numbers that were offered for sale for the first time. | | Replacement needed | View only numbers that have exceeded the **Max dialing attempts** and **Replacement interval** limits defined in **[System settings](/v1/docs/administration-system-settings#asr-performance-optimization)**, but there are no numbers available in your inventory to replace them. | | Auto-replaced | View only numbers that have exceeded the **Max dialing attempts** and **Replacement interval** limits defined in **[System settings](/v1/docs/administration-system-settings#asr-performance-optimization)** and have been replaced by another number. They are no longer being used as a Caller ID. | | Restricted number | Some numbers are [restricted](/v1/docs/inbound-inbound-numbers#restricted-numbers) in certain jurisdictions until your contact center provides the papers verifying status as a real legal entity as part of a compliance check. | ## Buy Numbers Contact your Voiso account manager or support team about extending numbers and countries that are available for you to buy from the **Buy numbers** page. To buy new numbers for your contact center, from the Voiso navigation bar, navigate to **Inbound > Numbers**, then click **Buy numbers**. ## Buy numbers page When you click **Buy numbers**, the **Buy numbers** page is displayed. The **Select country** panel contains an alphabetically sorted list of the countries that are available for your contact center. If you need to add more countries to the **Country** page, click **Contact us** at the bottom of the page or contact your Voiso account manager or support team directly. To begin the purchase process, select a country for which you want to buy numbers. ![Inbound Numbers Buy Numbers Tab Country Page](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Buy%20Numbers%20Tab%20Country%20View.png) Different options are displayed after you select a country, depending on the availability of numbers within that country and the types of numbers that are available for your contact center. The following tabs might be displayed after you select a country: | Number Type | Description | | --- | --- | | Geographic | A city, state, or region within the selected country. | | National | A country-wide number. | | Toll-free | A toll-free phone number, or freephone number in some countries, is billed to you rather than the calling party. Toll-free numbers enable contacts to call you without incurring long-distance phone charges. Toll-free numbers begin with a special dialing prefix, such as **800**. | | Mobile | A mobile phone number. | | Shared-cost | A shared-cost number is partially billed to you and partially to the contact, enabling the contact to make a call to another country, but pay only the maximum rate for calls within their country. | ## Buying numbers for a country After selecting a country, click the tab with the number type in that country that you need, then select a phone number from the list of numbers. The following section demonstrates selecting a Geographic number. The process is similar for other number types. ### Geographic number type example After selecting a country, in the **Geographic** number type panel, select a geographic region, such as a city. In the screenshot for the Netherlands, several cities and regions are listed. Next to each city or region name is the number of phone numbers available to buy for the geographic region. Use the **Search** field to find a specific city or region. ![Inbound Numbers Country Geographic Type Tab](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20%20Country%20Geographic%20Type%20Tab.png) If the city of **Amsterdam** is selected, a table of phone numbers is displayed, along with their activation fee, monthly fee, and price per minute. ![Inbound Numbers Geographic Type Tab City Numbers](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Geographic%20Type%20Tab%20City%20Numbers.png) Use the **Search** field to look for a specific number string. When you select one or more numbers, the activation, current month, and monthly fees for the numbers are totaled at the bottom of the page. ![Inbound Numbers Geographic Type Tab City Numbers Selected](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Geographic%20Type%20Tab%20City%20Numbers%20Selected.png) Click **Buy numbers** and follow the on-screen instructions to complete payment and add the numbers to your **Numbers** page. Tip The numbers do not appear immediately in the **Numbers** page. You have to wait a few minutes for them to be processed and assigned to your contact center. ## Minimum service term Some numbers available to buy have a minimum service commitment (for example, 6 months). Some minimum service commitment numbers include an early return fee equal to the remaining months of the term because Voiso must pay the carrier for the full term. Minimum service term numbers are clearly indicated in a transparent and understandable format whether you are browsing, purchasing, managing, or returning numbers. ### Browsing minimum service term numbers When you are using the **Buy numbers** view to browse available numbers, numbers with a minimum service term include the number of months that must be purchased for the number in the **Minimum service term** column. Returning (deleting) these numbers prior to the end of the service term will result in your account being immediately charged for the balance of the term. ![Inbound Numbers Buy Numbers Minimum Service Term](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Buy%20Numbers%20Minimum%20Service%20Term.png) ### Purchase confirmation If you select a number for purchase that has a minimum service term, after you click **Buy numbers**, a confirmation dialog box is displayed to you asking you to confirm that you understand the terms of the purchase of a minimum service term number. Click the checkbox to indicate that you agree to the service terms, then click **Buy numbers** to proceed with the transaction. If you do not wish to purchase the minimum service term number, click **Cancel** to be returned to the **Buy numbers** page and deselect the numbers that have a minimum service term before proceeding with your purchase of other numbers. ### Reviewing your purchased numbers The **Numbers** page allows you to filter your numbers by their status, including numbers that have a minimum service term. Click the **Select status or statuses** menu, then select the **Minimum service term** option. Click a number to view its properties in the number details panel. You can view how many months remain in your service term in the **Pricing** section. Numbers with a remaining service term will indicate the number of months remaining. When the term is complete, the minimum service term is no longer displayed. [Video](https://cdn.document360.io/44ae307a-3737-4fbf-98e0-9b888deb90dc/Images/Documentation/Inbound%20Numbers%20Filter%20and%20View%20Minimum%20Service%20Term%20Numbers.mp4) ### Early return (deleting a number) If you [delete](/v1/docs/inbound-inbound-numbers#7-delete-number) a minimum service term number before the end of the term, the following confirmation message is displayed: ``` This number has a minimum service term. If you delete it now, your account will be charged immediately for the remaining months: $x.xx ``` Click **Delete** to return the number or **Cancel** to keep using the number. ### Post term return (deleting a number) If you [delete](/v1/docs/inbound-inbound-numbers#7-delete-number) a minimum service term number after the end of the term, the number is returned with no additional fee applied. CID. The identification phone number used for an outbound call. The number that is displayed to the call recipient. CIDs might become flagged by phone network providers if they are reported as SPAM or fraudulent. Caller ID. The identification phone number used for an outbound call. The number that is displayed to the call recipient. CIDs might become flagged by phone network providers if they are reported as SPAM or fraudulent. The name part of a website address (URL). Domain names identify Internet resources, such as computers, networks, and services, with a text-based label that is easier to memorize than the IP Address. In your Voiso contact center, the domain is the '.voiso.com' part of the URL. A SIP URI (Session Initiation Protocol Uniform Resource Identifier) is a unique address to locate and communicate with endpoints in a SIP-based contact center. It is similar to a URL (Uniform Resource Locator) used on the world wide web. SIP URIs allow SIP endpoints to locate and connect with each other. A complete SIP URI looks similar to an email address, with the user part followed by the at symbol "@" and the domain part. For example, "alice@example.com" or "+15551234567@sip.provider.com" Comma-Separated Values. A data file format where the content is structured in tabular form. Fields (data values) are separated by commas. Rows (records) are separated by line feeds. Voiso supports UTF-8 format for CSV files. CSV files allow interchange of data between spreadsheet applications, text files, and database. It is a common format for importing and exporting data. Each row represents a record. Each value represents an attribute. ## Related - [Caller ID groups](/outbound-cid-groups.md) - [Workflows](/inbound-flows.md) - [Users](/users-users.md) - [Inbound calls](/agent-panel-inbound-calls.md) - [How to start receiving calls](/how-to-start-receiving-calls.md)