About a2zwebltd/laravel-customer-support

a2zwebltd/laravel-customer-support is a Laravel package for a portable laravel customer support / helpdesk engine — tickets, threaded replies, attachments, sla tracking, mail notifications, livewire ui, and nova admin.. It currently has 1 GitHub stars and 113 downloads on Packagist (latest version v1.0.3). Install it with composer require a2zwebltd/laravel-customer-support. Discover more Laravel packages by a2zwebltd or browse all Laravel packages to compare alternatives.

Last updated August 9, 2026

Laravel Customer Support

A portable Laravel customer-support / helpdesk engine — tickets with threaded replies, attachments, internal notes, agent assignment, SLA tracking, mail notifications, a Livewire + Flux UI, and Nova admin resources.

Designed to drop into any Laravel app with minimal wiring while remaining fully customisable.

Screenshots

| Agent dashboard | New ticket | |---|---| | | |

| Ticket details | Nova admin | |---|---| | | Nova details |

Requirements

PHP 8.2+
Laravel 11 / 12 / 13
livewire/livewire ^3 or ^4 (for the bundled UI)
livewire/flux ^2 (recommended — Blade templates use Flux components)
spatie/laravel-medialibrary ^11 (attachments)
laravel/nova ^5 (optional — auto-registers Nova resources when present)

Installation

composer require a2zwebltd/laravel-customer-support
php artisan migrate
php artisan vendor:publish --tag=customer-support-config   # optional

Add the trait to your User model:

use A2ZWeb\CustomerSupport\Concerns\HasSupportTickets;

class User extends Authenticatable implements HasMedia
{
    use HasSupportTickets;
}

Define the agent gate in AppServiceProvider::boot():

Gate::define('manage-support-tickets', fn (User $user) => $user->is_admin);

Features

Ticket statuses: Open, Pending, In Progress, Awaiting Customer, Resolved, Closed
Priorities: Low / Normal / High / Urgent — each with configurable SLA hours
Configurable categories
Threaded replies (SupportTicketMessage)
Internal notes (visible only to agents)
Attachments via spatie/laravel-medialibrary (on tickets and messages)
Agent assignment with assigned_to
SLA timer (due_at) + EscalateOverdueTickets console command for cron escalation
Mail notifications: created / replied / status-changed / resolved (markdown, queueable)
Domain events: TicketCreated, TicketReplied, TicketStatusChanged, TicketAssigned
Policies on ticket + message resources
Livewire + Flux UI (teal accent, dark-mode aware)
Nova resources auto-registered when Nova is installed

Routes

| Method | URI | Name | |--------|-----|------| | GET | /support | support.index | | GET | /support/new | support.create | | GET | /support/{ticket} | support.show | | GET | /support/admin | support.admin.dashboard |

(Prefix and middleware configurable in config/customer-support.php.)

Configuration

See config/customer-support.php. Highlights: user_model, routes, admin_gate, categories, sla_hours, mail.admin_recipients, attachments, theme.accent.

Cron

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('support:escalate-overdue')->hourly();

Testing

composer test

Security Vulnerabilities

If you discover a security vulnerability, please report it responsibly through private communication with the maintainers.

License

The MIT License (MIT). Please see License File for more information.

Credits

Developed and maintained by the A2Z WEB crew:

Comments