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

# Phone Numbers

> Configure and manage phone numbers for your virtual assistants

<Frame>
  <img src="https://voicebot-cdn.s3.eu-central-1.amazonaws.com/dashboard/phone-numbers.png" alt="Phone Numbers Configuration" />
</Frame>

## Importing Phone Numbers

Import your Twilio phone numbers to enable voice capabilities for your assistants.

<Note>
  You'll need an active Twilio account with phone numbers to proceed. Make sure you have your Twilio credentials ready.
</Note>

### Import Configuration

<ParamField path="twilioNumber" type="tel" required>
  Your Twilio phone number with country code (e.g., +49...)
</ParamField>

<ParamField path="accountSid" type="string" required>
  Your Twilio Account SID starting with "AC"
  Example: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
</ParamField>

<ParamField path="authToken" type="password" required>
  Your Twilio Auth Token (kept secure and encrypted)
</ParamField>

<ParamField path="label" type="string" required>
  A descriptive label to identify this phone number
</ParamField>

## Phone Number Management

Each imported phone number can be configured for both inbound and outbound calls.

<Tabs>
  <Tab title="Inbound">
    <Frame>
      <img src="https://voicebot-cdn.s3.eu-central-1.amazonaws.com/dashboard/phone-numbers-inbound.png" alt="Inbound Call Configuration" />
    </Frame>

    ### Inbound Call Configuration

    <ParamField path="phoneNumber" type="string" label="Phone Number">
      Your active phone number (click to copy)
    </ParamField>

    <ParamField path="id" type="string" label="ID">
      Unique identifier for this phone number configuration
      Example: 22d4db66-7bba-4d9f-af2e-cbf5293d9616
    </ParamField>

    <ParamField path="displayName" type="string" label="Display Name">
      A friendly name for this phone number configuration
    </ParamField>

    <ParamField path="provider" type="string" label="Provider">
      Your telephony provider (e.g., Twilio)
    </ParamField>

    <ParamField path="created" type="string" label="Created">
      Creation date of this configuration
    </ParamField>

    ### Server Configuration

    <ParamField path="serverUrl" type="url" label="Server URL">
      Endpoint for receiving assistant configuration requests

      The platform sends an 'assistant-request' event to this URL to fetch assistant settings.
    </ParamField>

    <ParamField path="serverUrlSecret" type="password" label="Server URL Secret">
      Secret key for webhook authentication

      Used to verify incoming webhook requests from the platform.
    </ParamField>

    ### Call Routing

    <ParamField path="assistant" type="select" label="Assistant">
      Select the primary assistant for handling inbound calls
    </ParamField>

    <ParamField path="multiAgent" type="select" label="Multi Agent">
      Optional backup squad for handling calls when the primary assistant is unavailable
    </ParamField>

    <ParamField path="fallbackDestination" type="tel" label="Fallback Destination">
      Phone number for routing calls when neither assistant nor squad is available
    </ParamField>
  </Tab>

  <Tab title="Outbound">
    <Frame>
      <img src="https://voicebot-cdn.s3.eu-central-1.amazonaws.com/dashboard/phone-numbers-outbound.png" alt="Outbound Call Configuration" />
    </Frame>

    ### Outbound Call Configuration

    <ParamField path="outboundNumber" type="tel" required label="Outbound Phone Number">
      Phone number to use for making outbound calls
    </ParamField>

    <ParamField path="outboundAssistant" type="select" label="Assistant">
      Assistant to handle outbound call conversations
    </ParamField>

    <ParamField path="outboundMultiAgent" type="select" label="Multi Agent">
      Backup squad for outbound calls when the assistant is unavailable
    </ParamField>
  </Tab>
</Tabs>

<Note>
  You can add multiple phone numbers to your account, each with its own configuration for inbound and outbound calls.
</Note>
