Stage 13 — Notifications: Telegram bot + multi-channel + service reminders
Schema:
- clients.telegram_chat_id (linked via /start contact-share)
- clients.notify_prefs (per-client channel order override)
- service_reminders_sent (dedup ledger for the daily cron)
Telegram (per tenant):
- TelegramService (sendMessage, getMe, setWebhook with auto-generated secret)
- Bot token stored in companies.settings.telegram.bot_token
- Webhook /telegram/webhook/{slug} validates X-Telegram-Bot-Api-Secret-Token,
matches client by last 9 digits of phone, persists chat_id, replies confirm
- /start prompts share-contact; /stop unlinks chat_id
NotificationDispatcher refactor:
- Multi-channel: telegram first if chat_id + bot configured, then email
- Backwards-compat with legacy boolean notify.{type} flags
- 4 HTML-formatted Telegram messages (wo_ready with tracking link, payment,
appointment, reminder)
Service reminders:
- `reminders:send` artisan command with --slug / --dry-run
- Policy: vehicles whose last closed WO is older than reminder.after_days
(default 365). Skips if sent within reminder.cooldown_days (default 30).
- Schedule daily 09:00
Filament UI:
- Settings page: Telegram bot token field + "Test bot" + "Set webhook" actions
- Settings page: reminder_after_days + reminder_cooldown_days inputs
- ClientResource: telegram_chat_id readonly badge
Tests (6 new, all pass):
- webhook links client via shared contact
- webhook rejects wrong secret → 401
- dispatcher uses telegram when chat_id present (Http::fake)
- dispatcher falls back to email otherwise
- dispatcher returns false when no channel available
- reminder cron respects 30-day cooldown
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -2,7 +2,9 @@
|
||||
|
||||
namespace App\Filament\Tenant\Pages;
|
||||
|
||||
use App\Services\Notifications\TelegramService;
|
||||
use App\Tenancy\TenantManager;
|
||||
use Filament\Actions;
|
||||
use Filament\Forms;
|
||||
use Filament\Notifications\Notification;
|
||||
use Filament\Pages\Page;
|
||||
@@ -50,6 +52,9 @@ class Settings extends Page
|
||||
'notify_payment' => $notify['payment'] ?? true,
|
||||
'notify_appointment' => $notify['appointment'] ?? true,
|
||||
'notify_reminder' => $notify['reminder'] ?? true,
|
||||
'telegram_bot_token' => data_get($settings, 'telegram.bot_token'),
|
||||
'reminder_after_days' => data_get($settings, 'reminder.after_days', 365),
|
||||
'reminder_cooldown_days' => data_get($settings, 'reminder.cooldown_days', 30),
|
||||
'ai_default_provider' => $settings['ai']['default_provider'] ?? 'claude',
|
||||
'ai_claude_key' => $settings['ai']['claude_key'] ?? null,
|
||||
'ai_gpt_key' => $settings['ai']['gpt_key'] ?? null,
|
||||
@@ -126,8 +131,8 @@ class Settings extends Page
|
||||
->maxSize(512)
|
||||
->helperText('PNG/ICO, max 512 KB.'),
|
||||
]),
|
||||
Schemas\Components\Section::make('Notificări email')
|
||||
->description('Activează / dezactivează emailurile auto către clienți.')
|
||||
Schemas\Components\Section::make('Notificări')
|
||||
->description('Activează / dezactivează notificările auto către clienți. Telegram are prioritate dacă clientul are cont legat.')
|
||||
->columns(2)
|
||||
->schema([
|
||||
Forms\Components\Toggle::make('notify_wo_ready')->label('Mașina e gata de ridicat')->default(true),
|
||||
@@ -135,6 +140,33 @@ class Settings extends Page
|
||||
Forms\Components\Toggle::make('notify_appointment')->label('Programare confirmată')->default(true),
|
||||
Forms\Components\Toggle::make('notify_reminder')->label('Reminder ITP / revizie')->default(true),
|
||||
]),
|
||||
Schemas\Components\Section::make('Telegram bot')
|
||||
->description('Creează un bot la @BotFather, lipește token-ul aici și apasă „Setează webhook". Clienții îți scriu la bot, partajează telefonul, iar codul se leagă automat de fișa lor.')
|
||||
->columns(1)
|
||||
->schema([
|
||||
Forms\Components\TextInput::make('telegram_bot_token')
|
||||
->label('Bot token')
|
||||
->password()
|
||||
->revealable()
|
||||
->placeholder('123456:ABC-XYZ...')
|
||||
->helperText(fn () => 'Webhook URL: ' .
|
||||
app(\App\Services\Notifications\TelegramService::class)
|
||||
->webhookUrlFor(app(\App\Tenancy\TenantManager::class)->current())),
|
||||
]),
|
||||
Schemas\Components\Section::make('Reminder service auto')
|
||||
->columns(2)
|
||||
->schema([
|
||||
Forms\Components\TextInput::make('reminder_after_days')
|
||||
->label('Trimite reminder după X zile fără vizită')
|
||||
->numeric()
|
||||
->minValue(30)
|
||||
->default(365),
|
||||
Forms\Components\TextInput::make('reminder_cooldown_days')
|
||||
->label('Nu re-trimite mai des de X zile')
|
||||
->numeric()
|
||||
->minValue(7)
|
||||
->default(30),
|
||||
]),
|
||||
Schemas\Components\Section::make('Asistent AI')
|
||||
->description('Adaugă chei API ca să activezi asistentul. Cheile rămân la voi — nu sunt partajate.')
|
||||
->columns(2)
|
||||
@@ -178,6 +210,14 @@ class Settings extends Page
|
||||
'appointment' => (bool) ($data['notify_appointment'] ?? true),
|
||||
'reminder' => (bool) ($data['notify_reminder'] ?? true),
|
||||
],
|
||||
'telegram' => array_replace(
|
||||
(array) data_get($company->settings, 'telegram', []),
|
||||
['bot_token' => $data['telegram_bot_token'] ?? null]
|
||||
),
|
||||
'reminder' => [
|
||||
'after_days' => (int) ($data['reminder_after_days'] ?? 365),
|
||||
'cooldown_days' => (int) ($data['reminder_cooldown_days'] ?? 30),
|
||||
],
|
||||
'ai' => [
|
||||
'default_provider' => $data['ai_default_provider'] ?? 'claude',
|
||||
'claude_key' => $data['ai_claude_key'] ?? null,
|
||||
@@ -201,4 +241,51 @@ class Settings extends Page
|
||||
|
||||
Notification::make()->title('Setări salvate')->success()->send();
|
||||
}
|
||||
|
||||
protected function getHeaderActions(): array
|
||||
{
|
||||
return [
|
||||
Actions\Action::make('telegram_test')
|
||||
->label('Testează bot Telegram')
|
||||
->icon('heroicon-m-bolt')
|
||||
->color('gray')
|
||||
->action(function () {
|
||||
$company = app(TenantManager::class)->current();
|
||||
if (! $company) return;
|
||||
$r = app(TelegramService::class)->getMe($company);
|
||||
if (! ($r['ok'] ?? false)) {
|
||||
Notification::make()
|
||||
->title('Bot Telegram nu răspunde')
|
||||
->body($r['error'] ?? 'Verifică token-ul.')
|
||||
->danger()->send();
|
||||
return;
|
||||
}
|
||||
$name = data_get($r, 'response.result.username', '?');
|
||||
Notification::make()
|
||||
->title("Bot OK: @{$name}")
|
||||
->success()->send();
|
||||
}),
|
||||
Actions\Action::make('telegram_webhook')
|
||||
->label('Setează webhook')
|
||||
->icon('heroicon-m-link')
|
||||
->color('primary')
|
||||
->requiresConfirmation()
|
||||
->modalDescription('Telegram va trimite mesajele primite la URL-ul webhook de mai jos.')
|
||||
->action(function () {
|
||||
$company = app(TenantManager::class)->current();
|
||||
if (! $company) return;
|
||||
$r = app(TelegramService::class)->setWebhook($company);
|
||||
if (! ($r['ok'] ?? false)) {
|
||||
Notification::make()
|
||||
->title('Webhook eșuat')
|
||||
->body($r['error'] ?? json_encode($r['response'] ?? []))
|
||||
->danger()->send();
|
||||
return;
|
||||
}
|
||||
Notification::make()
|
||||
->title('Webhook setat — botul e gata')
|
||||
->success()->send();
|
||||
}),
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
@@ -73,6 +73,14 @@ class ClientResource extends Resource
|
||||
Forms\Components\TextInput::make('phone_alt')->label('Telefon alternativ')->tel()->maxLength(40),
|
||||
Forms\Components\TextInput::make('email')->email()->maxLength(120),
|
||||
Forms\Components\TextInput::make('telegram')->maxLength(60),
|
||||
Forms\Components\TextInput::make('telegram_chat_id')
|
||||
->label('Telegram chat ID')
|
||||
->disabled()
|
||||
->dehydrated(false)
|
||||
->placeholder('Se completează automat când clientul scrie la bot')
|
||||
->helperText(fn ($record) => $record?->telegram_chat_id
|
||||
? '✅ Telegram legat — notificările vor merge prin bot'
|
||||
: null),
|
||||
Forms\Components\TextInput::make('whatsapp')->maxLength(60),
|
||||
Forms\Components\TextInput::make('viber')->maxLength(60),
|
||||
]),
|
||||
|
||||
Reference in New Issue
Block a user