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.
Use publicly reachable HTTPS endpoints; avoid including query secrets in the URL.
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.
Turning the master toggle OFF immediately disables all push events (Chat, Social, Story).
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