zello-background

Configure Zello FCM push, foreground services, and battery optimisation for background PTT on Android.

Updated May 20, 2026
One-click install
npx skills add https://github.com/TechCorp25/kingdom --skill zello-background-techcorp25
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: zello-background
Source: https://github.com/TechCorp25/kingdom/tree/main/.claude/skills/use-zello/zello-background
Command: npx skills add https://github.com/TechCorp25/kingdom --skill zello-background-techcorp25

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @react-native-firebase/messaging, expo-notifications.

What problem does it solve? Keeping Zello push-to-talk alive in the background during extended officer patrols is difficult because Android kills background services and Zello requires native FCM wake-up alongside the app's existing Expo Push notification system. ## Core Features & Use Cases - Dual Push Coexistence: Run Zello's native FCM messaging via @react-native-firebase/messaging alongside Expo Push Tokens from expo-notifications without conflicts. - Foreground Service Management: Maintain Zello's Android foreground service with its persistent notification so the audio connection survives backgrounding. - Battery Optimisation Prompting: Prompt officers to disable battery optimisation so the OS does not kill the PTT service during long patrols. - Use Case: An officer on an eight-hour patrol receives a PTT call while the app is backgrounded; the Zello FCM message wakes the SDK and the audio stream starts without the officer opening the app. ## Quick Start Set up Zello background push so FCM wake-up works alongside my existing Expo Push notifications in the React Native app.

Frequently Asked Questions about zello-background

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Zello PTT working in the background on Android?▼

Zello runs an Android foreground service that maintains the audio connection and shows a persistent notification. You must also register a Firebase background message handler with @react-native-firebase/messaging so FCM can wake the SDK for incoming PTT calls.

Can Zello FCM and Expo Push Notifications work together?▼

Yes, both systems share the same Firebase project but handle messages independently. Zello intercepts its own FCM data payloads automatically, while non-Zello messages pass through to expo-notifications for dispatch alerts and system notifications.

Why does Zello stop receiving calls during long patrols?▼

Android battery optimisation kills the foreground service during extended use. Officers must disable battery optimisation for the app in Android settings, which the app can prompt for on startup using a Linking.openSettings() dialog.

Should I replace expo-notifications with Firebase messaging for all notifications?▼

No, the two systems serve different purposes. Keep expo-notifications for app-level dispatch alerts and system notifications, and let Zello handle its own FCM registration internally after connect() is called.

What permissions does Zello background push require on Android?▼

The POST_NOTIFICATIONS permission must be granted so the foreground service notification displays. The google-services.json file must also match the app's package name, such as au.melbourne.patrolzones, for FCM delivery to work.