Skip to main content

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​

TopicSymptomLikely CauseResolution
ModulesA 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.
ModulesThe 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.
ModulesAn 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.
PluginsA plugin shows no fields.The switch is off.Turn the switch on. The fields appear below it.
PluginsMail 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.
PluginsDelivery 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.
PluginsLogin 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.
Plugins3CX 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 SettingsPhone 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 SettingsTimes in reports look shifted.The time zone is not the one of the business.Choose the right Time Zone in Regional Settings.
Global SettingsA 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 SettingsA 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 SettingsAn export stops at a fixed number of records.The Report Export Limit was reached.Narrow the report with filters, or raise the limit.
ThemeA 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.
ThemeAn image is not accepted.The format or size is not supported.Use PNG, JPEG or SVG of up to 10 MB.
UpdateThe Update page is not in the menu.The role does not have the System Update permission.Switch System Update on for the role.
UpdateNo versions are listed.The platform is up to date, or the list is old.Click Check Updates.
PermissionsA person cannot open Global Settings.The role has Global Configuration set to No.Switch Global Configuration on for the role.