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

# Phone Lines

> Purchase, configure, and manage your calling phone numbers

<img src="https://mintcdn.com/eolasflow/R2RGWual81fpwxtz/images/guides/phone-lines.png?fit=max&auto=format&n=R2RGWual81fpwxtz&q=85&s=1db7726c42b2f5d504e264df8cd984bd" alt="Phone Lines page for managing phone numbers" width="1919" height="992" data-path="images/guides/phone-lines.png" />

Phone Lines are the numbers your AI assistants use for calls — both as outbound caller ID and for receiving inbound calls. EolasFlow makes it easy to purchase and manage numbers from around the world via Twilio.

## Phone Line Overview

Your Phone Lines page shows:

* **Number** — The phone number
* **Country** — Where the number is registered
* **Type** — Local, Mobile, or Toll-Free
* **Status** — Active, Pending, or Inactive
* **Monthly Cost** — Recurring charge

## Purchasing a Phone Line

<Steps>
  <Step title="Navigate to Phone Lines">
    Go to **Phone Lines** in the Organization section and click **Browse & Buy**.
  </Step>

  <Step title="Select Country">
    Choose the country where you want a number. Numbers are available in 40+ countries.
  </Step>

  <Step title="Search by Area Code">
    Optionally enter an area code to find numbers in a specific region.
  </Step>

  <Step title="Choose a Number">
    Browse available numbers and click **Buy**.
  </Step>

  <Step title="Confirm">
    Review the monthly cost and confirm. The number is available immediately.
  </Step>
</Steps>

<Tip>
  **Local Presence:** Choose numbers with local area codes in your target market. People are more likely to answer calls from familiar area codes.
</Tip>

## Number Types

| Type          | Best For         | Features                             |
| ------------- | ---------------- | ------------------------------------ |
| **Local**     | Regional calling | Familiar area code, lower cost       |
| **Mobile**    | SMS + Voice      | Can send and receive text messages   |
| **Toll-Free** | National reach   | Free for callers, professional image |

## Managing Phone Lines

### My Numbers

Click the **My Numbers** tab to see all your purchased numbers.

### Release a Number

If you no longer need a number:

1. Find the number in your list
2. Click **Release**
3. Confirm

<Warning>
  Releasing a number is permanent. You may not be able to get the same number back.
</Warning>

## Using Numbers in VoiceFlows

When creating a VoiceFlow, select which phone line to use:

1. Go to **VoiceFlows** and create or edit a VoiceFlow
2. In the **Phone Line** dropdown, select from your purchased numbers
3. This number will be the caller ID for all outbound calls and the receiving line for inbound

<Note>
  Each VoiceFlow uses one phone line. Create separate VoiceFlows if you need different caller IDs.
</Note>

## Importing Existing Numbers

Already have phone numbers with Twilio or WhatsApp Business? Import them into EolasFlow instead of purchasing new ones. Click the **Import Number** tab on the Phone Lines page.

EolasFlow supports importing from multiple providers:

| Provider       | Status      | Use Case                                          |
| -------------- | ----------- | ------------------------------------------------- |
| **Twilio**     | Available   | Import existing Twilio numbers for voice + SMS    |
| **WhatsApp**   | Available   | Connect WhatsApp Business numbers for voice calls |
| **Telnyx**     | Coming Soon | —                                                 |
| **SignalWire** | Coming Soon | —                                                 |
| **Vonage**     | Coming Soon | —                                                 |
| **Bandwidth**  | Coming Soon | —                                                 |

### Import from Twilio

<Steps>
  <Step title="Click Import Number">
    Go to **Phone Lines** and click the **Import Number** tab, then select **Twilio**.
  </Step>

  <Step title="Enter Phone Number">
    Enter the number in E.164 format (e.g., `+14156021922`).
  </Step>

  <Step title="Enter Account SID">
    Your Twilio Account SID, found on your Twilio dashboard.
  </Step>

  <Step title="Choose Authentication Method">
    * **Auth Token** — Quick setup. Copy from your Twilio dashboard.
    * **API Key** — More secure. Revocable and scoped. Recommended for production.
  </Step>

  <Step title="Enter Credentials">
    Paste your Auth Token or API Key + Secret.
  </Step>

  <Step title="Optional Settings">
    * **Label** — A friendly name for this number (e.g., "Sales Line")
    * **Enable SMS** — Toggle on if you want SMS messaging on this number
  </Step>

  <Step title="Validate & Import">
    Click **Validate & Import**. EolasFlow verifies the number and automatically configures webhooks to route calls through the platform.
  </Step>
</Steps>

<img src="https://mintcdn.com/eolasflow/R2RGWual81fpwxtz/images/guides/phone-import-twilio.png?fit=max&auto=format&n=R2RGWual81fpwxtz&q=85&s=6837fd77828f6f07402f36f43691d360" alt="Import Number — Twilio provider form" width="1919" height="992" data-path="images/guides/phone-import-twilio.png" />

<Note>
  Webhooks are automatically configured on your Twilio number to route calls through EolasFlow. Your credentials are stored securely server-side and never exposed to the browser. You can disconnect the number at any time to restore original webhooks.
</Note>

### Import from WhatsApp Business

<Steps>
  <Step title="Click Import Number">
    Go to **Phone Lines** → **Import Number** → select **WhatsApp**.
  </Step>

  <Step title="Enter Phone Number">
    Your WhatsApp Business phone number in E.164 format.
  </Step>

  <Step title="Enter Phone Number ID">
    The Phone Number ID from your Meta Business Manager / WhatsApp Cloud API dashboard.
  </Step>

  <Step title="Enter Permanent Access Token">
    A permanent access token from Meta for API access to this number.
  </Step>

  <Step title="Optional Label">
    Add a friendly name for this number.
  </Step>

  <Step title="Connect">
    Click **Connect WhatsApp Number**. EolasFlow registers the webhook to receive WhatsApp calls and messages on this number.
  </Step>
</Steps>

<img src="https://mintcdn.com/eolasflow/R2RGWual81fpwxtz/images/guides/phone-import-whatsapp.png?fit=max&auto=format&n=R2RGWual81fpwxtz&q=85&s=2a228b1280f58a1df0f600dd9a162547" alt="Import Number — WhatsApp Business provider form" width="1919" height="992" data-path="images/guides/phone-import-whatsapp.png" />

<Tip>
  After importing a WhatsApp number, you can enable **WhatsApp Messaging** on a VoiceFlow to handle both voice calls and text conversations on the same number. See [WhatsApp Messaging](/guides/whatsapp).
</Tip>

## Transfer Contacts

Transfer contacts are the people and departments your AI can transfer calls to. When the Transfer tool is active on a VoiceFlow, the AI uses this list to route calls to the right person.

Click the **Transfer Contacts** tab on the Phone Lines page to manage your transfer destinations.

<img src="https://mintcdn.com/eolasflow/R2RGWual81fpwxtz/images/guides/transfer-contacts.png?fit=max&auto=format&n=R2RGWual81fpwxtz&q=85&s=cb2f479dd167d2a5acebbacd4d755d6c" alt="Transfer Contacts — add names and numbers for call transfer destinations" width="1919" height="992" data-path="images/guides/transfer-contacts.png" />

### Adding a Transfer Contact

<Steps>
  <Step title="Go to Transfer Contacts">
    Navigate to **Phone Lines** and click the **Transfer Contacts** tab.
  </Step>

  <Step title="Enter Details">
    Fill in the contact information:

    * **Name** — A descriptive label (e.g., "Billing Department", "Manager John", "Dr. Smith")
    * **Phone Number** — The number to transfer to (E.164 format)
    * **Email** — Optional email address for the contact
  </Step>

  <Step title="Click Add Contact">
    The contact is saved and immediately available in the Transfer tool dropdown in VoiceFlow Studio.
  </Step>
</Steps>

When the AI needs to transfer a call, it selects from this list. The contact name helps the AI match caller requests — for example, if a caller says "I need to speak to billing," the AI matches that to a transfer contact named "Billing Department."

<Tip>
  Use clear, descriptive names for transfer contacts. Names like "Billing", "Sales Manager", or "Dr. Smith — Dermatology" help the AI route transfers accurately.
</Tip>

## Best Practices

<Tip>
  **Start with One Number:** Begin with a single number to test, then add more as you scale.
</Tip>

<Tip>
  **Match Your Market:** Use local numbers where your contacts are located.
</Tip>

<Tip>
  **Keep Numbers Active:** Numbers build reputation over time. Avoid frequently switching.
</Tip>

## Next Steps

<CardGroup cols={2}>
  <Card title="Create a VoiceFlow" icon="sparkles" href="/guides/voiceflows">
    Use your phone line in a VoiceFlow
  </Card>

  <Card title="Softphone" icon="phone" href="/guides/softphone">
    Make test calls from your browser
  </Card>
</CardGroup>
