Skip to content
Guides
Platform installation
Universal installation

Universal installation

Universal installation is for websites without a ready EasyChat module or for projects where the widget code must be inserted manually.

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).

When To Choose This Option

  • your CMS is not listed among ready platforms;
  • the website runs on a custom system;
  • you want to choose the EasyChat folder and widget placement yourself.

Before Installation

  • Download the universal EasyChat package from the easychat24.ru landing page.
  • Create a backup of files and the database.
  • Prepare website file access.
  • Find the template where shared website scripts are added.
Do not publish files with passwords, external service keys or connection settings. If you need help, send screenshots without secrets.

Installation

  1. Upload the EasyChat folder to the website.
  2. Open the installation page.
  3. Enter the details requested by the installer.
  4. Create the EasyChat administrator.
  5. Log in to the admin panel after installation.

On the first screen, you can enable extra features: the mobile app, notifications, AI assistant and update news. If you do not need them now, skip the screen and return to settings later.

Connect EasyChat24 services and Receive important EasyChat24 news are independent choices. Technical services are preselected as the recommended setup for the Android app and push notifications; you can turn them off before saving or skip the entire screen. News remains off until you enable the subscription and provide an email address. Conversations, customers, orders, passwords and API keys are not sent.

Connect The Widget

Add the widget code to the shared website template or only to the pages where chat is needed:

<script src="https://example.com/easychat/index.php?route=widget" async></script>

Replace example.com/easychat with the address of your EasyChat installation.

After adding the code, open a public website page and check that the chat button appears. If the website uses cache, clear the site and browser cache.

Background Tasks

Universal installation is not connected to a CMS scheduler, so background tasks must be added in the hosting panel.

Open the Scheduler section in EasyChat and copy the command or link shown by your installation. Add it to hosting about once a minute. Do not copy commands from someone else’s guide: every website has its own path and PHP version. A ready console command appears on a black background; the $ prompt is only a visual cue and is not included when you copy it.

Use PHP CLI 7.4 or newer. EasyChat shows an absolute path only after checking PHP, required capabilities, and the target file; a verified hosting alias stays in the copyable command and short commands are never guessed. EasyChat’s own internal lock safely skips overlapping runs, so the command does not depend on the host’s flock utility. Do not set the scheduler to the cron.php path alone: without a PHP interpreter, hosting usually returns Permission denied. After saving the task, select Verify scheduler and wait for proof from the actual background run.

Paste the full string into an Arbitrary command task. See the official Beget guide.

EasyChat checks both the PHP version and database access inside the CLI runtime. Some hosts use different PHP settings for the website and scheduler: browser installation succeeds while CLI has no mysqli. The mysqlnd module alone does not provide the mysqli API. If EasyChat shows this warning, select a different PHP CLI in the hosting panel or ask hosting support to enable mysqli for CLI. Do not switch to the legacy mysql driver: PHP 7 removed it. For the full main background task, also enable the curl extension in CLI. EasyChat uses it to reach messenger, marketplace, AI and service APIs.

Updating

Create a backup before updating. Then upload the new version over the current EasyChat folder without deleting settings, attachments or logs.

After updating, open the EasyChat admin panel. The system will prepare the required changes automatically.

Check

  1. Open the EasyChat admin panel.
  2. Check administrator login.
  3. Open the website page with the widget.
  4. Send a test message.
  5. Reply as an operator and check the reply in the widget.

Common Situations

  • The chat button did not appear. The code was added to the wrong template or the page shows old cache.
  • The admin panel does not open. Check that all files were uploaded fully.
  • Settings are not saved. Check folder permissions.
  • Messages arrive with a delay. Check the background task on hosting.

Quick Checklist

  • Backup created.
  • EasyChat files uploaded.
  • Admin panel opens.
  • Widget code connected.
  • Background task added on hosting.
  • First conversation checked.

Updates

Generic PHP provides a transactional one-click update: signature and package checks, protected backup, publication and automatic rollback on failure. Configuration, conversations, uploads and logs stay outside the replaced release file set. Read about update checks.

Admin panelCheck EasyChat after installation. Website widgetConnect and test manual widget code. Frequently asked questionsDiagnose installation problems.

Storage conflicts

If EasyChat reports that storage is unavailable, ask your hosting administrator to check EasyChat’s dedicated folders, write permissions and access rules. Do not point attachments or logs at shared store folders. EasyChat preserves unknown protection rules and stops its own operation. Retry installation after resolving the conflict.

Operator photos and supporting chat images also remain in dedicated EasyChat folders. After updating, check an operator photo and open a chat attachment.

Last updated on
Webasyst