Bitrix24Care

Troubleshooting common issues with Bitrix24 integration apps

When using Bitrix24 Integration apps, you may encounter certain issues that can affect their functionality. These issues are often caused by network configuration, third-party tools, and plugins that may block data transfer via REST API. 

This can result in the app being unavailable, displaying a blank page, showing a 502 error status, or not displaying embedded options after installation.

All Bitrix24 apps operate via REST API. That means the apps' internals are never installed on your Bitrix24. Installing an app from the Market allows you to call an external app server to process the requests and send back the responses over the web. Your Bitrix24 will only store authorization and preferences data.

For optimal integration app performance, it is essential to utilize the web version of Bitrix24. Please note that desktop and mobile versions are not compatible with integration apps.

Please follow the recommendations below to resolve these issues:

On-Premise
Cloud version

Integration-related issues are predominantly associated with deployment and maintenance of self-hosted product version and can be successfully resolved by your system administrator.

  • Network configuration
Ensure that your network administrator grants network access for REST applications. If you are using the Proactive protection modulewhitelist the IP address 107.20.242.201 to allow in- and outbound requests to the Integrations server. Failure to do so may result in the unavailability of integration apps.
  • SSL Certificate
Check if your SSL certificateSSL certificate is a digital signature of a website. It ensures encrypted connection between website visitors and the server. The certificate is also used to confirm website authenticity: any user can verify if a specific website truly belongs to a corresponding company. has an A-class rank. If it does not meet the requirements, contact your system administrator to update it. You could use SSL Server Test provided by SSL Labs project to monitor its current status.
  • System updates
Download and install recommended system updates. Before proceeding, ensure that you have a backup of both the database and the product kernel and service area scripts. Perform the update when the server load is minimal.
  • System Check
Run a full system check to identify and fix any website issues that may affect the functioning of REST applications. Go to Settings - Tools - System check - Configuration Check - Start test button. Follow the troubleshooting recommendations if any issues are detected.
  • Security policies
If you have a strict security policy regarding network access in your self-hosted account, follow the recommendations described in the Bitrix24 Applications course. This will ensure the smooth operation of Bitrix24 integration apps.
  • Browser settings & extensions
Disable all browser extensions, adblockers, and web-antiviruses (at least for account-related web pages) as they may block the frames required for the app to function correctly.
  • Incognito test & switching to another browser
Perform a test in incognito mode of your browser. Additionally, try using a browser with an alternate kernel (e.g., Mozilla Firefox or Safari if you are using a Chromium-based browser, and vice versa).
  • Reinstallation
If none of the above options help, uninstall the app with marking the checkbox for purging application settings and reinstall it from the Market to ensure that you have the latest version of the app set up for your account.

If you are using unique solutions like Absence or Billable Hours for Tasks, please contact support beforehand to discuss exporting your data before deleting the app or applying issue-related fixes.

If the issue persists, please reach out to our support team for further assistance.


Integration apps in the cloud version work from a dedicated server and use frames. They also work from the "outside" using OAuth authorization to access the REST API. 

If you encounter issues such as a 502 status error, a blank page, overall slowness, or timeout-related problems, follow these steps:

  • Browser settings
Clear your browser cache and update your browser to the latest version available.
  • Connectivity issues
Check your internet connection and ensure that you are not in a local network that is unavailable from the web.
  • Web extensions
Disable all browser extensions, adblockers, and web-antiviruses (at least for account-related web pages) as they may block the frames required for the app to function correctly.
  • Incognito test & switching to another browser
Perform a test in incognito mode of your browser. Additionally, try using a browser with an alternate kernel (e.g., Mozilla Firefox or Safari if you are using a Chromium-based browser, and vice versa).
  • Reinstallation

If none of the above options help, uninstall the app with marking the checkbox for purging application settings and reinstall it from the Market to ensure that you have the latest version of the app set up for your account.

If you are using unique solutions like Absence or Billable Hours for Tasks, please contact support beforehand to discuss exporting your data before deleting the app or applying issue-related fixes.

If the issue persists, please reach out to our support team for further assistance.


How to fix blank screen in Safari

Should you face a blank (white) screen after accessing an integration app in Safari, try going to Safari > Preferences > Privacy and uncheck Prevent cross-site tracking as this setting blocks applications running in iFrame. This option is enabled by default.
Safari Privacy Settings fix.jpg

General recommendations are also applicable to third-party Market apps. The article is available in multiple languages including:



Was this information helpful?
Integration specialist assistance
That's not what I'm looking for
Complicated and incomprehensible text
The information is outdated
It's too short. I need more information
I don't like the way this tool works
Go to Bitrix24
Don't have an account? Create for free
You may also like