Skip to main content

​
Push Notifications

Keep users engaged with intelligent push notifications that deliver timely updates about messages, mentions, channel activities, and community events. Support both direct delivery and webhook customization for maximum flexibility.

​
Overview

social.plus provides comprehensive push notification capabilities that work across iOS, Android, React Native, Flutter, and web platforms. Choose between direct delivery for immediate implementation or webhook integration for custom notification processing.

​
Core Capabilities

  • Real-time Messaging - Instant notifications for new messages and mentions
  • Community Updates - Channel joins, member additions, and activity alerts
  • Cross-platform Support - Consistent experience across all platforms
  • Flexible Delivery - Direct push or webhook customization
  • Smart Targeting - User preferences and channel-specific settings
  • Rich Content - Images, reactions, and contextual information

​
Delivery Methods

Instant Delivery - Notifications sent directly from social.plus servers to user devices.
  • ✅ Zero configuration required
  • ✅ Automatic message formatting
  • ✅ Platform-optimized delivery
  • ✅ Built-in rate limiting
// Enable direct push notifications
await client.enablePushNotifications(deviceToken);

​
Quick Start by Platform

iOS Setup

Configure APNs certificates and integrate with your iOS app

Android Setup

Set up FCM or Baidu push services for Android devices

React Native

Cross-platform notifications for React Native apps

Flutter Setup

Cross-platform push notifications for Flutter applications

Web Setup

Browser push notifications using Service Workers and FCM

​
Notification Types & Examples

​
Message Notifications

EventTitle FormatBody Format
New Message{sender} ({channel})Message content or “Image Message”
Direct Message{sender}Message content or media type
Mention{sender} mentioned youMessage content with highlight

​
Channel Notifications

EventTitle FormatBody Format
Channel Created{channel_name}”You’re now a member of !”
User Joined{user_name}” has joined “
Channel Updated{channel_name}”Channel information updated”

​
Community Notifications

EventTitle FormatBody Format
Community Joined{community_name}”Welcome to !”
New Post{author} in {community}Post content preview
Comment Added{commenter}”Commented on your post”

​
Notification Settings

Users can control their notification preferences at multiple levels: 
// User-level settings
await notificationSettings.updateUserSettings({
  messages: true,
  mentions: true,
  channelActivities: false
});

// Channel-specific settings  
await notificationSettings.updateChannelSettings(channelId, {
  messages: true,
  memberJoined: false
});

User Settings

Global notification preferences

Channel Settings

Per-channel notification control

Community Settings

Community-wide notification rules

​
Architecture Overview

​
Best Practices

User Experience: Always provide users with granular notification controls and respect their preferences to maintain engagement without being intrusive.
  • Permission Timing - Request notification permissions at the right moment in user flow
  • Relevance First - Only send notifications that provide clear value to users
  • Respect Preferences - Honor user settings and provide easy opt-out options
  • Platform Guidelines - Follow iOS and Android notification best practices
  • Testing Strategy - Test across different devices and notification states

​
Platform Support

PlatformDirect PushWebhookRich MediaDeep Links
iOS✅ APNs✅✅✅
Android✅ FCM/Baidu✅✅✅
React Native✅✅✅✅
Flutter✅✅✅✅
Web❌✅✅✅

​
Next Steps

  1. Choose Your Method - Direct push for quick setup, webhook for customization
  2. Platform Setup - Configure certificates and dependencies for your platforms
  3. Test Integration - Verify notifications work across different scenarios
  4. User Settings - Implement notification preference controls
  5. Monitor & Optimize - Track delivery rates and user engagement
Production Setup: Ensure you have proper certificates, tokens, and webhook endpoints configured before deploying to production environments.