# phone.systems(TM) App Configuration

The phone.systems(TM) mobile application connects a user account to an application
line within the platform.

This configuration provides the user with a dedicated calling setup and
controls how inbound and outbound calls are routed, how caller ID is presented,
and whether calls are recorded.

---

**Configure User & Application Line**

Create or configure a user and assign an application line.

[Configure User and Application Line in phone.systems(TM)](#ps3-configure-app-device-user)

**Install & Activate the App**

Activate the mobile application and complete the user setup process.

[Install and Activate the phone.systems(TM) App](#ps3-setup-phone-systems-app)

---

## Configure User and Application Line in phone.systems(TM)

Before a user can make or receive calls through the phone.systems(TM)
application, their account must be connected to a user with enabled application line.
This setup links the user to a dedicated application line and ensures that
calls are routed and handled according to the assigned configuration.

Select one of the options below depending on whether you are setting up a new
user or configuring an existing one.

### Before You Begin

Before configuring phone.systems(TM) app, ensure the required calling components are available. These elements enable
inbound connectivity and voice routing for the user.

> - **A DID number** - Required to enable inbound calling functionality. If not available, .
> - **An assigned phone.systems(TM) trunk** - Needed to establish voice connectivity for the user. For setup steps, see [Configure DID Numbers with phone.systems(TM) in the DIDWW User Panel](../Getting-started/index.html#ps3-prerequisites).

*Configure App for New Users*

Each user must have a distinct profile and a dedicated application line (App Configuration Contact Method) to facilitate
call routing, identity assignment, and access to calling features within the phone.systems(TM) application. This ensures
accurate association of internal numbers, caller ID, and recording policies for both inbound and outbound
communications.

### Step 1: Create a New User

1. Go to the **Users** menu.
2. Click the **+** button.

   [![Add User](../../_images/fig40.png)](../../_images/fig40.png)


   **Fig. 1.** Add new user
3. Fill in the **User Details** in the Create User form:

   - **First name:** The user's name.
   - **Last name:** The user's surname.
   - **Department (optional):** The department the user belongs to.
   - **Job title (optional):** The user's job position.
   - **Time Schedule (optional):** The user's working hours. Read more in [Time Schedules Documentation](../Time-schedules/index.html#ps3-time-schedules).
   - **Email:** The user's email address for communication.
   [![User Details](../../_images/create_new_user.png)](../../_images/create_new_user.png)


   **Fig. 2.** User details form
4. Enable **Configure application line in the next step** and click **Next**.

   [![Configure Application Line](../../_images/fig4210.png)](../../_images/fig4210.png)


   **Fig. 3.** Enable application configuration


*Configure App for Existing Users*

Existing users may have App Configuration Contact Methods already created but not configured. Finalizing this setup
allows the user to place and receive calls through the phone.systems(TM) application.

### Step 1: Invite and Configure an Existing User

1. Go to the **Users** menu in the phone.systems(TM) dashboard.
2. In the Users tab, locate the user from the list.
3. Click the **Actions** button next to the user's name.
4. Select **Send Invite to App** or **Resend Invite to App**, depending on the user's current status.
5. Go to the **Contact Methods** menu and open the **App Configurations** tab.
6. Click the **Actions** button next to the contact method and select **Edit** to configure the application line.

Note

If the **Send Invite to App** button is inactive, ensure the user has a valid **email address** under their contact
information to enable this option.

[![Edit App Configuration](../../_images/fig0.png)](../../_images/fig0.png)


**Fig. 4.** Edit application configuration

### Step 2: Configure the App Configuration Contact Method

Set up how calls are handled for the user, then click **Save**.

Note

An invitation is sent automatically if the user has a valid email address.

The user can then activate the phone.systems(TM) application.

*Inbound Calls*

|  |  |
| --- | --- |
| **DID Numbers** | Select one or more DID numbers to receive inbound calls.  Note  If no DID numbers are available, refer to [Configure DID Number with phone.systems(TM)](../Getting-started/index.html#ps3-prerequisites) or [Add Third Party Phone Numbers](../Numbers/phone-numbers.html#ps3-add-3rd-party-phone-numbers). |
| **Internal Number** | Select one or more internal numbers to receive inbound calls.  Note  If no internal numbers are available, refer to [Create Internal Numbers Documentation](../Numbers/internal-numbers.html#ps3-create-internal-numbers). |
| **When Unavailable** | Specify the forwarding behavior when the destination is unavailable. |
| **Voicemail Audio** | Select the voicemail email when the **Route to Voicemail** option is selected for unavailable calls.  Note  To configure voicemail audio files, refer to [Audio Files Documentation](../Audio-files/index.html#ps3-audio-files). |


*Outbound Calls*

|  |  |
| --- | --- |
| **Enable External Outbound Calls** | Specifies whether the user can make external outbound calls. |
| **Caller IDs** | Specifies one or multiple caller IDs used for outbound calls.  Note  Caller ID options appear only if external outbound calls are enabled. |
| **Internal Caller ID** | Specifies the caller ID used for internal outbound calls.  Note  If no internal numbers are available, refer to [Create Internal Numbers Documentation](../Numbers/internal-numbers.html#ps3-create-internal-numbers). |
| **Internal Announcement** | Select the audio announcement message for internal calls.  Note  To upload announcement audio files, refer to [Audio Files Documentation](../Audio-files/index.html#ps3-audio-files). |
| **External Announcement** | Select the audio announcement message for external calls. |


*Call Recording*

|  |  |
| --- | --- |
| **Delivery Methods** | Specifies the delivery methods for call recordings.  Note  For setup instructions, refer to [Delivery Methods Documentation](../Delivery-methods/delivery-methods.html#ps3-delivery-methods). |
| **Inbound Internal** | Toggle to enable inbound internal call recording. |
| **Inbound External** | Toggle to enable inbound external call recording. |
| **Outbound Internal** | Toggle to enable outbound internal call recording. |
| **Outbound External** | Toggle to enable outbound external call recording. |
| **Record On Demand** | If enabled, users can initiate recording with a feature code.  Note  To configure on-demand recording, define a [feature code](../Settings/feature-codes.html#ps3-settings-feature-codes). |

---

## Install and Activate the phone.systems(TM) App

After a user account and their application line have been configured in
phone.systems(TM), the system automatically sends an invitation email to the
user's registered email address.
This email allows the user to install the phone.systems(TM) mobile application
and securely connect it to their assigned application line.

The invitation email includes:

- A download link for the application
- Activation details (QR code and authentication code)

The user should follow the instructions in the email to complete the setup on
their device.

Note

If the invitation email does not arrive, check the email spam or junk folder or
contact your administrator to resend it.

[![phone.systems invitation email](../../_images/activation_email.png)](../../_images/activation_email.png)


**Fig. 8.** Invitation email

### Step 1: Open the Application

To begin activation, open the phone.systems(TM) application on the user's device.
Install it first if it is not already installed.

Tap **Sign in** to begin activation.

[![Sign In Screen](../../_images/sign_in.png)](../../_images/sign_in.png)


**Fig. 9.** Sign-in screen

### Step 2: Activate the Application

Activate the application using one of the following methods provided in the invitation email.

When activating using a QR code, the application may request camera access to scan the code.

Note

When activating using a QR code, the application may request camera access to scan the code.

*Scan QR Code*

1. Allow camera access when prompted.
2. Scan the QR code from the invitation email.

[![QR code activation](../../_images/qr_scan.png)](../../_images/qr_scan.png)


**Fig. 10.** QR code activation


*Enter Code Manually*

If camera access is denied or unavailable, activate the application using the authentication code from the invitation
email.

1. Tap **Enter code manually** on the QR scanning screen.
2. Copy the authentication code from the invitation email.
3. Paste the code into the **Enter authentication code** field.
4. Tap **Continue** to proceed.

[![Camera permission denied screen](../../_images/manual_code.png)](../../_images/manual_code.png)


**Fig. 11.** Camera permission denied screen

[![Enter authentication code screen](../../_images/enter_code.png)](../../_images/enter_code.png)


**Fig. 12.** Enter authentication code screen

### Step 3: Grant Required Permissions

After activation, the **Welcome to phone.systems(TM)** screen is displayed. Tap
**Continue** to proceed.

On the next screen, tap **Setup permissions** to allow the required device
permissions for calling.

Allow the following permissions:

- **Microphone access** - Required to make and receive calls.
- **Push notifications** - Required to receive incoming call alerts and notifications.

Note

- If microphone or push notification permissions are denied, the application may not be able to place or receive calls properly. Permissions can be modified later in the device system settings.
- On **iPhone**, **Focus** mode may silence calls and notifications. If you are
  not receiving incoming call alerts, make sure Focus mode is disabled or
  that phone.systems(TM) is allowed in your Focus settings.

  See Apple's documentation:
  [Set up a Focus on iPhone](https://support.apple.com/guide/iphone/set-up-a-focus-iphd6288a67f/ios)
  and
  [Allow or silence notifications for a Focus](https://support.apple.com/guide/iphone/allow-or-silence-notifications-for-a-focus-iph21d43af5b/ios).

[![Welcome screen with Continue button](../../_images/continue.png)](../../_images/continue.png)


**Fig. 13.** Welcome screen

[![Setup permissions screen](../../_images/setup_permissions.png)](../../_images/setup_permissions.png)


**Fig. 14.** Permissions setup screen

### Step 4: Confirm Personal Information and Complete the Setup

After granting the required permissions, you will be prompted to review and confirm your profile information.

1. Enter or verify your profile details, such as your name, job title, and department.
2. Tap **Save and continue** to complete the setup.

The phone.systems(TM) application is now activated and ready to make and receive calls according to the assigned App
Configuration settings.

[![Personal Information](../../_images/personal_information.png)](../../_images/personal_information.png)


**Fig. 15.** Personal information

On this page
