FCM push notification arm for Firebase projects. Send, schedule, and manage push notifications from Telegram. Triggers on "push", "notify", "ارسال اشعار", "إشعار", "send notification", "notification history", or when Pigo mentions sending notifications to any Firebase app users/drivers/riders. Also triggers for listing Firebase projects or apps.
Push notification management across Firebase projects.
No notification sends without Pigo's explicit confirmation. Ever.
--dry-run first. Show the preview. Wait for Pigo to say yes.--confirm when Pigo explicitly approves the send.log/.Service account JSON at skills/taxi-fcm/secrets/service-account.json.
All via: node skills/taxi-fcm/scripts/fcm.mjs <command>
| Command | Needs SA? | Needs confirm? |
|---|
list-projects | ✅ | ❌ |
list-apps --project <id> | ✅ | ❌ |
send (with --dry-run) | ❌ | ❌ |
send (without --dry-run) | ✅ | ✅ YES |
schedule --time <when> | ❌ | ❌ (no immediate send) |
history --days N --label X | ❌ | ❌ |
delivery --project X --app Y | ✅ | ❌ |
parse-time --time <str> --tz <tz> | ❌ | ❌ |
--project <id> Firebase project (default: SA project)
--title <str> Notification title
--body <str> Notification body
--image <url> Image URL (1MB max)
--topic <str> Topic target
--token <str> Device token target
--condition <str> Topic condition
--data <json> Custom data payload
--label <str> Analytics label
--tz <timezone> Cairo/Riyadh/Dubai/UTC/IANA
--ttl <seconds>s Time to live
--collapse-key <key> Collapsible message key
--android-channel <id> Notification channel
--android-priority high/normal
--android-icon <name> Drawable icon
--android-color <hex> #rrggbb
--android-click <act> Click action activity
--ios-priority 10/5
--ios-badge <n> Badge count
--ios-click <cat> Category
--web-link <url> Click URL
--dry-run Preview only (SAFE)
--confirm ⚠️ Actually send (REQUIRES Pigo's OK)
Every action is logged. Ask "what pushes did I send this week?" anytime.
Filter by --label or --days.
Full FCM reference: references/fcm-reference.md