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

# Phone Numbers & Provisioning

> Provisioning and managing sending numbers

Phone numbers are the foundation of SMS sending. This guide covers provisioning, configuration, and management.

## Number Types

| Type                | Description                                               | Use Case                          |
| ------------------- | --------------------------------------------------------- | --------------------------------- |
| **10DLC**           | Standard 10-digit long code, registered for A2P messaging | Low-to-medium volume              |
| **Short code**      | 5-6 digit number (standard rate or FTEU)                  | High-volume marketing             |
| **Toll-free (TFN)** | 1-800 style numbers                                       | Customer service, moderate volume |

## Providers

With managed provisioning, Trackly handles carrier routing for you — request a number and it is provisioned on a tier-1 route with no provider setup on your side. If you'd rather bring your own provider account, Trackly integrates directly with Infobip, CM, Twilio, and Lime (see BYOC below).

**Dual-route provisioning** is supported for toll-free numbers — a single number can be provisioned across two routes for redundancy and faster setup.

## BYOC (Bring Your Own Carrier)

If you already have SMS provider credentials, you can use them directly with Trackly:

1. Configure your provider's webhook forwarding to point to Trackly
2. Complete the 3-step webhook verification (credentials test → send test → webhook reply)
3. Your BYOC list is ready to send

BYOC lists support all Trackly features (tracking, billing, compliance) but use your own provider rates.

## Provisioning Process

<Note>
  Number provisioning requires a **Paid plan** (\$19.99/month). Free plan users can bring their own numbers from any supported provider. Upgrade in **Settings > Account Settings**.
</Note>

### Step 1: Request a Number

1. Go to **Number Requests**
2. Click **Request Number**
3. Fill in details:
   * Business name
   * Use case description
   * Expected volume
   * Sample messages

### Step 2: Carrier Review

Carriers review your request for:

* Business legitimacy
* Compliance with guidelines
* Content appropriateness
* Volume reasonability

Timeline: 1-5 business days

### Step 3: Approval

Once approved:

* Number is assigned
* Provider account configured
* Ready to add to Trackly

### Step 4: Add to Trackly

1. Go to **Lists**
2. Click **New List**
3. Enter:
   * Phone number
   * Provider credentials
   * Brand name

## Provider Configuration

### Infobip

| Field     | Value                |
| --------- | -------------------- |
| API Key   | Your Infobip API key |
| Base URL  | Infobip API endpoint |
| Sender ID | Approved number      |

### Twilio

| Field        | Value              |
| ------------ | ------------------ |
| Account SID  | Twilio account SID |
| Auth Token   | Twilio auth token  |
| Phone Number | Twilio number      |

### CM

| Field         | Value              |
| ------------- | ------------------ |
| Product Token | CM product token   |
| Sender        | Approved sender ID |

## Number Status

| Status    | Meaning              |
| --------- | -------------------- |
| Active    | Ready to send        |
| Inactive  | Temporarily disabled |
| Pending   | Awaiting approval    |
| Suspended | Blocked by carrier   |

## Multiple Numbers

You can have multiple sending lists/numbers for:

* Different brands
* Different use cases
* Geographic targeting
* Load distribution

Each list operates independently with its own contacts.

## Number Health

### Delivery Rate

Monitor delivery success:

* 95%+ is healthy
* Below 90% investigate issues
* Below 80% may indicate problems

### Carrier Feedback

Watch for:

* Spam complaints
* High opt-out rates
* Carrier warnings

Discord alerts notify you of issues.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Number not sending">
    Check:

    * Is the list status active?
    * Are provider credentials valid?
    * Is there sufficient balance?
  </Accordion>

  <Accordion title="High failure rate from number">
    Possible causes:

    * Carrier throttling
    * Spam flag
    * Invalid configuration
  </Accordion>

  <Accordion title="Number suspended">
    Create an **Urgent** priority support ticket immediately from your dashboard (**Support > New Ticket**). Common causes:

    * Content violations
    * Spam complaints
    * Regulatory issues
  </Accordion>
</AccordionGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Use descriptive list names">
    "Marketing - Brand A" not "List 1"
  </Accordion>

  <Accordion title="Separate by use case">
    Transactional and marketing on different numbers
  </Accordion>

  <Accordion title="Monitor health regularly">
    Check delivery rates weekly
  </Accordion>

  <Accordion title="Have backup numbers">
    Don't rely on a single number for critical sends
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Compliance" icon="shield" href="/concepts/compliance">
    Stay compliant
  </Card>

  <Card title="Sending Lists" icon="list" href="/guides/contacts/overview">
    Manage contacts
  </Card>
</CardGroup>