- How do I integrate this package with an existing Filament admin panel?
- First, ensure Spatie Webhook Client is installed and configured. Then, add the plugin to your `AdminPanelProvider` via the `plugins()` method. Run `php artisan vendor:publish` for config/translations, and the resource will appear in your Filament panel under the configured navigation icon.
- Does this package support Laravel 13 and PHP 8.5?
- Yes, the package is officially tested up to Laravel 13 and PHP 8.5. It also supports Laravel 10–12 and PHP 8.1–8.4, making it compatible with most modern Laravel stacks.
- Can I customize the Filament resource UI for webhook calls?
- The package provides a pre-built resource, but you can extend it by overriding the `WebhookCallResource` class. For deep customization (e.g., custom payload validation UI), you may need to fork the resource or build a custom one.
- What permissions does the package include for webhook calls?
- The package includes a built-in `WebhookCallPolicy` that grants permissions like `viewAny`, `view`, `create`, `update`, and `delete`. These align with Filament’s policy system, so you can easily restrict access by user roles.
- Will this package slow down my Filament dashboard if I have thousands of webhook logs?
- Filament’s resource system handles pagination and lazy-loading by default, but for large datasets, consider archiving old logs or implementing database-level pagination in Spatie’s `WebhookCall` model.
- Do I need to write custom code to handle webhook retries or failures?
- No, the package exposes Spatie’s `WebhookCall` model, which already tracks retries, failures, and statuses. You can view and debug these directly in the Filament resource without additional code.
- Is there a way to test webhooks without sending real requests?
- This package focuses on observability, not testing. For testing, use Spatie’s built-in `WebhookClient` methods (e.g., `sendWebhook`) or tools like Laravel Dusk. For advanced testing, consider third-party tools like Postman or custom scripts.
- Can I use this with Filament 3.x instead of 4.x/5.x?
- No, version 4.x of this package is designed for Filament 4.x/5.x only. For Filament 3.x, use version 1.x of the package, which is explicitly documented for that version.
- What happens if I already have a custom Filament resource for webhooks?
- You’ll need to merge or replace your existing resource. The package provides a full `WebhookCallResource`, so conflicts may arise if your custom UI relies on overlapping functionality. Test thoroughly before migration.
- Are there alternatives if I don’t want to use Spatie Webhook Client?
- This package is tightly coupled with Spatie’s `laravel-webhook-client`. If you’re not using Spatie, alternatives include building a custom Filament resource for your webhook model or using third-party tools like Pipedream or Zapier for external webhook management.