Communicator Error Codes — Guide

This document explains common error messages in Communicator, what they mean, and what to do to resolve them.

Common Errors & Their Meanings

Error Message What It Means How to Fix It
“Your account has no Editions Permissions granted. Please contact your administrator.” The extension/user has no edition (features/modules) assigned. There’s nothing to allow this user to use the Communicator because no permissions are granted. Check the user’s extension settings → Editions & Modules. Ensure an edition is selected. Also check that there are the proper licenses allocated to the account.
“Proxy is not ready to accept connections.” The service that provides connections (pwproxy) is down or not running properly. Contact support/administrator to check the pwproxy service status.
“Connection refused. Service is down or outdated.” Either the backend service is offline, or the version of Communicator does not match what UX expects. Confirm that the server is running and up to date. Ensure the version of the Communicator app is compatible with the UX version. Update either side if needed.
“Your account is suspended. Please contact your administrator.” The extension / user is disables. Contact support/administrator and provide them with your extension number and email address.
“Service is suspended. Please contact your administrator.” The subscription for Communicator itself is suspended. Contact support/administrator and provide them with your extension number and email address.
“Your account does not support <EDITION> edition.” The user is trying to log in using a role or edition that isn’t assigned to their account. For example, they have “Business” edition but are attempting a supervisor/agent edition. Contact support/administrator. In Editions & Modules, make sure the correct edition(s) is assigned to the extension. If not, adjust or correct the editions.
“This is the first time you are logging in. Please change your password.” The user is logging in for the first time under a default or temporary credential. A password change is required. On first login, follow the prompt to change password. After doing so, future logins should be normal.
“License limit reached.” There are too many users/agents logged in relative to licensed capacity. Acquire more licenses or ensure that inactive sessions are logged out. Check with the administrator.
“Empty password is not allowed.” A blank password was used, which is not permitted. Enter a non-blank password. If user setting allows, force a password reset.
“Login Failed: Username or Password is incorrect.” The credentials entered do not match those in the system. Double-check spelling, case, and format. If needed, reset the password via admin.
“DB connection error.” The database (e.g. MySQL) that Communicator communicates with has hit its maximum number of concurrent connections, or cannot accept more. Administrator should check database health and connection limits. Possibly increase the connection limit or free up existing connections.
“Your system has reached maximum number of concurrent connections. Please contact your administrator.” Similar to “License limit reached” but refers specifically to the maximum concurrent sessions allowed by system configuration. Same fix: ensure capacity for connections, log out idle users, or upgrade system limits or licenses.
“Your version is not compatible. Please update or contact your Administrator.” The version of the Communicator client/app is mismatched (too old or too new) relative to the server. Update the client or server software so they are compatible. Admin should ensure the supported version matrix is followed.
“User ID is invalid. Please contact your administrator.” The user’s account record (user ID) is missing or wrong in the server database. Admin should check the user table / user list, confirm that there is a valid user record. Fix or recreate if missing.
“Agent number is not valid.” If using agent functionality (call center / queues), the agent number used does not match a valid agent in the system. Check the agent number configured for the user/extension. Correct any typos or misconfigurations.
“Agent pin is incorrect.” The PIN used for agent login or operation is incorrect. Reset or verify the agent pin in the extension’s agent settings. Ensure user knows the proper PIN.