/push-notification-tester

name: push-notification-tester
description: >-
  Test VoIP push notifications for Telnyx WebRTC iOS (APNs) and Android (FCM) apps.
  Use when debugging push notification delivery, validating certificate/credential setup,
  or testing that a device receives VoIP pushes correctly.
metadata:
  author: telnyx
  product: webrtc

Push Notification Tester

Send test VoIP push notifications to iOS (APNs) and Android (FCM) devices.

iOS (APNs)

node {baseDir}/scripts/send-ios-push.js \
  --token=<device_token> \
  --bundle-id=<bundle_id> \
  --cert=<path/to/cert.pem> \
  --key=<path/to/key.pem> \
  [--env=sandbox|production] \
  [--caller-name="Test Caller"] \
  [--caller-number="+1234567890"]

Required args

• `--token` — 64-char hex APNs device token
• `--bundle-id` — App bundle ID (e.g. `com.telnyx.webrtc`)
• `--cert` — Path to certificate PEM file
• `--key` — Path to private key PEM file

Optional args

• `--env` — `sandbox` (default) or `production`
• `--caller-name` — Display name (default: "Test Caller")
• `--caller-number` — Phone number (default: "+1234567890")

Android (FCM)

node {baseDir}/scripts/send-android-push.js \
  --token=<fcm_token> \
  --project-id=<firebase_project_id> \
  --service-account=<path/to/service-account.json> \
  [--caller-name="Test Caller"] \
  [--caller-number="+1234567890"]

Required args

• `--token` — FCM device token
• `--project-id` — Firebase project ID
• `--service-account` — Path to service account JSON file

Optional args

• `--caller-name` — Display name (default: "Test Caller")
• `--caller-number` — Phone number (default: "+1234567890")

Output

Both scripts output JSON to stdout:

{"success": true, "message": "Push notification sent successfully", "details": {...}}

{"success": false, "error": "Description of what went wrong"}

Exit code 0 on success, 1 on failure.

Dependencies

Run `npm install` in the `scripts/` directory, or the scripts will auto-install on first run.

• `@parse/node-apn` — APNs client for iOS
• `google-auth-library` — Google OAuth for FCM
• `axios` — HTTP client for FCM API