Laravel Support Chat

Overview#

laravel-support-chat is a production-ready customer support chat package for Laravel applications. It ships with a floating customer widget, a Livewire-powered agent inbox, real-time messaging via Laravel Reverb, and a complete conversation management system — all without forcing Vue or React into your application.

Install it, drop one line into your layout, and your application has a working support chat system.

Installation#

composer require mahbuburriad/laravel-support-chat
php artisan support-chat:install
php artisan migrate
php artisan install:broadcasting

Add the widget to your Blade layout:

<x-support-chat-widget />

Features#

• Floating chat bubble with configurable position
• Guest and authenticated customer chat
• Real-time messaging via Laravel Reverb with polling fallback
• Agent inbox with status, priority, and assignment filters
• Agent-to-agent conversation transfers
• Internal notes visible only to support staff
• Conversation status: open, pending, resolved, closed
• Unread message badge and audio notification
• Typing indicators
• Theme, color, and copy customization from config
• Authorization via Laravel Gates or an agent flag column
• Rate-limited message creation
• Messages sanitized with strip_tags() before storage

Requirements#

• PHP 8.2+
• Laravel 11 or 12
• Livewire 3
• Laravel Reverb (or any Laravel broadcasting driver)

Reverb Setup#

php artisan install:broadcasting
php artisan reverb:install
php artisan reverb:start
php artisan queue:work

BROADCAST_CONNECTION=reverb
SUPPORT_CHAT_BROADCAST_DRIVER=reverb

Configuration Example#

'widget' => [
    'position'     => 'right',
    'title'        => 'Need Help?',
    'welcome_text' => 'Ask us anything. A human agent will reply shortly.',
    'theme' => [
        'primary'   => '#0f766e',
        'secondary' => '#ecfeff',
    ],
],
'chat' => [
    'allow_guest_chat' => true,
],

Roadmap#

• Attachments and file uploads
• Departments and routing rules
• Canned replies
• Email notifications
• Slack and Telegram relay
• Transcript export
• Chatbot handoff

License#

MIT © Mahbubur Riad