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

# Import Twilio Phone Numbers into VoiceInfra in One Click

> Connect your Twilio account to VoiceInfra and import existing phone numbers in one click. No number porting, no billing changes, no downtime.

The VoiceInfra Twilio integration lets you route calls on your existing Twilio phone numbers to AI agents — without porting a single number away from Twilio. Your numbers stay in your Twilio account, Twilio continues to handle the telephony infrastructure, and VoiceInfra adds the AI conversation layer on top. Your customers keep calling the same numbers they always have.

<Note>
  Your numbers remain in your Twilio account throughout. Twilio continues to handle telephony and billing. VoiceInfra does not move, port, or take ownership of your numbers.
</Note>

## Prerequisites

Before connecting, locate the following credentials in your [Twilio Console](https://console.twilio.com):

* **Account SID** — starts with `AC`, exactly 34 characters
* **Auth Token** — 32-character token shown on your Twilio Console dashboard

```text theme={null}
Account SID: ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx  (34 chars, starts with AC)
Auth Token:  xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx    (32 chars)
```

Keep your Auth Token private. VoiceInfra encrypts it at rest and uses it only to fetch your number list via the Twilio API.

## Import Your Twilio Numbers

<Steps>
  <Step title="Open the Twilio import screen">
    In the VoiceInfra dashboard, go to **Settings → Phone Numbers → Connect Twilio**.
  </Step>

  <Step title="Enter your Twilio Account SID and Auth Token">
    Paste your Account SID and Auth Token into the form. VoiceInfra encrypts these credentials immediately. They are never stored in plain text, exposed in logs, or used to access your Twilio billing or account settings.
  </Step>

  <Step title="Browse your available numbers">
    After connecting, your Twilio numbers appear in a list showing the country code, full number, and friendly name. Review the list to confirm your numbers are present.
  </Step>

  <Step title="Select and import">
    Check the numbers you want to bring into VoiceInfra — one, several, or all of them. Click **Import**. Selected numbers are instantly available in your VoiceInfra dashboard.
  </Step>

  <Step title="Assign to an AI agent">
    For each imported number, choose the AI agent that handles calls on that number. You can assign different agents to different numbers and configure separate agents for inbound versus outbound calls.
  </Step>
</Steps>

## Re-Importing Numbers

If you add new numbers to your Twilio account after the initial import, return to **Settings → Phone Numbers → Connect Twilio** and run the import again. VoiceInfra re-fetches your current Twilio number list and makes any new numbers available for selection.

## Removing an Imported Number

You can unlink any imported number from VoiceInfra at any time through the phone numbers settings page. Removing a number from VoiceInfra does not affect the number in your Twilio account — it continues to exist there with all its existing configuration.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Will my Twilio billing change?">
    No. You continue to pay Twilio's standard rates for number rental and call usage. VoiceInfra charges separately for AI usage. There are no additional telephony fees from VoiceInfra.
  </Accordion>

  <Accordion title="Can I use Twilio Studio alongside VoiceInfra?">
    Yes. VoiceInfra can act as a component inside your Twilio Studio flows. AI agents handle conversations and can return results that continue your Studio flow logic.
  </Accordion>

  <Accordion title="Does this work with Twilio Flex?">
    Yes. VoiceInfra integrates with Twilio Flex. Human agents working in the Flex agent desktop see the AI conversation context when a call is transferred, so they can pick up without asking the customer to repeat themselves.
  </Accordion>

  <Accordion title="What happens if I remove my Twilio credentials from VoiceInfra?">
    Removing your credentials unlinks all imported numbers from VoiceInfra. Your Twilio account and numbers are completely unaffected — they continue working as normal in Twilio.
  </Accordion>

  <Accordion title="Can I import numbers from multiple Twilio accounts?">
    Yes. Repeat the connection process with a different Account SID and Auth Token to import numbers from an additional Twilio account.
  </Accordion>

  <Accordion title="Do imported numbers support international formats?">
    Yes. Any Twilio number — US, UK, AU, EU, or any other country — appears in the import list with its country code (e.g., +1, +44, +61) and full number.
  </Accordion>
</AccordionGroup>