Notifications
Notification center, alert types, and notification configuration in the inbox.
Notifications
Trochai has a built-in notification system that alerts you about important events in your inbox: new assignments, bot escalations, SLA warnings, and new messages. Notifications are displayed in real time without needing to reload the page.
Notification bell
The notification bell is located in the left sidebar of the application. It shows:
- Bell icon: access to the notification center.
- Count badge: a red circle with the number of unread notifications. If you have more than 99, it shows "99+".
- "Notifications" text: visible when the sidebar is expanded.
Clicking the bell opens a popover with your latest notifications.
Notification center
The notification popover shows:
Header
- "Notifications" title
- "Mark all read" button (only visible if there are unread notifications)
Notification list
Each notification shows:
- Type icon: an emoji indicating the notification type
- Title: brief description of the event
- Body (optional): additional details
- Relative time: when it happened (e.g., "5m ago", "2h ago", "3d ago")
- Unread indicator: a blue dot to the right of unread notifications
Unread notifications have a slightly highlighted background to distinguish them from read ones.
Notification types
| Type | Icon | Description |
|---|---|---|
| Assignment | Person | A new conversation was assigned to you. |
| Escalation | Red circle | The AI bot requested human assistance on a conversation. |
| SLA Warning | Clock | A conversation is close to breaching its response time target. |
| New Message | Chat bubble | A contact sent a new message in a conversation you handle. |
| Mention | At sign (@) | A teammate mentioned you. |
Interacting with notifications
Reading a notification
When you click a notification:
- It's automatically marked as read.
- You're redirected to the related conversation in the inbox.
- The popover closes.
Mark all as read
To mark all notifications as read at once:
- Open the notification popover.
- Click the "Mark all read" button in the header.
- All notifications lose their unread indicator and the bell badge disappears.
Real-time updates
Notifications update in real time thanks to Supabase Realtime. When an event generates a notification:
- The notification is created in the database.
- The real-time subscription automatically detects the insertion.
- The badge count updates without reloading the page.
- The notification appears in the popover when opened.
Additionally, notifications auto-refresh every 60 seconds as a fallback.
Empty state
If you have no notifications, the popover shows the message: "No notifications."
Time indicators
Notification times are shown in relative format:
| Format | Meaning |
|---|---|
| Just now | Less than 1 minute |
| Xm ago | X minutes ago |
| Xh ago | X hours ago |
| Xd ago | X days ago |
Navigation from notifications
Clicking a notification navigates directly to the relevant conversation in the inbox. The URL includes the conversation ID so it's automatically selected.
Tips
- Check escalations first: escalation notifications (red circle) indicate that a contact needs urgent human attention.
- Attend SLA warnings: SLA notifications alert you when a conversation is about to exceed its response time target.
- Use "Mark all read" periodically to keep your notification center organized.
Notifications are generated automatically based on system events. You don't need to configure anything to start receiving them.
Related pages
- Conversations — manage the conversations where events occur
- Assignments — automatic assignment notifications