Why a Remote Agent user needs level 4 or higher

When you create a Remote agent entry in VICIdial, the User ID Start must point at a valid, active VICIdial user account. But not every user level gets equal access. If you want the Agent to log in through the vdremote.php web page — the dedicated remote login interface — the user account must be at level 4 or higher. A user at level 1, 2, or 3 can still receive forwarded calls on their external phone, but they cannot authenticate with vdremote.php.

What user level controls here

VICIdial user levels are integers that gate which parts of the system a user can reach. For standard agents working inside the office on a full dialer session, the level requirements are different. But for remote agents, the specific threshold is level 4. That threshold enables access to vdremote.php, the page remote workers use to start and manage their Agent session from a web browser instead of the full agent console.

The user level does not affect whether the system can forward calls to the user's external phone number. A remote agent entry that points to a level-1 user will still send calls to the configured Dialplan extension. The level only controls whether that user can log in via the remote web interface to disposition calls, view their queue, or change their status.

How to check and set the user level

Go to Admin > Users and find the account you plan to use as the User ID Start for the remote agent entry. Open the user record and look at the User Level field. If it reads 1, 2, or 3, change it to 4 before saving the remote agent entry. If the user does not exist yet, create it at level 4 from the start — VICIdial validates that the User ID Start is a real, active account when you submit the remote agent form, so the user record must be in place first.

• Level 1–3: user exists and can receive forwarded calls on their external phone, but vdremote.php login is blocked.
• Level 4+: user can log in via vdremote.php, disposition calls, update their status, and participate in their assigned Campaign from a remote location.
• The user account must already exist before you create the remote agent entry — submitting with a non-existent User ID Start is rejected by validation.

The user level check in practice

A common setup mistake is creating the VICIdial user account at the default level (often 1) and then wondering why the remote worker cannot reach the vdremote.php login page. The system accepts the remote agent entry without complaint because the User ID is valid — it does not warn you at save time that the level is too low for web login. The failure only becomes visible when the agent tries to sign in remotely and gets an authentication error.

flowchart TD
  A["Remote agent tries vdremote.php login"] --> B{"User ID valid and active?"}
  B -->|No| C["Login rejected — user not found"]
  B -->|Yes| D{"User level 4 or higher?"}
  D -->|No| E["Login rejected — insufficient level"]
  D -->|Yes| F["Login accepted"]
  F --> G["Agent session starts"]
  E --> H["Calls still forward to external phone"]
  H --> I["Agent receives calls but has no web control"]

Multi-line remote agents and user levels

When you set Number of Lines greater than 1, VICIdial increments the User ID Start for each additional line. A start of 5001 with 3 lines creates entries for 5001, 5002, and 5003. You only create the first user record — 5001 — not one per line. However, if any of those incremented IDs happen to collide with existing user accounts that are below level 4, those lines will forward calls correctly but their corresponding users will not be able to reach vdremote.php. Plan your User ID range and check levels before committing to a start value.

For a step-by-step walkthrough of adding the remote agent entry itself, how to add a remote agent covers every field in the form. The full context for how remote agents fit into your call center setup is in the remote agents and mobile guide. If you want a managed VICIdial environment where the server is already configured and ready for remote agents, our managed VICIdial plans get you running in under 40 seconds.