PHPackages                             jeffersongoncalves/filament-whatsapp-widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. jeffersongoncalves/filament-whatsapp-widget

ActiveLibrary[Utility & Helpers](/categories/utility)

jeffersongoncalves/filament-whatsapp-widget
===========================================

This Filament package provides a simple yet customizable WhatsApp widget for your website. It allows you to easily add a clickable WhatsApp button or floating widget to connect visitors directly with your WhatsApp account. The widget is designed to be easily integrated into your Laravel application and is fully customizable to match your website's design.

v3.0.2(2mo ago)82.0k↓50%2MITPHPPHP ^8.2CI passing

Since Mar 3Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/filament-whatsapp-widget)[ Packagist](https://packagist.org/packages/jeffersongoncalves/filament-whatsapp-widget)[ Docs](https://github.com/jeffersongoncalves/filament-whatsapp-widget)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-filament-whatsapp-widget/feed)WikiDiscussions 3.x Synced 1mo ago

READMEChangelog (10)Dependencies (14)Versions (19)Used By (0)

[![Filament Whatsapp Widget](https://raw.githubusercontent.com/jeffersongoncalves/filament-whatsapp-widget/3.x/art/jeffersongoncalves-filament-whatsapp-widget.png)](https://raw.githubusercontent.com/jeffersongoncalves/filament-whatsapp-widget/3.x/art/jeffersongoncalves-filament-whatsapp-widget.png)

Filament Whatsapp Widget
========================

[](#filament-whatsapp-widget)

[![Latest Version on Packagist](https://camo.githubusercontent.com/fd7a23577db91f812046224fc4189b41cccd4ded735a12932332457b7bfdb143/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d77686174736170702d7769646765742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-whatsapp-widget)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/5a54ddb9d164ae3c5b4372e20733ff7161e86a9cac596706f8a6315596aca76a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d77686174736170702d7769646765742f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d332e78266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/jeffersongoncalves/filament-whatsapp-widget/actions?query=workflow%3A%22Fix+PHP+code+styling%22+branch%3A3.x)[![Total Downloads](https://camo.githubusercontent.com/e0ba19f8b1293a40e7232f806df285c8692f960822fe23875d04889e3a0499a6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d77686174736170702d7769646765742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/jeffersongoncalves/filament-whatsapp-widget)[![License](https://camo.githubusercontent.com/64850d874f5dc75e23416259e487e48c5959e6380ecaee5517c99244c3bbb7a0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6a6566666572736f6e676f6e63616c7665732f66696c616d656e742d77686174736170702d7769646765742e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)

This Filament package provides a simple yet customizable WhatsApp widget for your website. It allows you to easily add a clickable WhatsApp button or floating widget to connect visitors directly with your WhatsApp account. The widget is designed to be easily integrated into your Laravel application and is fully customizable to match your website's design.

Requirements
------------

[](#requirements)

- PHP 8.2 or higher
- Laravel 11.0 or higher
- Filament 5.0

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require jeffersongoncalves/filament-whatsapp-widget
```

Usage
-----

[](#usage)

This package is a Filament wrapper for [jeffersongoncalves/laravel-whatsapp-widget](https://github.com/jeffersongoncalves/laravel-whatsapp-widget).

Publish config file.

```
php artisan vendor:publish --tag=whatsapp-widget-config
php artisan vendor:publish --tag=filament-whatsapp-widget-config
```

Publish migration file.

```
php artisan vendor:publish --tag=whatsapp-widget-migrations
```

Publish assets file.

```
php artisan vendor:publish --tag=whatsapp-widget-assets
php artisan vendor:publish --tag=filament-phone-input-assets
```

Add in AdminPanelProvider.php

```
use JeffersonGoncalves\Filament\WhatsappWidget\WhatsappWidgetPlugin;

->plugins([
    WhatsappWidgetPlugin::make(),
])
```

### Manual Usage (Optional)

[](#manual-usage-optional)

If you want to use the widget on non-Filament pages, add the following templates to your layout:

#### Head Template

[](#head-template)

```
@include('whatsapp-widget::whatsapp-widget-head')
```

#### Body Template

[](#body-template)

```
@include('whatsapp-widget::whatsapp-widget-body')
```

Configuration
-------------

[](#configuration)

After publishing the configuration file, you can customize the widget by editing the `config/whatsapp-widget.php` file:

```
return [
    // Enable or disable audio notification
    'audio' => true,

    // Play audio notification once per day or on every page load
    'play_audio_daily' => true,

    // Filesystem disk for storing agent images
    'disk' => env('FILESYSTEM_DISK', 'local'),

    // Application URL (used for redirection)
    'url' => env('APP_URL', 'http://localhost'),

    // Application name (displayed in the widget)
    'name' => env('APP_NAME', 'Laravel App'),

    // WhatsApp API key (if needed)
    'key' => env('WHATSAPP_KEY'),

    // Widget position on the screen (left or right)
    'position' => 'right',
];
```

And `config/filament-whatsapp-widget.php` file:

```
use JeffersonGoncalves\WhatsappWidget\Models\WhatsappAgent;

return [
    'whatsapp_agent_resource' => [
        'cluster' => null,
        'model' => WhatsappAgent::class,
        'should_register_navigation' => true,
        'navigation_group' => true,
        'navigation_badge' => true,
        'navigation_sort' => -1,
        'navigation_icon' => 'heroicon-s-chat-bubble-left',
        'slug' => 'whatsapp/whatsapp-agent',
    ],
];
```

Customization
-------------

[](#customization)

### Translations

[](#translations)

This package is translated into several languages:

- Arabic
- Czech
- German
- English
- Spanish
- Persian
- French
- Hebrew
- Indonesian
- Italian
- Japanese
- Dutch
- Polish
- Portuguese
- Portuguese (Brazil)
- Portuguese (Portugal)
- Slovak
- Turkish

You can customize the widget's text by editing the translation files in `resources/lang/vendor/filament-whatsapp-widget/`.

### Position

[](#position)

By default, the widget appears in the bottom-right corner of the page. You can change this by modifying the `position` value in the `config/whatsapp-widget.php` file.

Example for left position:

```
'position' => 'left',
```

DefaultOpen[![Widget Position Left](screenshots/whatsapp-widget-bottom-left.png)](screenshots/whatsapp-widget-bottom-left.png)[![Widget Position Left Open](screenshots/whatsapp-widget-bottom-left-open-widget.png)](screenshots/whatsapp-widget-bottom-left-open-widget.png)Example for right position:

```
'position' => 'right',
```

DefaultOpen[![Widget Position Right](screenshots/whatsapp-widget-bottom-right.png)](screenshots/whatsapp-widget-bottom-right.png)[![Widget Position Right Open](screenshots/whatsapp-widget-bottom-right-open-widget.png)](screenshots/whatsapp-widget-bottom-right-open-widget.png)### Redirect Page

[](#redirect-page)

When a user clicks on an agent, they are redirected to a temporary page before being sent to WhatsApp. This page can be customized by publishing the package views.

[![Redirect Page](screenshots/whatsapp-widget-redirect-page.png)](screenshots/whatsapp-widget-redirect-page.png)

### Filament Resource

[](#filament-resource)

You can manage your WhatsApp agents using the Filament resource provided by this package.

ListCreate[![List Agents](screenshots/whatsapp-widget-resource-list.png)](screenshots/whatsapp-widget-resource-list.png)[![Create Agent](screenshots/whatsapp-widget-resource-create.png)](screenshots/whatsapp-widget-resource-create.png)EditView[![Edit Agent](screenshots/whatsapp-widget-resource-edit.png)](screenshots/whatsapp-widget-resource-edit.png)[![View Agent](screenshots/whatsapp-widget-resource-view.png)](screenshots/whatsapp-widget-resource-view.png)Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](.github/CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Jèfferson Gonçalves](https://github.com/jeffersongoncalves)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance87

Actively maintained with recent releases

Popularity27

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~22 days

Recently: every ~5 days

Total

18

Last Release

58d ago

Major Versions

v1.3.0 → v3.0.02026-02-16

v2.2.0 → 3.0.22026-02-24

v2.2.1 → v3.0.22026-03-04

1.x-dev → 2.x-dev2026-03-06

2.x-dev → 3.x-dev2026-03-22

PHP version history (2 changes)v1.0.0PHP ^8.2|^8.3

v3.0.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (48 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (3 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (1 commits)")

---

Tags

filamentfilament-pluginfilament-widgetlaravellaravel-packagewhatsapp-widgetlaraveljeffersongoncalvesfilament-whatsapp-widget

###  Code Quality

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeffersongoncalves-filament-whatsapp-widget/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-filament-whatsapp-widget/health.svg)](https://phpackages.com/packages/jeffersongoncalves-filament-whatsapp-widget)
```

###  Alternatives

[guava/calendar

Adds support for vkurko/calendar to Filament PHP.

298241.0k3](/packages/guava-calendar)[bezhansalleh/filament-google-analytics

Google Analytics integration for FilamentPHP

205144.8k5](/packages/bezhansalleh-filament-google-analytics)[jibaymcs/filament-tour

Bring the power of DriverJs to your Filament panels and start a tour !

12247.8k](/packages/jibaymcs-filament-tour)[marcelweidum/filament-expiration-notice

Customize the livewire expiration notice

9169.0k4](/packages/marcelweidum-filament-expiration-notice)[hydrat/filament-table-layout-toggle

Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts.

6292.3k1](/packages/hydrat-filament-table-layout-toggle)[outerweb/filament-settings

Filament integration for the outerweb/settings package

3690.9k4](/packages/outerweb-filament-settings)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)