README

Filament Automation Bridge

Turn any Eloquent model event into an automation trigger for Zapier, Make, or n8n — without writing code.

Define triggers from your Filament admin panel and instantly connect to Zapier, Make, n8n, or any webhook endpoint. Six trigger types, nine condition operators, native auth per platform, and full delivery monitoring — all without touching a line of integration code.

Installation

composer require ashrafic/filament-automation-bridge
php artisan automation-bridge:install
php artisan migrate

Add the plugin to your PanelProvider:

use Ashrafic\FilamentAutomationBridge\FilamentAutomationBridgePlugin;

$panel->plugin(FilamentAutomationBridgePlugin::make());

Start a queue worker for delivery processing:

php artisan queue:work

Done. An Automation Bridge navigation group appears in your panel.

How It Works

Model Event → Condition Evaluation → Payload Builder → HMAC Sign → Queue → Webhook POST → Delivery Log

A trigger fires — model event, status change, schedule, date condition, manual action, or Laravel event
Conditions are evaluated — 9 operators with AND/OR logic; changed / changed_to operators for update-aware filtering
A payload is built — hand-picked fields, all attributes, or a custom JSON template
The payload is signed — platform-native auth: HMAC, API key, Basic Auth, or Bearer token
The delivery is queued — every call is logged with full request/response details, retried with exponential backoff

Features

Adds an Automation Bridge navigation group to your panel with Triggers, Templates, and Delivery Log.

Feature	Details
6 Trigger Types	Model events, status changes, schedules, date conditions, manual actions, and any Laravel event class
Visual Condition Builder	9 operators (equals, contains, greater/less than, changed, changed_to) with AND/OR logic
4 Destination Types	Zapier, Make, n8n, and Custom webhook — each with native payload formatting
Smart Payload Builder	Summary (selected fields), All (every attribute), or Custom JSON templates with `{{ field }}` placeholders
Platform-Native Auth	Zapier (URL secrecy), Make (x-make-apikey), n8n (API Key / Basic Auth / Bearer Token), HMAC signing
Configurable HTTP Method	GET, POST, PUT, PATCH, or DELETE per trigger
Delivery Monitoring	Full log with status, HTTP code, response body, duration; success-rate tracking per trigger
Automatic Retries	Exponential backoff with configurable retryable HTTP status codes; bulk retry from the UI
Historical Sync	Backfill existing records into any trigger via the queue with progress tracking and cancellation
Health Dashboard Widget	Active triggers, 24h deliveries, success rate (color-coded), recent failures with one-click retry
Templates	Save any trigger configuration and apply it to new models — standardize payloads across your team
Model Discovery	Auto-scans `app/Models/` for Eloquent models; configurable paths and exclusions
Field Schema Analysis	Introspects model attributes and relations (up to 3 levels deep); powers the field picker and payload preview
SSRF Prevention	Blocks webhook calls to localhost and private IP ranges
Sandbox Mode	Capture and log deliveries without sending externally — safe development and testing
Rate Limiting	Per-destination-hostname throttling via Laravel's RateLimiter

Full Guides

Full documentation at docs.ashraficlabs.com/filament-automation-bridge


Getting Started	Full workflow: create triggers, test, monitor deliveries
Installation	Requirements, composer, panel registration, quick start
Configuration	Full config reference — every option
Authorization	6 gates for fine-grained access control
Features Overview	Architecture and capability map
Trigger Types	All 6 trigger types with config and use cases
Conditions	9 operators, AND/OR logic, changed tracking
Destinations	Zapier, Make, n8n, Custom — auth, formatting, HTTP method
Payloads	Summary, All, Custom modes; field mapping; schema analysis
Templates	Save, reuse, and manage trigger configurations
Delivery Monitoring	Delivery log, retries, health widget, retention
Historical Sync	Batch backfill, progress tracking, cancellation
Model Discovery	Auto-scan, cache, HasAutomationTriggers trait
Events	8 dispatchable events for hooks and integrations
Exceptions	7 exception classes with factory methods
Commands	5 artisan commands reference

Screenshots

Triggers Dashboard	Create Trigger

Destination & Payload	Delivery Log

Templates	Delivery Details

Translations

The UI is fully translatable. Publish the language files:

php artisan vendor:publish --tag=filament-automation-bridge-translations

Files are published to resources/lang/vendor/filament-automation-bridge/.

Requirements

PHP 8.2+
Laravel 11+
Filament v4.x / v5.x

Testing

composer test

License

MIT. See LICENSE.md.

Built with precision for professionals.
packages@ashraficlabs.com

ashrafic/filament-automation-bridge

包简介

关键字：

README 文档