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

# Number Management

> Import existing phone numbers from your telephony provider or purchase new numbers through Ringg dashboard

## Overview

Ringg provides flexible number management options for your telephony integration. You can either import existing phone numbers from your telephony provider or purchase new numbers directly through the Ringg dashboard.

## Number Management Options

<CardGroup cols={2}>
  <Card title="Import Numbers" icon="download" href="#importing-numbers">
    Import existing phone numbers from your Plivo, Exotel, or Twilio account
  </Card>

  <Card title="Purchase Numbers" icon="shopping-cart" href="#purchasing-numbers">
    Buy new phone numbers directly through Ringg's marketplace
  </Card>
</CardGroup>

## Importing Numbers

### Setting Up Your Telephony Provider

Before importing numbers, you need to connect your telephony provider account to Ringg.

### Import Numbers from Provider

Once your provider is connected, you can import your existing numbers:

<Steps>
  <Step title="Go to Numbers Section">
    Navigate to **Numbers** → **Import Numbers** in your Ringg dashboard
  </Step>

  <Step title="Select Provider Account">
    Choose the telephony provider account you want to import numbers from

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/number_dashboard.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=c888a641b85623f1db8a69b0d2309c60" alt="Number Dashboard" width="1921" height="875" data-path="images/number_dashboard.png" />
  </Step>

  <Step title="Select Numbers to Import">
    Choose which numbers you want to import (you can select all or specific numbers)

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/import_numbers.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=dab1c10ecdc5aa1690e838fab8c21e14" alt="Import Numbers" width="1924" height="875" data-path="images/import_numbers.png" />
  </Step>

  <Step title="Import Numbers">
    Click **"Import Selected Numbers"** to complete the import process

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/number_dashboard.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=c888a641b85623f1db8a69b0d2309c60" alt="Number Dashboard" width="1921" height="875" data-path="images/number_dashboard.png" />
  </Step>
</Steps>

## Purchasing Numbers

Ringg's marketplace allows you to purchase new phone numbers from multiple providers with competitive pricing and instant setup.

### Search and Purchase Numbers

<Steps>
  <Step title="Go to Numbers Section">
    Navigate to **Numbers** → **Import Numbers** in your Ringg dashboard
  </Step>

  <Step title="Select Provider Account">
    Choose the telephony provider account you want to import numbers from

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/number_dashboard.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=c888a641b85623f1db8a69b0d2309c60" alt="Number Dashboard" width="1921" height="875" data-path="images/number_dashboard.png" />
  </Step>

  <Step title="Buy Number">
    View available numbers with pricing from different providers

    <img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/buy_numbers.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=a3a055ffd7403a24b5eba8fea3381aa4" alt="Number Dashboard" width="1921" height="883" data-path="images/buy_numbers.png" />
  </Step>

  <Step title="Use Numbers">
    Use the number
  </Step>
</Steps>

<img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/number_dashboard.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=c888a641b85623f1db8a69b0d2309c60" alt="Exotel Dashboard" width="1921" height="875" data-path="images/number_dashboard.png" />

### Attach the number in an inbound agent

#### Release Numbers

When you no longer need a number, you can release it through the dashboard:

<Steps>
  <Step title="Select the telephony ">
    Go to your numbers list and click on the number you want to release
  </Step>

  <Step title="Choose the number">
    Select whether to release from Ringg only or also from the telephony provider
  </Step>
</Steps>

<img src="https://mintcdn.com/ringgai-0da73d20/NBLu_wbRuI7Dt5RA/images/attach_inbound_number.png?fit=max&auto=format&n=NBLu_wbRuI7Dt5RA&q=85&s=eeb6571d8db45f63876763fd645b1c72" alt="Release Number Dialog" width="1926" height="940" data-path="images/attach_inbound_number.png" />

## Number Analytics

### Usage Statistics and Insights

Monitor your number performance with comprehensive analytics:

#### Analytics Features

<CardGroup cols={2}>
  <Card title="Call Volume Metrics" icon="phone">
    Track inbound/outbound call counts and trends over time
  </Card>

  <Card title="Duration Analysis" icon="clock">
    Monitor average call duration and total talk time
  </Card>

  <Card title="Cost Tracking" icon="dollar-sign">
    View per-number costs and ROI analysis
  </Card>

  <Card title="Success Rates" icon="chart-line">
    Monitor call completion rates and quality metrics
  </Card>
</CardGroup>

## Best Practices

<AccordionGroup>
  <Accordion title="Number Management">
    * Regularly audit your numbers and release unused ones
    * Use descriptive names for imported numbers
    * Monitor usage to optimize costs
    * Keep provider credentials secure when importing
  </Accordion>

  <Accordion title="Cost Optimization">
    * Compare pricing between providers when purchasing
    * Consider regional numbers for better rates
    * Release numbers during low-usage periods
    * Use Ringg's marketplace for competitive pricing
  </Accordion>

  <Accordion title="Security">
    * Validate all number operations
    * Use proper authentication for provider APIs
    * Monitor for unauthorized number changes
    * Implement proper access controls
  </Accordion>
</AccordionGroup>

## Troubleshooting

### Common Issues

<AccordionGroup>
  <Accordion title="Import failures">
    * Verify provider API credentials are correct
    * Check if numbers are already imported
    * Ensure sufficient permissions in provider account
  </Accordion>

  <Accordion title="Purchase failures">
    * Verify sufficient credits in Ringg account
    * Check if number is still available
    * Ensure proper country/region selection
  </Accordion>

  <Accordion title="Configuration issues">
    * Verify assistant ID exists
    * Check webhook URL accessibility
    * Ensure proper number status (active)
  </Accordion>
</AccordionGroup>

## Next Steps

* [Configure webhooks for your numbers](/webhooks/initial-setup)