Badge Triggers (Automatic Badge Assignment)

Overview

The Triggers tab allows you to configure automatic badge assignment based on user activity. Instead of manually assigning badges or uploading user lists, you can define behavior-based rules that automatically grant badges once specific criteria are met.

This feature is ideal for increasing engagement, recognizing consistent users, or rewarding specific types of interaction.

How It Works

1. Navigate to the Badges section in the Admin Panel.
2. Open an existing badge or create a new one.
3. Go to the Triggers tab (located between Settings and Users).
4. Enable one or more activity-based triggers.
5. Configure trigger thresholds, select a tracking period, and set the badge duration.
6. Once all trigger conditions are met, the badge is automatically awarded to the user.

Trigger Configuration

Each trigger is grouped under a thematic category. For each trigger, you can:

• Enable/disable it via a checkbox
• Set a numeric threshold (e.g., 10 messages)
• Choose a tracking period (rolling or custom)
• View helper tooltips via the “i” icon

Trigger Categories and Options

Chat Activity

Interactions

Integrations

These are only shown if the related features are enabled:

Tracking Period

The tracking period defines the timeframe during which user activity is evaluated against the trigger thresholds.

Each badge supports a single tracking period applied to all enabled triggers:

• Rolling Period: A sliding window (e.g., “last 30 days”). Admin enters the number of past days to look back from the current date.
• Custom Period: A specific, fixed date range selected via calendar (can be past, future, or a mix).

📌

Example: If the rolling period is set to 14 days and a trigger has a threshold of 10 messages, the system will check whether the user sent at least 10 messages in the last 14 days.

Badge Duration

The badge duration defines how long the badge remains active after it has been awarded to a user.

• Unlimited: The badge stays permanently with the user.
• Fixed Duration: The badge is automatically removed after a specified number of days (e.g., 30 days from the award date).

Admins set this in the Triggers tab during configuration.

⏳

Example: A badge with a 30-day duration will be removed automatically 30 days after the user meets the conditions and receives the badge.

Example Use Case

You want to create a “Chat Star” badge awarded when a user:

• Sends at least 15 messages
• And visits the chat at least 10 times
• Within the last 14 days
• The badge should be active for 30 days after being awarded

Steps:

1. Open the badge or create a new one.
2. Go to the Triggers tab.
3. Enable the “Number of Messages” and “Number of Visits” triggers.
4. Set the thresholds to 15 and 10 respectively.
5. Set the Tracking Period to Rolling: 14 days.
6. Set the Badge Duration to Fixed Duration: 30 days.
7. Save changes.

Result: The badge will be awarded to users who have both sent at least 15 messages and visited the chat at least 10 times within any 14-day window. The badge remains active for 30 days from the date it is granted.

Notes and Restrictions (updated)

• The First Message trigger is exclusive. When enabled, it disables all other triggers.
• Badges are granted once per user per badge configuration.
• Trigger changes are not retroactive — they affect only future activity.
• Badges with a fixed duration will be automatically revoked after expiration.
• Expired badges can be re-earned if the conditions are met again (future behavior may be configurable).