# Phone System App

![FlyNumber phone system app interface showing online status and number management](../phone-system-app/img/app_screenshot.jpeg)

The phone system app is the fastest way to start making and receiving calls with your FlyNumber. This guide will walk you through the initial setup process.

Prefer a video guide? Check out our [step-by-step tutorial for setting up the app](../video-guides/quick-app-video.md).


## Prerequisites {#prerequisites}

Before you begin, make sure you have:
- A FlyNumber account
- At least one active FlyNumber and the phone system enabled
- A valid email address for receiving the activation code

:::info Security Architecture
The phone system app uses WebSocket Secure (WSS) protocol for all communications:
- Provides a secure, encrypted channel for real-time voice and data
- Uses TLS encryption to protect all app traffic
- Ensures enterprise-grade security for communications
:::


## Step-by-Step Setup Guide {#step-by-step-setup-guide}

### 1. Open the Phone System {#1-open-the-phone-system}

1. Sign in to the panel at [panel.flynumber.com](https://panel.flynumber.com)
2. Open **[Phone System](https://panel.flynumber.com/phone-system)** from the sidebar
3. Click **Open Phone System** on the status card — the configuration interface opens in a new tab

![Phone System page in the FlyNumber panel showing the Active status card with the Open Phone System button on the right, a Connected Numbers list, and the Billing sidebar card](/img/phone-system-active.png)

### 2. Access Users Section {#2-access-users-section}

Navigate to the Users section:

![Main menu with Users section highlighted](/docs/phone-system-guide/example-configurations/img/click-users.jpg)

### 3. Create New User {#3-create-new-user}

Click the + button at the bottom right:

![Users interface showing the add new user button](/docs/phone-system-guide/example-configurations/img/click-plus-button.jpg)

Select "Create new" from the menu:

![New user creation menu options](/docs/phone-system-guide/example-configurations/img/click-create-new.jpg)

### 4. Enter User Details {#4-enter-user-details}

Fill in the required information:

![User creation form showing name fields](/docs/phone-system-guide/example-configurations/img/enter-name.jpg)

:::info[Required Fields]
- First name (required)
- Last name (required)
- Department (optional)
- Job title (optional)
:::

### 5. Configure Email {#5-configure-email}

Add your email address to receive the app activation code:

![Email configuration field in user setup](/docs/phone-system-guide/example-configurations/img/enter-email.jpg)

### 6. Enable App Configuration {#6-enable-app-configuration}

Make sure to enable the application configuration:

![Application configuration toggle switch](/docs/phone-system-guide/example-configurations/img/enable-application.jpg)

### 7. Configure Incoming Calls {#7-configure-incoming-calls}

Select which FlyNumber(s) will ring to your app — the field is labelled **DID numbers** and accepts more than one:

![FlyNumber selection dropdown for incoming calls](/docs/phone-system-guide/example-configurations/img/choose-flynumber.jpg)

### 8. Set Up Voicemail (Optional) {#8-set-up-voicemail-optional}

Under **When unavailable**, choose **Do nothing** (the call ends) or **Route to voicemail**:

![Voicemail configuration options](/docs/phone-system-guide/example-configurations/img/choose-voicemail.jpg)

### 9. Select Audio File {#9-select-audio-file}

Choose a greeting for your voicemail:

![Audio file selection for voicemail greeting](/docs/phone-system-guide/example-configurations/img/choose-audio-file.jpg)

### 10. Configure Outbound Calls {#10-configure-outbound-calls}

Turn on **Enable external outbound calls**, then pick the FlyNumber(s) the app can show as **Caller IDs**. You can also enter a **Caller ID name**:

![Outbound caller ID number selection](/docs/phone-system-guide/example-configurations/img/select-outbound-number.jpg)

### 11. Complete Setup {#11-complete-setup}

Click **Save and Invite** to finish — the invitation goes to the email address you entered:

![Save and Invite button location](/docs/phone-system-guide/example-configurations/img/click-save-invite.jpg)

### 12. Check Your Email {#12-check-your-email}

You'll receive an activation email containing:

![App activation email showing QR code and download links](/docs/phone-system-guide/example-configurations/img/activation-email.png)

:::tip[Email Contents]
- QR code for quick activation
- Download links for all platforms:
  - iOS
  - Android
  - Windows
  - macOS
- Manual activation code (if needed)

The invitation stays valid for the period set under Settings → App Activation Settings in the phone system panel. If it expires, resend it from the Users menu with Actions → Resend invite to app.
:::

## Notes {#notes}

After receiving your activation email:

1. Download the app for your device and tap **Sign in**
2. Scan the QR code, or tap **Enter code manually** and paste the activation code
3. On the Welcome screen tap **Continue**, then **Setup permissions**, and allow microphone and notifications
4. Check your name, job title and department, then tap **Save and continue**
5. Start making and receiving calls!

:::tip[Outbound Call Format]
When making calls, dial in full international format:
- Include country code and full number — a leading `+` or `00` also works; all three styles connect identically
- Don't dial in national format: drop any leading trunk `0` and add the country code
- Examples:
  - USA/Canada: 19176282411 (country code 1)
  - UK: 442036031157 (country code 44)
:::

:::warning[Important Permissions]
Make sure to allow:
- Microphone access for calls
- Notifications to receive incoming calls when the app is closed

On an iPhone, Focus mode can silence the app — turn Focus off or allow the app through in your Focus settings if calls aren't ringing. Permissions you declined can be changed later in your device's system settings.
:::

:::note[Need Help?]
If you don't receive the activation email:
- Check your spam folder
- Verify the email address on the user (Users → Actions → Edit) and resend the invite (Actions → Resend invite to app)
- Contact support if issues persist
:::