Troubleshooting
System Configuration
Common situations met while configuring the platform, with the likely cause and the recommended resolution.
Five Checks to Make First
- Did you click Save Configuration? Settings are stored only when you save.
- Is the module or plugin switch on? Fields and menu entries appear only when the switch is on.
- Does the license include the feature? License Details lists the enabled modules and plugins.
- Does the role have the permission? The System Configuration group of the role controls each page.
- Did you copy the value from the right place? Keys, webhook addresses and host names come from the provider portal or the plugin panel.
Symptoms, Causes and Resolutions
| Topic | Symptom | Likely Cause | Resolution |
|---|---|---|---|
| Modules | A module or menu entry is missing. | The module switch is off, or the license does not include it. | Open Modules and turn the switch on. Check the Enabled Modules list on License Details. |
| Modules | The new settings are gone after you moved to another module. | The change was not saved before you left. | Click Save Configuration on the module before you select another one. |
| Modules | An email or SMS provider is not in the list. | Its plugin is off or was not saved. | Turn on and save the plugin on the Plugins page, then return to the module. |
| Plugins | A plugin shows no fields. | The switch is off. | Turn the switch on. The fields appear below it. |
| Plugins | Mail or messages are not delivered. | The provider key is wrong, or the sender is not registered with the provider. | Re enter the key, check the sender with the provider and send a test message. |
| Plugins | Delivery status never updates. | The Webhook URL was not added to the provider portal. | Copy the Webhook URL from the plugin and paste it in the provider webhook settings. |
| Plugins | Login with AD does not work. | The LDAP server address, base DN or service account is wrong. | Check the values with the directory administrator and use the secure address where possible. |
| Plugins | 3CX data is not synchronizing. | The client identifier or API key is wrong, or the host was detached. | Check the values on the 3CX plugin and connect the host again. |
| Global Settings | Phone numbers have the wrong length or country code. | Phone Country Code or Phone Number Length does not match the numbers in use. | Correct both values in Regional Settings and save. |
| Global Settings | Times in reports look shifted. | The time zone is not the one of the business. | Choose the right Time Zone in Regional Settings. |
| Global Settings | A person is blocked after entering codes. | The OTP Attempt Limit was reached. | Wait for the OTP Attempt Block Time to pass, or ask an administrator to review the limits. |
| Global Settings | A file cannot be uploaded. | It is larger than Max File Upload Size. | Reduce the file, or raise the limit if the business needs it. |
| Global Settings | An export stops at a fixed number of records. | The Report Export Limit was reached. | Narrow the report with filters, or raise the limit. |
| Theme | A new logo does not show. | The change was not saved, or the other theme is in use. | Click Save, and set both the light and dark tabs. |
| Theme | An image is not accepted. | The format or size is not supported. | Use PNG, JPEG or SVG of up to 10 MB. |
| Update | The Update page is not in the menu. | The role does not have the System Update permission. | Switch System Update on for the role. |
| Update | No versions are listed. | The platform is up to date, or the list is old. | Click Check Updates. |
| Permissions | A person cannot open Global Settings. | The role has Global Configuration set to No. | Switch Global Configuration on for the role. |