jeffersongoncalves / filament-tawk-to

3.1.0 2026-10-09 11:38 UTC

Requires

• php: ^8.2
• filament/filament: ^5.3
• jeffersongoncalves/filament-analytics-core: ^3.1
• jeffersongoncalves/laravel-tawk-to: ^1.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.0
• orchestra/testbench: ^10.0|^11.0
• pestphp/pest: ^3.0|^4.0
• pestphp/pest-plugin-laravel: ^3.0|^4.0

Suggests

• jeffersongoncalves/laravel-open-hours: Show the chat only during opening hours

MIT

• Jefferson Gonçalves

• laravel
• live-chat
• tawkto
• customer-support
• filament
• tawk-to
• chat-widget
• filament-plugin
• jeffersongoncalves
• spatie-laravel-settings
• filament-tawk-to

Published on Packagist.org on 2026-10-09 11:43 UTC

README

Filament Tawk.to

Filament plugin for Tawk.to — free live chat widget for customer support — with a settings page powered by Spatie Laravel Settings. Manage Tawk.to from the Filament admin panel; the script is injected before </body> of every panel page.

Built on top of jeffersongoncalves/laravel-tawk-to.

Compatibility

Branch	Filament	Package version
1.x	3.x	^1.0
2.x	4.x	^2.0
3.x	5.x	^3.0

Installation

composer require jeffersongoncalves/filament-tawk-to:"^3.0"

Publish the settings migrations and run them:

php artisan vendor:publish --tag=tawk-to-settings-migrations
php artisan migrate

Usage

use JeffersonGoncalves\Filament\TawkTo\TawkToPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            TawkToPlugin::make(),
        ]);
}

The plugin registers a Tawk.to settings page and injects the script before </body> of every panel page once the settings are complete.

Field	Label
property_id	Property ID
widget_id	Widget ID
identify_users	Identify signed-in users
only_when_open	Only during opening hours

Identify users and opening hours

• Identify signed-in users sends the panel user's name and email to Tawk.to.
• Only during opening hours hides the chat while laravel-open-hours says you're closed — pair it with filament-open-hours to edit the schedule from the panel.

Disable the Settings Page

TawkToPlugin::make()
    ->settingsPage(false),

To render the script outside Filament, add @include('tawk-to::script') to your own layout.

Navigation group

Put the settings page in one of your panel's own navigation groups (a string or a closure):

TawkToPlugin::make()
    ->navigationGroup(fn (): string => __('admin.navigation.settings')),

Requirements

• PHP 8.2 or higher
• Filament 5.x

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Jefferson Gonçalves
• All Contributors

License

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