Import a Phone Number

​

Overview

Before you can start making and receiving calls, you need to import phone numbers into Freya. Freya supports importing phone numbers from various providers, with Twilio being the primary supported provider.

​

Prerequisites

Before importing a phone number, you need:

1. A Twilio Account - Sign up at twilio.com if you don’t have one
2. Twilio Phone Number - Purchase or have a phone number in your Twilio account
3. Twilio Integration Connected - Connect your Twilio account in Freya’s integrations page

​

Connecting Twilio Integration

Before you can import phone numbers, you must connect your Twilio account:

​

Step 1: Navigate to Integrations

1. Click on “Integrations” in the sidebar navigation
2. Find the Twilio integration card

​

Step 2: Connect Twilio

1. Click “Connect” on the Twilio integration
2. Enter your Twilio credentials:
   • Account SID - Found in your Twilio console
   • Auth Token - Found in your Twilio console
3. Click “Save” to connect

​

Importing a Phone Number

​

Step 1: Navigate to Phone Numbers

1. Click on “Phone Numbers” in the sidebar navigation
2. You’ll see a list of all imported phone numbers

​

Step 2: Start Import Process

1. Click the “Import” button in the top right
2. A modal will open showing available providers

​

Step 3: Select Provider

If Twilio is connected, you’ll see:

• Twilio - Available (if connected)
• Other providers - May show as “Not Connected”

Click on Twilio to proceed.

​

Step 4: Enter Phone Number

1. Enter the phone number you want to import
2. Use the phone input field with country code selection
3. Or use raw input mode for custom formats
4. Click “Import”

​

Step 5: Verify Import

After clicking import:

1. Freya will fetch the phone number details from Twilio
2. The number will be added to your workspace
3. You’ll see a success notification
4. The phone number will appear in your phone numbers list

​

Imported Phone Number Details

After importing, the phone number will have:

• Phone Number - The actual number (e.g., +1234567890)
• Friendly Name - A display name for the number
• Capabilities - Voice, SMS, MMS, etc.
• Status - Active, pending, etc.
• Provider - Twilio or other provider

​

Phone Number Configuration

After importing, you’ll need to:

1. Configure the number - Set up inbound and outbound routing
2. Connect to agents/workflows - Link the number to your AI agents or workflows
3. Set capabilities - Enable voice, SMS, etc.

Connect a Phone Number

Learn how to connect your imported phone number to agents or workflows.

​

Troubleshooting

​

Twilio Not Connected

If you see “Twilio Not Connected”:

1. Navigate to Integrations
2. Connect your Twilio account
3. Verify your credentials are correct
4. Try importing again

​

Phone Number Not Found

If the import fails with “Phone number not found”:

1. Verify the number exists in your Twilio account
2. Check that you’re using the correct format (with country code)
3. Ensure the number is active in Twilio
4. Try using raw input mode with the exact Twilio format

​

Import Errors

If you encounter errors:

1. Check your Twilio account has sufficient credits
2. Verify your Twilio credentials are still valid
3. Check that the phone number hasn’t been deleted in Twilio
4. Contact support if issues persist

​

Best Practices

​

Next Steps

Connect a Phone Number

After importing, learn how to connect your phone number to agents or workflows.