​

Notification System

​

Notification Types

​

1. Order Notifications

• New order received
• Order status updates
• Payment confirmations
• Delivery notifications

​

2. Store Notifications

• New customer reviews
• Low inventory alerts
• Payout notifications
• System updates

​

3. Customer Notifications

• Order updates
• Price changes
• New products from followed stores
• Social interactions

​

4. Admin Notifications

• Store approval requests
• Payout processing
• System alerts
• Moderation flags

​

Push Notification Setup

​

FCM (Firebase Cloud Messaging)

// Record device token
await convex.mutation(api.shared.notifications.recordNativeDeviceToken, {
  token: "fcm_token_here",
  platform: "android"
});

​

APNs (Apple Push Notifications)

// Record iOS device token
await convex.mutation(api.shared.notifications.recordNativeDeviceToken, {
  token: "apns_token_here", 
  platform: "ios"
});

​

Sending Notifications

​

Direct FCM

await convex.mutation(api.shared.notifications.sendFCMNotificationDirect, {
  token: "device_token",
  title: "New Order!",
  body: "You have received a new order",
  data: { orderId: "order_123" }
});

​

Direct APNs

await convex.mutation(api.shared.notifications.sendAPNsNotificationDirect, {
  token: "device_token",
  title: "Order Update",
  body: "Your order status has changed",
  data: { orderId: "order_123" }
});

​

Notification Features

​

Scheduled Notifications

• Send notifications at specific times
• Recurring notifications
• Timezone-aware scheduling

​

Bulk Notifications

• Send to multiple users
• Targeted notifications
• A/B testing support

​

Notification History

• Track all sent notifications
• Delivery status monitoring
• Analytics and insights

​

Best Practices

1. Personalization: Use customer data for relevant notifications
2. Timing: Send notifications at appropriate times
3. Frequency: Don’t overwhelm users with too many notifications
4. Content: Keep messages clear and actionable
5. Testing: Always test notifications before sending