Skip to content
Guides
Platform installation
Bitrix

Bitrix

Use this guide for Bitrix websites. EasyChat is installed as a module, opens from the site admin area and shows chat on public pages.

Download packageStart installationOpen cabinet
After installation, set up the main cron and verify it runs. This is required: it must run every minute, even without website visitors. Use the command for your CMS from Settings → Scheduler (Cron).

Before Installation

  • Download the EasyChat package for Bitrix from the easychat24.ru landing page.
  • Create a website backup.
  • Prepare Bitrix administrator access.
  • Use Bitrix main 24.0.0+, UTF-8 and PHP 8.2 or newer. Current Bitrix versions no longer support CP1251 installations.
  • Make sure you can check a public page after installation.
Do not send passwords, full server paths or database settings to support. An error screenshot and website address are usually enough for diagnostics.

Installation

  1. Install the EasyChat package using the method for your Bitrix version.
  2. In the admin area, open Settings → Product Settings → Module Settings → EasyChat — live chat for websites.
  3. Click the button that opens the EasyChat admin panel.
  4. Check that the EasyChat interface opens without errors.
When publishing through the 1C-Bitrix partner portal, upload .last_version.zip. The tar.gz artifact is retained only for compatibility and may be rejected by the Marketplace extractor when the file tree is deep. Before publication, EasyChat binds the ZIP SHA-256 to a separate journal from the official Bitrix security review; a journal from an older archive is rejected.

The direct settings path is /bitrix/admin/settings.php?lang=en&mid=wellsoft.easychat&mid_menu=1. Change the lang value if your admin area uses another language.

During a normal installation, EasyChat does not ask you to enter database settings manually. The module uses your Bitrix settings.

When installed from 1C-Bitrix Marketplace, the module code remains in the protected Bitrix system directory and EasyChat automatically prepares its public runtime in /local/easychat, a dedicated permitted site directory. No file copying, path changes or manual setup is required.

First Login

Click Open EasyChat Admin on the module settings page. Bitrix verifies the administrator and the current session token, while EasyChat creates a one-time entry only when you click the button. You do not need to enter a username or an unknown initial password.

The button opens a dedicated protected Bitrix admin action, which then hands you over to EasyChat. If the site map opens instead, install the current update and retry from the module settings page.

If a login form opens instead of the admin panel, do not guess the password. Return to the module settings and click the button again. If this keeps happening after an update, install the complete latest module package and clear the Bitrix cache and hosting OPcache so that the wrapper and EasyChat core use the same version.

On the first entry from Bitrix, EasyChat shows a short optional-services screen for the mobile app, notifications, AI assistant and update news. Skip it if you do not need these options now.

Website Widget

Open a public website page and check that:

  • the chat button is visible to the visitor;
  • the chat window opens;
  • a test message appears in EasyChat;
  • the operator reply appears in the widget.

If the button is missing, enable the widget in EasyChat and clear Bitrix, template and browser cache.

Background Tasks

EasyChat needs regular background tasks for notifications, integrations and AI. Open the scheduler block in EasyChat and use the command or link shown by your own website.

Add it to the hosting panel about once a minute. If you are unsure which option to choose, send support a screenshot of the scheduler block without passwords.

After Updating

Create a backup, install the new package over the current version and open EasyChat from the Bitrix admin area.

Check that:

  • the EasyChat admin panel opens;
  • previous conversations are still there;
  • the widget works on a public page;
  • a test message appears in the conversation list.

Common Situations

  • The settings page reports a legacy trial build. The EasyChat Marketplace card was previously distributed in trial mode by mistake. The module is now free: select Check for updates and install the current build. Do not delete the module or its data manually.
  • EasyChat does not open from Bitrix. Check administrator permissions and reopen the EasyChat module. Entry is created only by the protected settings button; the regular login form does not require guessing a password.
  • The widget is not visible. Enable the widget and clear site cache.
  • Messages arrive with a delay. Check that background tasks are enabled on the hosting panel.
  • An error appears after installation. Do not delete files or tables manually. Update EasyChat to the latest version and send support a safe error screenshot.

Quick Checklist

  • The EasyChat package for Bitrix is installed.
  • The EasyChat admin panel opens from Bitrix.
  • Opening from Bitrix does not ask for an unknown initial password.
  • The widget is visible on a public page.
  • A test conversation was created and answered.
  • Background tasks are added to the hosting panel.

Updates

EasyChat verifies the official release while the native 1C-Bitrix module system performs the installation. The platform remains in control of files and migrations. Read about update checks.

Last updated on
OpenCartWordPress