How to open the site as an app in Bitrix24

← Back

Create a section with the app_b24 module, add a local app on the portal with the addresses from the section page, and enter its client_id and client_secret in the module settings.

  1. Create a section, for example /b24, with the app_b24 module and «Everyone» access.
  2. Open its page as an administrator. The «Addresses for app settings» block contains the «Your handler path» and the «Initial installation path».
  3. On the portal: Developers → Other → Local application, type «Server». Do not check «Uses API only». Paste both addresses, come up with a name for the menu item and save.
  4. Copy the «Application code (client_id)» and the «Application key (client_secret)» into the «Module settings»: the «client_id (application code)» and «client_secret (application key)» fields.
  5. On the section page, click «Check keys and connection to Bitrix24».
  6. Select «Where the user lands after login» and click «Save».
  7. Open the app in the portal's left menu. Installation will complete on its own.

Each portal employee logs in to the site with their own account. It is created on first login, and the name is taken from the portal. The portals where the app is installed and the number of their users are shown in the section summary.

Payment pages don't work inside the portal. That's why pages from the «Pages that open in a new tab» field (/finance by default) are replaced with a button. It opens the same page in a new tab, and the person is already logged in to the site. To allow only your own portal, enter its address in «Only these portals (optional)».

The app can also be published in the Bitrix24 Marketplace — this requires developer partner status. The keys are then taken from the vendor account, the «Test» button.

If it didn't work

  • Unable to confirm login from Bitrix24. Most often the keys are from a different app or were copied with a space. Check them with the «Check keys and connection to Bitrix24» button. If the app window has been open for a long time, refresh the portal page.
  • Login is not saved. The site opens inside the portal, and desktop Safari and Firefox in strict mode don't keep such a login. Chrome, Yandex Browser, Edge and the Bitrix24 apps work.
Did the article help?

See also

In the help section, you will find answers to frequently asked questions and useful instructions for working with the Site Look website builder. Here you can learn how to manage sections, add objects, and configure the website. The materials will be useful for both beginners and experienced users. If you haven't found an answer, contact support.