Notification Tray
Notification Events Reference
Complete reference guide for supported notification event types, triggers, and message templates
This reference guide provides comprehensive information about the notification event types supported by the social.plus SDK. Each event type has specific triggers, recipients, and message templates that define how notifications are generated and delivered to users.
This documentation reflects the exact supported notification events and message templates as implemented in the social.plus SDK. Only the events listed below are currently supported.
Event Types
Complete catalog of supported notification event types
Message Templates
Predefined message formats for each event type
Triggers & Recipients
When notifications are triggered and who receives them
Grouping Logic
How similar notifications are grouped together
Supported Event Types
The notification tray supports the following event types with specific triggers and message templates:Content Creation & Activity
- Post creation (Text, Image, Video)
- Poll creation
- Comments on posts
- Replies to comments
Content Creation Events
Post Events
post
post
Event Type: Grouped Events (2 actors):Grouped Events (3+ actors):Grouping Logic:
post (Text, Image, Video)Trigger: When a user creates a post in a communityRecipients: All community membersConditions:- Given Bob & Alice are members of the same community
- When Bob creates a post in that community
- Then Alice should see a notification record in the notification tray about this action
- Given Bob, Alice, Charlie, and Daniel are members of the same community
- When more than one member creates a post in the same community within the same day
- Then the notifications are grouped together for better user experience
poll
poll
Event Type:
pollTrigger: When a user starts a poll in a communityRecipients: All community membersConditions:- Given Bob & Alice are members of the same community
- When Bob starts a poll in that community
- Then Alice should see a notification in the notification tray about this action
Comment Events
comment
comment
Event Type: User Feed - Own Feed:User Feed - Another User’s Feed:
commentTrigger: When a user comments on a postRecipients: Post authorConditions:- When Bob comments on Alice’s post
- Then Alice should see a notification in the notification tray
reply
reply
Event Type: User Feed - Own Feed:User Feed - Another User’s Feed:
replyTrigger: When a user replies to a commentRecipients: Original comment authorConditions:- When Bob replies to Alice’s comment
- Then Alice should see a notification in the notification tray
Engagement Events
Reaction Events
reaction
reaction
Event Type: Post Reaction - User Feed (Own):Post Reaction - User Feed (Another User’s):Poll Reaction - Community:Comment Reaction - Community:Comment Reaction - User Feed (Own):Comment Reaction - User Feed (Another User’s):Reply Reaction - Community:Reply Reaction - User Feed (Own):Reply Reaction - User Feed (Another User’s):
reactionTrigger: When a user reacts to a post, poll, comment, or replyRecipients: Content authorConditions:- When Bob reacts to Alice’s content
- Then Alice should see a notification in the notification tray
Mention Events
mention
mention
Event Type: Post Mention - User Feed (Own):Post Mention - User Feed (Another User’s):Poll Mention - Community:Comment Mention - Community:Comment Mention - User Feed (Own):Comment Mention - User Feed (Another User’s):Reply Mention - Community:Reply Mention - User Feed (Own):Reply Mention - User Feed (Another User’s):
mentionTrigger: When a user mentions another user in a post, poll, comment, or replyRecipients: Mentioned userConditions:- When Bob mentions Alice in content
- Then Alice should see a notification in the notification tray
Grouping Logic
Event Aggregation
Notifications are grouped based on specific criteria to provide a better user experience:Post Grouping
Post Grouping
Rule: Post events in the same community within the same day are grouped together.Supported For: Only
post eventsExamples:- Multiple users posting in the same community on the same day
- 2 actors:
displayName_1anddisplayName_2posted incommunityDisplayName - 3+ actors:
displayName_1andnumberothers posted incommunityDisplayName
Individual Events
Individual Events
Rule: All other events remain as individual notifications.Supported For:
poll, comment, reply, reaction, mentionExamples:- A single user mentioning you in a post
- A single reaction to your content
- A single comment on your post
- Standard individual event message templates as specified above
Template Variables
Common Variables
The following variables are available in message templates:User Variables
User Variables
displayName- Actor’s display name (for single events)displayName_1- First actor’s display name (grouped events)displayName_2- Second actor’s display name (grouped events)targetUserDisplayName- Target user’s display name (for user feed posts)
Community Variables
Community Variables
communityDisplayName- Community display name
Aggregation Variables
Aggregation Variables
number- Number of additional actors (for 3+ grouped events)
Implementation Notes
Important: This documentation reflects the exact supported notification events. Only the events, actions, and message templates listed above are currently implemented in the social.plus SDK.
Event Handling
Process notification events in real-time to provide immediate feedback to users about relevant activities.
Message Customization
Use the template variables to create personalized and contextual notification messages.
Grouping Strategy
Only post events support grouping. All other events remain as individual notifications.
Testing
Test all event types and message templates to ensure proper formatting and user experience.