Download the PHP package spokospace/filament-ops-notify without Composer
On this page you can find all versions of the php package spokospace/filament-ops-notify. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download spokospace/filament-ops-notify
More information about spokospace/filament-ops-notify
Files in spokospace/filament-ops-notify
Package filament-ops-notify
Short Description Operational notifications (inquiries, errors, builds) for Laravel + Filament panels, delivered to Telegram forum topics.
License MIT
Homepage https://github.com/spokospace/filament-ops-notify
Informations about the package filament-ops-notify
Filament Ops Notify
Operational notifications for Laravel + Filament panels: inquiries, errors and builds, delivered to Telegram forum topics. Built on Laravel notifications, so existing Filament database notifications reach Telegram with no code changes.
Features
- Bell notifications → Telegram, no code. Every
sendToDatabase()notification is forwarded once, however many users receive it (with a shared cache). - Any Laravel notification, too. Apps without the bell can forward mail, SMS or push notifications, once each and without secrets such as password reset links.
- Topics and routing. Create forum topics from the panel and route events to them by pattern
(
inquiry.*→ Inquiries). Filament notifications are routed by title. - Settings in the panel. Token (encrypted), chat id, service name, topics and rules, all without
touching
.env. - Message templates. Change an event's title, body, fields and hashtag by pattern in config
(
inquiry.*→ New inquiry from :field.Name); the panel switches the[service]prefix and the#eventline (Message templates). - Reliable delivery. Queued, retried, rate-limit aware, and never breaks the request that sent it.
- Bot profile. Pick an avatar (a preset or your own) and set the display name and descriptions from the panel.
- Translated. The panel ships in 25 languages, and a separate setting controls the language of the messages.
- History. Every message is logged with its status and Telegram error, and failed ones can be resent.
opsnotification channel and a fluentOpsMessagefor events that are not bell notifications.
Screenshots
In Telegram: a build as the bot reports it to the Builds topic, started and then completed,
with the [service] prefix, bold field labels, the #event hashtag and a button on each message.
The Ops Notify page: the Telegram connection, where messages are delivered (queue and Horizon state), and the history of every message sent, with failed ones ready to resend.
Settings: bot token, chat id and message language, forum topics that can be created in Telegram or imported from it, routing rules and forwarding rules. Filled lists collapse to a one-line summary.
Bot profile: pick a preset avatar or upload your own, and set the name and descriptions Telegram shows.
Requirements
- PHP 8.3 / 8.4 / 8.5
- Laravel 12 / 13
- Filament 5
Installation
Then say who may use it. Until you do, the page opens only in the local environment:
manageOpsNotify can limit Settings, Bot profile, Send test and Resend further. See
Who may use it.
Delivery runs on the queue, so the app needs a worker (Horizon or queue:work) and the scheduler.
Quick start
- Create a bot with @BotFather and a Telegram group with Topics turned on. Add the bot and promote it to admin.
- In the panel, open Ops Notify → Settings and enter the bot token and chat id.
- Press Send test.
The setup checklist has every step in order. Installing with an AI coding agent? Give it Installing with an AI agent.
Your existing Filament notifications now reach Telegram. To send something yourself:
In Telegram it reads:
with an Open site button below. The title and field labels are bold.
Documentation
- Setup checklist: what to set up, in order, the rights the bot needs, and instructions for AI agents
- Installation: requirements, migrations, plugin options
- Telegram setup: bot, group, topics, finding the chat id, bot profile
- Settings: panel vs
.env, every option, languages, the Ops Notify page - Routing and topics: topics, event rules, forwarding Filament notifications
- Sending messages: the
opschannel, theOpsMessageAPI, message templates, delivery, tests - Drivers: writing your own channel driver
- Troubleshooting: common Telegram and queue errors and fixes
Testing
Credits
Built and maintained by spoko.space, where it runs in production on our own Filament panels. There's a case study with the story and screenshots behind it.
License
MIT, see LICENSE.md.
All versions of filament-ops-notify with dependencies
filament/filament Version ^5.0
illuminate/contracts Version ^12.0|^13.0
spatie/laravel-package-tools Version ^1.16