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

# Phone Numbers

> Manage your phone numbers for inbound and outbound calling

## Overview

Phone numbers on Callkaro allow you to make and receive AI-powered calls. Each phone number can be configured with:

* **Outbound Agents** - Agents that can make calls from this number
* **Inbound Agent** - Agent that handles incoming calls to this number

<Tip>
  New to Callkaro? Learn how to [purchase phone numbers](/phone-numbers/buy-phone-number) to get started.
</Tip>

***

## Key Features

### Spam Management

Mark phone numbers as spam if they get flagged or face delivery issues:

**Purpose:**

* Prevent further issues with problematic numbers
* Track which numbers have been marked as spam
* Easy spammed/unmark toggles

**How It Works:**

* Click **"Mark Spam"** button on any active phone number
* Number status changes to **Spammed** with timestamp
* Click **"Unmark Spam"** to restore normal status
* Spam status is tracked with date for your records

<Warning>
  Marking a number as spam doesn't automatically stop billing. You must unrent the number to stop charges.
</Warning>

***

### Unrenting Phone Numbers

When you no longer need a phone number, you can unrent it to stop billing:

**What Happens:**

1. Number is marked as **Unrented** with timestamp
2. Billing stops from the **next billing cycle**
3. Inbound and outbound agent associations are removed
4. Number cannot be recovered after unrenting

**Important:**

* Billing continues until the next billing date
* Example: If your next billing is March 15th and you unrent on March 10th, you'll be charged one more time on March 15th, then billing stops
* Unrented numbers show "Stopped" status in Next Billing Date column

<Tip>
  Check your "Next Billing Date" before unrenting to understand when charges will stop.
</Tip>

***

## Billing Policy

### Billing Cycle

Phone numbers are billed on a **monthly recurring basis**:

**How It Works:**

* **Purchase Date** - The day you purchase becomes your billing day
* **Next Billing Date** - Same day next month
* **Example:** Purchase on January 15th → Next billing on February 15th, March 15th, etc.

**Edge Cases:**

* If purchased on the 31st, next billing is on the last day of shorter months
* Example: Purchase on January 31st → February 28th (or 29th), March 31st, April 30th, etc.

***

### Billing When Unrenting

**Billing stops from the next cycle after unrenting:**

````carousel theme={null}
**Scenario 1: Unrent Before Billing Date**

```
Purchase Date: January 15, 2024
Current Date: February 10, 2024
Next Billing: February 15, 2024

Action: Unrent on February 10, 2024

Result:
✓ Charged on February 15, 2024 (one more cycle)
✗ No charge on March 15, 2024 (billing stopped)
```

<!-- slide -->

**Scenario 2: Unrent After Billing Date**

```
Purchase Date: January 15, 2024
Current Date: February 20, 2024  
Next Billing: March 15, 2024

Action: Unrent on February 20, 2024

Result:
✓ Charged on March 15, 2024 (one more cycle)
✗ No charge on April 15, 2024 (billing stopped)
```

<!-- slide -->

**Scenario 3: Same-Day Unrent**

```
Purchase Date: January 15, 2024
Current Date: February 15, 2024 (Billing Day)
Next Billing: March 15, 2024

Action: Unrent on February 15, 2024 (after charge)

Result:
✓ Charged on February 15, 2024 (today)
✓ Charged on March 15, 2024 (one more cycle)
✗ No charge on April 15, 2024 (billing stopped)
```
````

<Info>
  **Pro Tip:** To minimize charges, unrent immediately after a billing date passes rather than right before one.
</Info>

***

### Refund Policy

**No refunds are provided for:**

* Partial months after unrenting
* Spam-marked numbers
* Unused calling minutes on the number

**Example:**

```
If you unrent on March 10th but next billing is March 15th:
- You'll be charged on March 15th for the full month
- No refund for the unused days (March 15-31)
```

***

## Phone Number Management

### Active Numbers

**Features:**

* View phone number with country code
* See purchase date and next billing date
* Configure outbound and inbound agents
* Mark/unmark as spam
* Unrent when no longer needed

### Unrented Numbers

**What You See:**

* Number marked as **Unrented** with date
* **"Stopped"** status in Next Billing Date
* No action buttons (cannot be recovered)
* Kept in records for reference

***

## Use Cases

### Outbound Calling

**Setup:**

1. Purchase a phone number
2. Assign outbound agents to the number
3. Agents can now make calls from this number

**Example:**

```
Phone Number: +919876543210
Outbound Agents:
- Sales Agent (for product demos)
- Follow-up Agent (for customer retention)
- Survey Agent (for feedback collection)
```

***

### Inbound Calling

**Setup:**

1. Purchase a phone number
2. Assign an inbound agent to the number
3. Agent handles all incoming calls to this number

**Example:**

```
Phone Number: +919876543210
Inbound Agent: Customer Support Agent

Result: All calls to +919876543210 are handled by Customer Support Agent
```

***

### Multi-Agent Outbound

Use one number for different outbound campaigns:

```
Phone Number: +919876543210

Outbound Agents:
1. Morning Sales Agent (9 AM - 12 PM campaigns)
2. Afternoon Follow-up Agent (2 PM - 5 PM campaigns)  
3. Evening Reminder Agent (6 PM - 8 PM campaigns)
```

***

## Best Practices

<AccordionGroup>
  <Accordion title="Monitor Spam Status" icon="shield-check">
    Regularly check if numbers are getting flagged

    **Actions:**

    * If spam issues arise, mark number as spam
    * Consider purchasing a replacement number
    * Unrent the spam number to stop billing
  </Accordion>

  <Accordion title="Plan Unrenting Around Billing" icon="calendar-dollar">
    Minimize costs by timing your unrenting

    **Best Practice:**

    * Check "Next Billing Date" before unrenting
    * If billing is in 2 days, consider waiting until after
    * Unrent immediately after billing date for minimal charges

    **Example:**

    ```
    Next Billing: March 15th
    Current Date: March 13th

    Better: Wait until March 16th to unrent
    Why: Avoid paying for unused March 15-31 period
    ```
  </Accordion>

  <Accordion title="Organize by Purpose" icon="folder-tree">
    Use clear naming for agents assigned to numbers

    **Good:**

    ```
    Phone 1: +9198765xxxxx
    - Sales Demo Agent
    - Product Inquiry Agent

    Phone 2: +9198765yyyyy  
    - Customer Support Agent (Inbound)
    ```

    **Better:**

    ```
    Sales Line: +9198765xxxxx
    - [Outbound] Sales Demo
    - [Outbound] Product Inquiry

    Support Line: +9198765yyyyy
    - [Inbound] 24/7 Support
    ```
  </Accordion>

  <Accordion title="Keep Records of Unrented Numbers" icon="clock-rotate-left">
    Track why numbers were unrented

    **Useful Data:**

    * Spam issues
    * Low performance
    * Campaign ended
    * Cost optimization

    This helps in future phone number purchasing decisions.
  </Accordion>
</AccordionGroup>

***

## Troubleshooting

<AccordionGroup>
  <Accordion title="Cannot purchase phone numbers" icon="ban">
    **Issue:** "Business Verification Required" message appears

    **Solution:**

    1. Go to Settings → Compliances
    2. Upload GST certificate
    3. Upload CIN certificate
    4. Wait for verification approval
    5. Try purchasing again
  </Accordion>

  <Accordion title="Phone number marked as spam" icon="triangle-exclamation">
    **Issue:** Number is flagged or has delivery issues

    **Solutions:**

    1. Mark number as spam in dashboard
    2. Purchase a new phone number
    3. Unrent the spam number to stop billing
    4. Update agents to use new number
  </Accordion>

  <Accordion title="Charged after unrenting" icon="dollar-sign">
    **Issue:** Still charged after clicking "Unrent"

    **Explanation:** This is expected behavior

    **Why:**

    * Billing stops from NEXT cycle
    * You'll see one more charge
    * Check "Next Billing Date" before unrenting

    **Example:**

    ```
    Unrent Date: March 10
    Next Billing: March 15

    You will be charged on March 15 (final charge)
    No charge on April 15 (billing stopped)
    ```
  </Accordion>

  <Accordion title="Cannot assign agent to number" icon="user-xmark">
    **Possible Causes:**

    * Number has been unrented
    * Agent doesn't have proper permissions
    * Agent is archived or deleted

    **Solutions:**

    1. Verify number is active (not unrented)
    2. Check agent status
    3. Ensure agent is published
    4. Contact support if issue persists
  </Accordion>
</AccordionGroup>

***

## Getting Help

<CardGroup cols={2}>
  <Card title="Purchase Numbers" icon="cart-shopping" href="/phone-numbers/buy-phone-number">
    Learn how to purchase and configure phone numbers
  </Card>

  <Card title="Contact Support" icon="headset">
    Get help with billing, spam issues, or technical problems
  </Card>
</CardGroup>