> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluents.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Numbers

> Numbers are the phone lines your Fluents.ai agents use to send and receive calls. Learn how buying, linking, and tagging numbers fits into your overall setup.

Numbers are the **phone lines** your Fluents.ai agents use to:

* Receive inbound calls from your customers
* Place outbound calls in campaigns
* Control which caller ID your contacts see

Depending on your setup, you can either:

* **Buy new numbers directly in Fluents.ai**, or
* **Link existing numbers** that you already own with a telephony provider.

***

## How numbers fit into Fluents.ai

Numbers sit between your **customers** and your **agents**:

* For **inbound calls**:\
  Customers dial a number → Fluents.ai receives the call → your **inbound agent** answers.

* For **outbound campaigns**:\
  Your **campaign** uses one or more numbers to call a list of contacts → the caller ID they see is the number you chose.

You can:

* Own numbers fully inside Fluents.ai (when you buy numbers)
* Reuse numbers you already have with external providers (when you link numbers)
* Organize numbers with **tags** so you can easily assign the right ones to agents and campaigns

***

## Numbers list view

In the **Numbers** section, you’ll see all phone numbers available for your account.

Typical columns include:

* **ID** – Internal identifier for the number.
* **Number** – The phone number itself.
* **Agent** – The inbound agent currently assigned to this number (if any).
* **Telephony provider** – For example, Fluents, Telnyx, or Twilio.
* **Account connection** – Which provider account the number belongs to (when applicable).
* **Tags** – Any tags you’ve added to group this number (for example, `sales-us`, `after-hours`).

At the top of the page you can:

* **Search numbers** – Quickly find a specific number by searching its digits.
* **Filter by tags** – Show only numbers that match one or more tags.

This makes it easy to locate the right number when assigning agents or configuring campaigns.

***

## Buying vs. linking numbers

Fluents.ai supports two main ways to add numbers to your account.

### 1. Buying numbers in Fluents.ai (US only)

Use this when you **do not have your own telephony provider** and want Fluents.ai to handle the phone line for you.

* Currently, you can buy **US phone numbers** directly in Fluents.ai.

Typical flow:

* Click **New** in the Numbers page.
* Choose the **Fluents** provider (or built‑in option, depending on your UI).
* Pick an available US number.
* Add the number to your account.
* Optionally assign an **inbound agent** and **tags** as part of the setup.

Good for:

* Setting up dedicated inbound lines (for example, Support, After‑hours, Sales).
* Having clean caller IDs for outbound campaigns.
* Getting started quickly without creating accounts at external providers.

***

### 2. Linking existing numbers you already own

If you already have phone numbers with a telephony provider (for example, Telnyx or Twilio), you can **link** those numbers to Fluents.ai.

Linking is simple:

* In the **Numbers** page, use **Link Existing** (or the equivalent action).
* Enter the **phone number** you want to link.
* Fluents.ai validates and, if everything looks good, adds that number to your list.
* Optionally assign an **inbound agent** and **tags** when you link it.

You are not searching an inventory inside Fluents.ai here—you are telling Fluents “use this number I already own with my provider”.

Good for:

* Teams who already use Telnyx, Twilio, or another provider and don’t want to change numbers.
* Preserving existing phone numbers that customers already know.
* Gradually migrating from manual or legacy phone workflows to AI agents.

***

## Assigning numbers to agents (inbound)

To **receive inbound calls**, a number must be linked to an **inbound agent**.

Conceptually:

* **Number** = the phone line customers dial.
* **Agent** = what answers the phone and handles the conversation.

Typical usage:

* Main business line → reception or routing agent.
* After‑hours line → after‑hours agent.
* Support line → support triage agent.

In the **New Number**, **Link Existing**, or **Edit** modal you can:

* Set the **Inbound Agent** for that number.
* Change the assignment later if your workflows change.

You can assign:

* One number to one inbound agent.
* Multiple numbers to the same agent (for example, regional numbers that all route to the same agent).

***

## Using numbers in campaigns (outbound)

For **outbound campaigns**, numbers are used as the **caller ID** your contacts see.

You can:

* Choose which specific number (or pool of numbers) a campaign should use.
* Use different numbers for different regions, brands, or purposes.
* Reuse the same number across multiple campaigns when appropriate.

This is where **tags** become especially helpful.

***

## Organizing numbers with tags

Tags let you **group and filter numbers** so you can easily assign the right ones to agents and campaigns.

Examples of tags:

* `inbound-support`
* `after-hours`
* `sales-us`
* `sales-eu`
* `clinic-a`, `clinic-b` (for multi‑location businesses)

How tags help:

* When creating a **campaign**, you can choose numbers by tag (for example, use all `sales-us` numbers).
* In the **Numbers** page, you can filter by tag to see subsets of numbers (for example, all after‑hours lines).
* When assigning numbers to **inbound agents**, tags can help you find the right set quickly.

Tags are **free‑form**: you can create as many as you need directly in the number modal and reuse them across numbers.

***

## Typical number strategies

Here are a few simple patterns that work well:

### Inbound after‑hours agent

* Buy or link a dedicated **after‑hours number**.
* Tag it `after-hours`.
* Assign it to your **after‑hours inbound agent**.
* Optionally use the same tag when filtering or reporting.

### Outbound sales campaign

* Buy or link **several local numbers** for a region (for example, US East).
* Tag them `sales-us`.
* In your **outbound sales campaign**, choose numbers with the `sales-us` tag.
* Your contacts see a familiar local caller ID, while the campaign manages pacing and retries.

***

## Where to go next

* See how campaigns use numbers in\
  **[Campaigns](./campaigns)**

* Learn how to configure and manage numbers step‑by‑step in the\
  **[Numbers Feature Guide](../features/numbers)**

* Explore real workflows that combine numbers, agents, and campaigns in the\
  **[Use Cases & Tutorials](../quickstart/index)**
