Configure webhooks and push notification infrastructure to stream real-time events and engage users reliably.
Webhooks
Deliver real-time events to your backend
Certificates
Upload APNs / FCM credentials
Events
Select push-notifiable actions
Custom Payloads
Tailor notification content
Rotation
Renew expiring notification certs
Monitoring
Track delivery & failures
Webhooks
Need full event catalog, payload schema, retry logic, and signature details? See the complete reference: Webhook Events Reference.
1
Add Endpoint
Enter HTTPS URL in Webhook section.
2
Secret Issued
Console generates secret key tied to that URL.
3
Validate Signature
Configure backend to verify HMAC (secret) per event.
4
Rotate Secret
Delete & re-add endpoint if compromise suspected.
Best Practices
Best Practices
Idempotent processing, 200 fast ACK then async work, exponential retry logic on your side.
Security
Security
Restrict IPs if possible; verify signature before queuing work.
Versioning
Versioning
Include event schema version in payload to future‑proof consumers.
Push Notification Certificates
More than one certificate can be stored per platform (e.g., staging + production) but only one active at a time per platform/provider.| Field | Platform Scope | Purpose |
|---|---|---|
| Certificate Name | All | Internal tracking label |
| Platform | iOS / Android | Target OS |
| Provider (Android) | Android | Firebase / Baidu selection |
| API Key / Secret (Android) | Android | Credentials for chosen provider |
| .p12 Upload | iOS | APNs authentication material |
| Credential Password | iOS | Password for p12 if set |
1
Prepare Credential
Obtain APNs p12 or FCM/Baidu server keys.
2
Upload
Console → Settings → Integrations → Certificates → Upload.
3
Activate
Set active certificate for environment (staging / prod pattern).
4
Verify
Send test notification to confirm delivery.
Keep staging & production clearly labeled to avoid cross‑environment delivery errors.
Network Level Push Settings
- Enable
- Select Events
- Prerequisites
Toggle Network Notification Settings ON to allow any push events. Only Super / General Admins can change.
Custom Push Message
Define templates or overrides per event type if supported. Keep copies concise (<140 chars) and actionable.Localization
Localization
Store translation keys instead of raw strings; expand at client side.
Personalization
Personalization
Include displayName when appropriate but avoid sensitive content in payload.
Rate Limiting
Rate Limiting
Throttle bursts to prevent notification fatigue.
Monitoring & Metrics
| Metric | Description | Trigger |
|---|---|---|
| Delivery Success % | Successful pushes / total | Drop < 95% → inspect certs & provider status |
| Cert Days to Expiry | Soonest certificate expiry | < 30 days → schedule renewal |
| Event Coverage | Enabled events / intended events | Gap → enable missing categories |
| Webhook Failure Rate | 4xx/5xx responses / total deliveries | > 2% → investigate endpoint health |
Troubleshooting
| Issue | Likely Cause | Fix |
|---|---|---|
| No push delivered | Inactive certificate | Activate correct cert; test again |
| Some events silent | Event toggle off | Enable event in Network Settings |
| Webhook 401 errors | Secret mismatch | Regenerate secret and update backend |
| Elevated retries | Endpoint latency | Optimize processing / return 200 quickly |
| Duplicate notifications | Missing idempotency | Track delivery IDs, discard repeats |
Quick Reference
Master Toggle
Enables all downstream events
Active Cert
One per platform
Rotate Window
Renew ≥30 days before expiry
Webhook Security
Verify signature HMAC