EloSync Docs

Appearance

Live Chat deployment ​

Migrate ​

bash
php artisan migrate --force

Idempotent migrations:

  • 2026_09_17_003600_create_live_chat_tables
  • 2026_09_17_003610_register_live_chat_module
  • 2026_09_17_003620_add_live_chat_permissions
  • 2026_09_17_003630_bump_live_chat_module_version_to_1_0_1
  • 2026_09_17_003700_expand_live_chat_module_to_1_3_0 (schema + catalog bumps 1.0.1 → 1.1.0 → 1.2.0 → 1.3.0)
  • 2026_09_17_134951_expand_live_chat_module_to_1_4_0 (presence fields, suggested replies, notes; catalog 1.3.0 → 1.4.0)
  • 2026_09_17_172843_bump_live_chat_module_version_to_1_4_1 (embed session resume + Shadow DOM form isolation; catalog 1.4.0 → 1.4.1)
  • 2026_09_18_213545_bump_departments_and_live_chat_for_hidden_inactive_members (catalog 1.4.1 → 1.4.2)
  • 2026_09_25_142200_bump_live_chat_module_version_to_1_5_0 (send soft-fail + typing; catalog 1.4.2 → 1.5.0)
  • 2026_09_25_200000_bump_live_chat_module_version_to_1_5_1 (open/close soft-fail, embed lock/retry, snippet ?v=; catalog 1.5.0 → 1.5.1)
  • 2026_09_25_210000_bump_live_chat_module_version_to_1_5_2 (inbound notification Reverb broadcast; catalog 1.5.1 → 1.5.2)
  • 2026_10_03_223500_add_live_chat_idle_routing_and_bump_to_1_6_0 (department routing, idle minutes, idle scan columns; catalog 1.5.2 → 1.6.0)

Catalog row: free Communication opt-in live-chat 1.6.0 (not default-included). Workspaces install from Marketplace.

Runtime ​

  • Serve static public/widgets/live-chat.js from the API host (or CDN in front of it). Settings embed snippet includes ?v=1.6.0 for cache-bust; purge CDN for unversioned URLs.
  • Public widget routes need the APP_URL host reachable from third-party sites (CSRF excepted).
  • CORS: LiveChatPublicCors reflects Origin for credential-less api/public/live-chat/* (does not open the rest of the API).
  • Rate limits: live-chat-widget (60/min) and live-chat-widget-session (10/min for session create).
  • Visitor sessions expire after 7 days; schedule live-chat:purge-visitors --days=90 and live-chat:scan-idle (registered in routes/console.php).
  • Agent realtime uses existing Reverb/Echo (private-tenant.*.live-chat.*); embed keeps short-poll with optional public channel.
  • Message send and conversation open/close persist even when Reverb/automation is down (side effects soft-fail + structured logs). Prefer a healthy Reverb daemon for typing and live desk updates.
  • Optional agent email notify is controlled per widget (email_notify_agents) and applies to first-chat intake only.
  • Idle alerts: widget idle_minutes (default 5; 0 off). First-chat FCM goes to department agents, not all Staff.

Production readiness ​

Verify ​

bash
php artisan test --compact tests/Feature/Tenant/LiveChat
# Frontend
npm run test:e2e:live-chat

Official documentation for the EloSync SaaS Platform.

© 2026 EloSync. All rights reserved.