Skip to Content
Platform.Ontology

VoIP push (PushKit) and call-style wakeups

A special push that wakes the app for a call; iOS demands it shows a call UI right away.

Works without askingNotifications and backgroundPushAndroid and iPhoneIn the background

In one line

Can wake the app right away for a call, if it shows a call screen

A special push that wakes the app for a call; iOS demands it shows a call UI right away.

Used for real-time calls, the strongest wake-up either platform offers. Misuse for silent tracking got apps cut off on iOS 13, so both platforms now tie it to a visible call screen.

What it can and can't do

What the user does: Nothing. It happens when someone calls you through the app

It can

  • Wake the app for an incoming call, even when closed
  • Show the call screen on iPhone with CallKit
  • Use a full screen call alert on Android

It cannot

  • Use call pushes for non call alerts on iPhone; Apple requires a call screen right away
  • Show a full screen alert on Android 14 or newer for non calling apps without your grant
  • Send more than 5 KB on iPhone, or 4 KB on Android

How it differs between platforms: iPhone requires Apple approval and a call screen at once. Android uses normal high priority push plus a call screen.

On Android and iPhone

AndroidiPhone
StatusSupportedBehind a flag
First versionAndroid 8.0iOS 8.0
Permission or entitlementMANAGE_OWN_CALLS or telecom ConnectionService; USE_FULL_SCREEN_INTENT; FOREGROUND_SERVICE_PHONE_CALL (API 34)voip UIBackgroundModes; PushKit VoIP certificate; apns-push-type voip; CallKit
Protection levelnormalentitlement
How access is grantedinstallentitlement
What the user seesCall UI; full screen intent needs grant on 14+ for non calling appsIncoming call UI via CallKit
How long it lastsHigh priority FCM data message wakes the app even in DozeFrom iOS 13 each VoIP push must report a CallKit call; repeated failure stops further VoIP pushes
How to take it backSettings > Apps > Special accessSettings > Notifications; remove VoIP entitlement
Store policyPlay policy: full-screen intent only for calling and alarm apps (Android 14)App Review 2.5.4; VoIP only for real VoIP calling
APITelecomManager.addNewIncomingCall, ConnectionServicePKPushRegistry, CXProvider.reportNewIncomingCall
NotesNo separate payload limit beyond FCM 4 KBVoIP payload up to 5120 bytes; apns-priority 10

Data you get

What comes back: Call wakeup
Shape: event
How often: Per call

FieldTypeUnitRangePrecision
payloadbinarybinary0 to 5120 (iOS), 0 to 4096 (FCM)exact

Technical limits

  • Must show a call UI
  • iOS revokes pushes if apps do not report a call

The story

What it is

A special push that wakes an app for a call, and must show a call screen right away.

For you

Your phone rings with a full call screen, even if the app was closed. If an app wakes this way without a call, iOS will stop letting it.

For makers

Makers get the strongest wake up for real time calls. Misuse as a secret wake up got apps cut off, so both systems now tie it to a visible call.

Where you see it

TypeExampleApps
messagingA WhatsApp or FaceTime style call rings your locked phone.WhatsApp, FaceTime
socialA group video chat pings you to join a live room.Discord, Zoom
gamesA voice chat for a squad rings you when your friends start a match.Discord
enterpriseA contact center app rings a work phone with a customer call.Microsoft Teams
healthA telehealth app rings the patient as the doctor joins the visit.None named
securityA smart doorbell rings you like a call when someone is at the door.Ring
rideshareA driver call bridge rings a hidden number for the rider.Uber

Risks

  • Past abuse as a covert wake up
  • Can pull the app out of sleep

Android and iPhone in short

  • Android: On Android, full screen alerts need a grant for non calling apps.
  • iPhone: iOS needs a call screen right away through CallKit.

What the platform says

  • Apple: PushKit and VoIP. Apple documents VoIP pushes as the way for calling apps to wake and show an incoming call screen.

Good uses and abuse

Legitimate uses

  • VoIP calls

Known abuse

  • Using VoIP pushes as a covert wakeup

Scores

ScoreValueMeaning
Sensitivity3 of 5How revealing the data is
Utility4 of 5How useful it is to honest apps
Friction3 of 5How much the user has to do
Fingerprint bitsNot ratedRough identifying entropy, when known

History

  • 2019-09, iPhone iOS 13: Every VoIP push must report a CallKit call or PushKit pushes stop
  • 2023-10, Android 14 (API 34): USE_FULL_SCREEN_INTENT limited to calling and alarm apps; FGS type phoneCall requires its own permission

Same idea on the web

Sources

How well checked: Based on official documentation.

On this page