PHPackages alkoumi/filament-n8n-chat - 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. alkoumi/filament-n8n-chat ActiveLibrary[Utility & Helpers](/categories/utility) alkoumi/filament-n8n-chat ========================= A seamless integration of n8n chat widget into your FilamentPHP applications v1.0.1(5mo ago)8101↑50%1MITPHPPHP ^8.2 Since Jan 22Pushed 5mo agoCompare [ Source](https://github.com/alkoumi/filament-n8n-chat)[ Packagist](https://packagist.org/packages/alkoumi/filament-n8n-chat)[ Docs](https://github.com/alkoumi/filament-n8n-chat)[ RSS](/packages/alkoumi-filament-n8n-chat/feed)WikiDiscussions main Synced today READMEChangelog (2)Dependencies (4)Versions (3)Used By (0) [![Total Downloads](https://camo.githubusercontent.com/3ae102384164cb689f2aa02e5d27324f7102d692f6e65ca594e6421e3e350059/68747470733a2f2f706f7365722e707567782e6f72672f616c6b6f756d692f66696c616d656e742d6e386e2d636861742f646f776e6c6f616473)](https://packagist.org/packages/alkoumi/filament-n8n-chat)[![Packagist Stars](https://camo.githubusercontent.com/85d3aa08492a328384e5387db66f9357dc65951e0a2c5af88c7002b549ca4b6d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f616c6b6f756d692f66696c616d656e742d6e386e2d636861743f636f6c6f723d79656c6c6f77)](https://camo.githubusercontent.com/85d3aa08492a328384e5387db66f9357dc65951e0a2c5af88c7002b549ca4b6d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f73746172732f616c6b6f756d692f66696c616d656e742d6e386e2d636861743f636f6c6f723d79656c6c6f77)[![License](https://camo.githubusercontent.com/582b3fc8088077065c3afafd3a841cb2a174f6677d5f865e0a1dd104050dafb6/68747470733a2f2f706f7365722e707567782e6f72672f616c6b6f756d692f66696c616d656e742d6e386e2d636861742f6c6963656e7365)](https://packagist.org/packages/alkoumi/filament-n8n-chat)[![Latest Version on Packagist](https://camo.githubusercontent.com/e2617d9ad20b354753192f8fc4c3a1f9338e031a73d97c291d30af2ceebeedd4/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616c6b6f756d692f66696c616d656e742d6e386e2d636861742e737667)](https://packagist.org/packages/alkoumi/filament-n8n-chat)[![GitHub release (latest by date)](https://camo.githubusercontent.com/3b308d02cc913ca0b7bdebcb052f1462e09682ae41cf028ee41480f1cd2fdd59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f616c6b6f756d692f66696c616d656e742d6e386e2d63686174)](https://camo.githubusercontent.com/3b308d02cc913ca0b7bdebcb052f1462e09682ae41cf028ee41480f1cd2fdd59/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f616c6b6f756d692f66696c616d656e742d6e386e2d63686174) Filament N8n Chat Plugin ======================== [](#filament-n8n-chat-plugin) A seamless integration of n8n chat widget into your FilamentPHP applications with full multilingual support and theme customization. Features -------- [](#features) - 🚀 Full compatibility with FilamentPHP v4 & v5 - 🌍 Multilingual support (Arabic, English, and more) - 💬 Full n8n chat functionality - 🎨 Custommizable themes with updating config colors - 🔧 Simplified configuration - 📱 Fully responsive design with RTL support - 🔐 Authentication-aware display options Requirements ------------ [](#requirements) - PHP 8.2+ - Laravel 11.x - FilamentPHP 4.x - Livewire 3.x (auto-installed with Filament) Installation ------------ [](#installation) ### Step 1: Install via Composer [](#step-1-install-via-composer) ``` composer require alkoumi/filament-n8n-chat ``` ### Step 2: Publish Configuration and Translations [](#step-2-publish-configuration-and-translations) ``` php artisan vendor:publish --tag="filament-n8n-chat-config" php artisan vendor:publish --tag="filament-n8n-chat-translations" ``` ### Step 3: Add Environment Variables or Your config.filament-n8n-chat [](#step-3-add-environment-variables-or-your-configfilament-n8n-chat) Add your n8n webhook URL to your `.env` file: or in config.filament-n8n-chat ``` N8N_CHAT_ENABLED=true N8N_CHAT_WEBHOOK_URL=https://your-n8n-instance.com/webhook/your-webhook-id ``` Usage ----- [](#usage) ### Basic Setup [](#basic-setup) #### Method 2: Plugin Registration (Advanced) [](#method-2-plugin-registration-advanced) Register the plugin in your Panel Provider for more control: ``` // app/Providers/Filament/AdminPanelProvider.php use Alkoumi\FilamentN8nChat\FilamentN8nChatPlugin; public function panel(Panel $panel): Panel { return $panel ->default() ->id('admin') ->path('admin') // ... other configurations ->plugins([ FilamentN8nChatPlugin::make() ->config(function () { $lang = app()->getLocale() ?? 'ar'; return [ 'defaultLanguage' => $lang, 'initialMessages' => $lang === 'ar' ? [ 'أنا مساعد الذكاء الإصطناعي', 'آمر، كيف أخدمك 💐', ] : [ 'Hello! I am your AI assistant', 'How can I help you today?', ], 'i18n' => [ 'en' => [ 'title' => 'Hi there! 👋', 'subtitle' => 'I am AI assistant', 'footer' => '', 'getStarted' => 'New Conversation', 'inputPlaceholder' => 'How can I help you today?', ], 'ar' => [ 'title' => 'مرحبًا بك 💐', 'subtitle' => 'أنا مساعد الذكاء الإصطناعي', 'footer' => '', 'getStarted' => 'محادثة جديدة', 'inputPlaceholder' => 'آمر، كيف أقدر أخدمك 💐', ], ], ]; }), ]); } ``` Configuration ------------- [](#configuration) ### Simplified Configuration with i18n Support [](#simplified-configuration-with-i18n-support) ``` Just take alook in // config/filament-n8n-chat.php ``` Advanced Usage -------------- [](#advanced-usage) ### Conditional Display [](#conditional-display) Show chat only for specific user roles: ``` FilamentN8nChatPlugin::make() ->enabled(fn () => auth()->user()?->hasRole('admin')) ``` ### Dynamic Configuration [](#dynamic-configuration) Configure based on current user: ``` FilamentN8nChatPlugin::make() ->config(function () { return [ 'initialMessages' => auth()->check() ? 'Welcome back, ' . auth()->user()->name . '!' : 'Hello! How can I help you?', ]; }) ``` ### Custom Styling [](#custom-styling) You can customize the chat widget appearance by adding custom config options. ### JavaScript Events [](#javascript-events) Listen to chat events: ``` window.addEventListener('n8n-chat-ready', (event) => { console.log('N8n chat is ready!', event.detail.chat); }); // Programmatically control the chat window.openN8nChat(); window.closeN8nChat(); window.toggleN8nChat(); window.sendN8nMessage('Hello from code!'); ``` N8n Workflow Setup ------------------ [](#n8n-workflow-setup) ### Basic Webhook Setup [](#basic-webhook-setup) 1. Create a new workflow in n8n 2. Use chat trigger 3. Make Chat Publicly Available 4. Copy Chat URL (this will be your webhook URL) 5. Now you can use the plugin to integrate chat into your FilamentPHP application! Troubleshooting --------------- [](#troubleshooting) ### Chat Widget Not Appearing [](#chat-widget-not-appearing) 1. Check if the plugin is enabled in config 2. Verify the webhook URL is set correctly 3. Check browser console for JavaScript errors Security Considerations ----------------------- [](#security-considerations) 1. **Use HTTPS**: Always use HTTPS for your webhook URLs 2. **Validate Input**: Sanitize and validate all user input in your n8n workflows 3. **Rate Limiting**: Implement rate limiting in your n8n workflows 4. **Authentication**: Use the user metadata feature to track users 5. **Environment Variables**: Never commit webhook URLs to version control Support ------- [](#support) - [GitHub Issues](https://github.com/alkoumi/filament-n8n-chat/issues) - [Discussions](https://github.com/alkoumi/filament-n8n-chat/discussions) Contributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. 1. Fork the repository 2. Create your feature branch (`git checkout -b feature/amazing-feature`) 3. Commit your changes (`git commit -m 'Add some amazing feature'`) 4. Push to the branch (`git push origin feature/amazing-feature`) 5. Open a Pull Request Credits ------- [](#credits) - [Alkoumi](https://github.com/alkoumi) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 39 — LowBetter than 84% of packages Maintenance71 Regular maintenance activity Popularity19 Limited adoption so far Community7 Small or concentrated contributor base Maturity48 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% 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 ~0 days Total 2 Last Release 163d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/7347145dd8f0802bd4458a339dd6ed9431c4e2533ba3e8808137c706cef1f5a4?d=identicon)[alkoumi](/maintainers/alkoumi) --- Top Contributors [![alkoumi](https://avatars.githubusercontent.com/u/10585943?v=4)](https://github.com/alkoumi "alkoumi (5 commits)") --- Tags laravelwidgetchatfilamentchatbotn8nalkoumi ### Code Quality TestsPest ### Embed Badge ![Health badge](/badges/alkoumi-filament-n8n-chat/health.svg) ``` [![Health](https://phpackages.com/badges/alkoumi-filament-n8n-chat/health.svg)](https://phpackages.com/packages/alkoumi-filament-n8n-chat) ``` ### Alternatives [ysfkaya/filament-phone-input A phone input component for Laravel Filament 3161.3M25](/packages/ysfkaya-filament-phone-input)[rawilk/profile-filament-plugin Profile & MFA starter kit for filament. 3914.6k](/packages/rawilk-profile-filament-plugin)[stephenjude/filament-feature-flags Filament implementation of feature flags and segmentation with Laravel Pennant. 122177.8k1](/packages/stephenjude-filament-feature-flags)[stephenjude/filament-jetstream A Laravel starter kit built with Filament inspired by Jetstream. 17760.2k3](/packages/stephenjude-filament-jetstream)[stephenjude/filament-two-factor-authentication Filament Two Factor Authentication: Google 2FA + Passkey Authentication 84215.9k9](/packages/stephenjude-filament-two-factor-authentication)[marcelweidum/filament-passkeys Use passkeys in your filamentphp app 6649.5k1](/packages/marcelweidum-filament-passkeys) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)