<!-- Source: https://docs.vinsi.ai/telephony/deskPhones -->
# Desk Phones

Set up Fanvil desk phones on VINSI, keep them configured automatically, and use extensions, busy lamps, voicemail, and paging.

Created: September 16, 2026

Updated: September 16, 2026

## Overview

A desk phone registers to the VINSI phone server (`pbx.vinsi.ai`) with its own credentials and shares its member's phone number and extension — so it can ring together with their [softphone](https://docs.vinsi.ai/telephony/softphone). Desk phones are added and managed by administrators in **CRM → Admin → Phone Settings → Member Phones**.

### Supported Phones

**Fanvil** IP phones, including the V62, V62G, V63, V63G, V64, V65, V66, V67, V67G, V68, X3 series (X3, X3G, X3S, X3SP, X3U, X3UPro), X6U, X7A, X7C, X7C-V2, X210, and X210i. Other SIP phones may work with manual setup but aren't auto-configured.

## Add a Desk Phone

1. Go to **Phone Settings → Member Phones** and click **\+ Add Phone** at the bottom (or **\+ Add** in the member's row).
2. Select the **Member**.
3. Pick the **Phone Number** (required for a desk phone) and enter an **Extension**.
4. Choose the **Model**, or _I don't know / auto-detect_ — the model and MAC address are detected when the phone first checks in.
5. Click **Add**.

To give a member a second desk phone, expand their row and click **\+ Add another phone**.

### Save the Credentials

The **Desk Phone Provisioned** window shows the SIP address, user ID, **password**, and server. The password is shown **only once** — use **Copy All** or **Download Phone Config** before clicking **I saved the credentials**.

| Setting              | Value        |
| -------------------- | ------------ |
| Server / Registrar   | pbx.vinsi.ai |
| Port                 | 5060         |
| Transport            | UDP          |
| Registration expires | 180          |

## Connect the Phone

Plug the phone into your network, find its IP address (on the phone's status screen), and open that address in a browser to reach the phone's web admin page.

### Auto-Provisioning (Recommended)

Set this up once and the phone keeps itself up to date with everything you change in VINSI:

1. In the phone's web admin, open the static provisioning settings.
2. Enter the **Server Address** and **Configuration File Name** shown in the Provisioned window (also under Edit Phone → **Status**).
3. Set **Protocol** to HTTPS, **Update Mode** to _Update at time interval_, and the interval to 1 hour.
4. Click **Apply**, then **Auto Provision Now**.

The phone registers, loads its busy-lamp keys, company directory (_VINSI Directory_), voicemail key, and time settings, and checks for changes every hour. Use **Push Now** in Edit Phone to apply changes immediately.

### Import a Config File

Alternatively, click **Download Phone Config** (or **Download Config** in Edit Phone) and import the `.txt` file on the phone under **System → Configurations → Import Configurations**. Imported files don't update automatically — re-import after changes, or set up auto-provisioning.

Custom wallpaper and boot logo are uploaded once on the phone itself (Phone Settings → Background and Boot Logo).

## Edit Phone

Click **Edit Phone** in the member's row. Tabs:

| Tab               | Settings                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Basics**        | Label, extension, display name (caller ID name), phone number, **Forward all calls to**, ringtone, SIP transport, notes. |
| **Numbers**       | Shared line and additional lines.                                                                                        |
| **Function Keys** | Order and visibility of coworker busy-lamp keys, key label size.                                                         |
| **Voicemail**     | Send unanswered calls to voicemail, ring seconds before voicemail, email CC recipients.                                  |
| **Date & Time**   | Time zone and daylight saving.                                                                                           |
| **Status**        | Last check-in, IP and MAC, provisioning details, firmware upgrade, web admin password.                                   |
| **Advanced SIP**  | Keepalive and registration options — leave the defaults unless support asks you to change them.                          |

### Shared Lines & Extra Numbers

- **Shared line** — turn on _Shared line (ring on multiple phones)_ to use the same line on up to 5 phones (e.g. a front desk with several handsets).
- **Add another line** — up to 5 extra lines per phone: another phone number, an internal extension only, or an existing shared line.

### Busy-Lamp Keys

Every coworker with an extension appears on the phone's side keys automatically. The light turns on when they're on a call; press the key to call them. In **Function Keys**, use **Move up** / **Move down** to reorder and **Hide from phone** to remove someone, then **Save function keys**.

### Status, Push & Reboot

- **Push Now** — tells the phone to fetch its configuration right away.
- **Reboot Now** — restarts the phone (active calls drop).
- **Upgrade Now** — appears on the Status tab when newer firmware is available.
- **Rotate Password** — changes the phone's web admin password; do this if it still uses the factory default.

To remove a phone, click the trash icon (_Deprovision desk phone_) in the member's row.

## Using a Desk Phone

- **Outside calls** — dial the 10-digit number, 1 + number, or +country code number.
- **Coworkers** — dial their extension, press their busy-lamp key, or pick them from _VINSI Directory_.
- **Voicemail** — the message light turns on when you have new voicemail; press the **Message** key to listen.
- Calls are recorded and appear in **Call Logs & Recordings**.

### Feature Codes

| Dial  | What it does                                                                                                                                                                 |
| ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| \*97  | Play your voicemail (same as the Message key) — press 7 to delete a message. See [Play & Delete Voicemail](https://docs.vinsi.ai/telephony/deskPhones#deskPhones-voicemail). |
| \*724 | Page — make an announcement through every desk phone's speaker (administrators only).                                                                                        |
| \*45  | Call queues: log in / log out.                                                                                                                                               |
| \*46  | Call queues: Unavailable / Available.                                                                                                                                        |
| \*47  | Call queues: done with wrap-up.                                                                                                                                              |

### Play & Delete Voicemail

When the message light is on, you have new voicemail. To listen from your desk phone:

1. Dial `*97` (or press the **Message** key).
2. You hear how many messages you have, then the newest message plays with the date and time it was left.
3. Press a key at any time while listening:

| Press   | To                       |
| ------- | ------------------------ |
| 1       | Skip to the next message |
| 3       | Call the person back     |
| 7       | **Delete** the message   |
| 9       | Replay the message       |
| \* or # | Exit voicemail           |

- If you don't press anything, the next message plays after a few seconds.
- Your newest 20 messages are available by phone.

More options, like greetings and email notifications, are in [Voicemail](https://docs.vinsi.ai/telephony/voicemail).

### Outbound Caller ID

Outside callers see the phone's assigned number — or your organization's default number if an admin turned on _Always use this number as the outbound caller ID_ (Phone Settings → Settings). The name comes from the phone's **Display Name**, falling back to your organization's default caller ID name, then the member's name.

## Troubleshooting

| Problem                              | What to check                                                                                             |
| ------------------------------------ | --------------------------------------------------------------------------------------------------------- |
| Phone won't register                 | Re-check the server, user ID, and password; make sure your network allows outbound SIP (UDP 5060).        |
| Changes don't show on the phone      | Click **Push Now**, or confirm auto-provisioning is set up (Edit Phone → Status shows the last check-in). |
| Lost the SIP password                | It can't be shown again — deprovision and add the phone again, then re-provision it.                      |
| Phone doesn't ring on inbound calls  | Check the member's **Inbound** is on and **Rings** isn't _Softphone only_.                                |
| Too many coworkers for the side keys | Hide or reorder keys in **Function Keys**.                                                                |
| Wrong time on the phone              | Set the time zone in **Date & Time**, then re-import the config file (US time zones need a re-import).    |
