Help / Getting started
Logging into VICIdial admin and the agent screen
Your dialer has three logins — the admin panel, the agent screen, and the API user. Where each credential lives in your dashboard and how to sign in, click by click.
Your dialer has three logins: the VICIdial admin panel (for you), the agent screen (for your team), and the API user (for software integrations). All three credentials live on one page of your VICIfast dashboard. This walkthrough shows where to find them and how to sign in, click by click. About five minutes.
Step 1 — Find your admin credentials
- Click Servers in the left sidebar.
- Click your server’s name in the list.
- Scroll to the VICIdial admin card. It sits next to the API user card, just above the tabs.
- Click Reveal next to the masked password. The password appears, with Copy and Hide buttons beside it.
The card gives you all three pieces: the URL (a link you can click straight away), the Username (6666), and the Password. The password is never emailed to you — this card is the only place to see it.

Step 2 — Log into VICIdial admin
- Click the URL on the VICIdial admin card. It looks like https://your-server:PORT/WORD/admin.php — the port and the word are random per server, on purpose.
- Your browser pops up its own sign-in box. That is the browser asking, not a web page — it looks different in Chrome, Edge, and Safari.
- Type 6666 as the username and paste the revealed password.
- You land on the VICIdial admin home, with the ADMINISTRATION menu down the left.

If the URL does not load at all — it spins and times out — your current IP is not allowed through the firewall yet. Go back to your server page, click Manage Firewall in the tools strip, then click Whitelist me. The page loads a few seconds later.
Step 3 — Log an agent into the agent screen
Agents sign in at https://your-server-hostname/agc/vicidial.php — your server’s hostname is shown at the top of its page in the dashboard. Send that link to your team.
- Open the agent-screen link in the agent’s browser (Chrome or Edge work best).
- In User Login, type the agent’s user ID — for example 1001.
- In User Password, type the agent’s password.
- Click the Campaign dropdown and pick the campaign. The list fills in once the login and password check out.
- Click SUBMIT.

The first time, the browser asks once to allow the microphone — the agent’s phone is built into the screen. After that, the agent is on the dialer. There is no separate phone login to worry about: every agent created in your dashboard gets a webphone bound to their user ID, and it signs itself in.
Where agent passwords come from
You set each agent’s password when you create them:
- Click Servers in the left sidebar, then click your server’s name.
- Click the Users tab.
- Click New agent and fill in the form. The Password field already holds a generated password — copy it somewhere safe before you click Create, or type your own.
Passwords are shown once. If an agent forgets theirs, click the reset icon (the circular arrows, titled Reset password) on their row in the Users tab. A Credentials — shown once window pops up with the new password and a Download CSV button. Hand the agent their user ID and the new password.
Step 4 — The API user, for integrations
The API user card is for software, not people. If you connect a CRM, a lead vendor, or any tool that talks to VICIdial’s non_agent_api.php interface, it needs three things from this card: the Endpoint URL, the Username (apiuser), and the Password — click Reveal to see it, then Copy.
Paste those into your integration’s settings. The API user can only make API calls — it cannot sign into the agent screen.
Good to know
- Bookmark the admin URL. The random port and word in it are a deliberate safety feature, and the URL stays the same for the life of the server.
- Admin URL times out? Your IP changed. Server page → Manage Firewall → Whitelist me and you are back in seconds.
- Treat the 6666 password like the keys to the building. It is only ever visible behind the Reveal button — anyone who can open your dashboard can see it.
- Old agent passwords cannot be shown again — the box only keeps a scrambled version. Reset is the only way back in.
- Agents never see a phone-login screen. If an agent reports being asked for a "phone login", their account was likely created inside VICIdial admin instead of the dashboard — recreate them from the Users tab.
- The API user is for integrations only. Giving it to a human to "try logging in" will not work — that is by design.