TrochaiDocs

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:

  • "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

TypeIconDescription
AssignmentPersonA new conversation was assigned to you.
EscalationRed circleThe AI bot requested human assistance on a conversation.
SLA WarningClockA conversation is close to breaching its response time target.
New MessageChat bubbleA contact sent a new message in a conversation you handle.
MentionAt sign (@)A teammate mentioned you.

Interacting with notifications

Reading a notification

When you click a notification:

  1. It's automatically marked as read.
  2. You're redirected to the related conversation in the inbox.
  3. The popover closes.

Mark all as read

To mark all notifications as read at once:

  1. Open the notification popover.
  2. Click the "Mark all read" button in the header.
  3. 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:

  1. The notification is created in the database.
  2. The real-time subscription automatically detects the insertion.
  3. The badge count updates without reloading the page.
  4. 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:

FormatMeaning
Just nowLess than 1 minute
Xm agoX minutes ago
Xh agoX hours ago
Xd agoX days ago

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.

On this page