Notifications
Configure in-app and Slack notifications for tickets, agents, mentions, and page updates. Set preferences and quiet hours per organization.
JuhJuh sends notifications when something happens that needs your attention: a teammate mentions you in a comment, an agent finishes a task, a ticket status changes, or someone updates a page you follow.
Notifications arrive in two places:
- In-app feed, the bell icon in the top navigation bar
- Slack DMs, if you have the Slack integration connected and DM delivery enabled
Both channels are independently configurable per event type, per organization.
Notification feed¶
The notification bell in the top bar shows your unread count as a badge. Click it to open the notification panel, which lists your 30 most recent notifications with the newest first.
Each notification shows:
| Element | Description |
|---|---|
| Actor | The person who triggered the event |
| Action | What happened (mentioned you, replied, updated, changed permissions) |
| Target | The page, comment, or entity involved |
| Timestamp | Relative time (for example, "3 minutes ago") |
Click any notification to navigate directly to the relevant page or comment. Notifications are marked as read automatically when you click them.
Mark as read:
- Click a single notification to mark it as read and navigate to the target
- Click Mark all read at the top of the panel to clear all unread notifications at once
Real-time delivery¶
Notifications arrive instantly without refreshing the page. When a new notification is created, it appears in your feed immediately and the unread badge updates in real time.
This works on any page in the platform as long as you are signed in. No polling or manual refresh required.
Event types¶
JuhJuh creates notifications for the following events:
| Event | Trigger | Who receives it |
|---|---|---|
| Mention | Someone @mentions you in a comment | The mentioned user |
| Comment reply | Someone replies to your comment | The original comment author |
| Page updated | A page you starred is edited | All users who starred the page |
| Permission changed | Your access to a page is added, changed, or removed | The affected user |
| Ticket assigned | A ticket is assigned to you | The assignee |
| Ticket status changed | A ticket you follow changes status | Followers of the ticket |
| Ticket commented | Someone comments on a ticket you follow | Followers of the ticket |
| Agent completed | An AI agent finishes executing | The user who triggered it |
| Agent failed | An AI agent encounters an error | The user who triggered it |
| Intake request | A new intake request arrives from Slack | Triage team members |
| PR created | A pull request is created for a ticket you follow | Followers of the ticket |
You will never receive a notification for your own actions. If you edit a page or reply to your own comment, no notification is created.
Notification preferences¶
Each user controls which events trigger notifications and through which channels. Preferences are scoped per organization, so you can have different settings for each org you belong to.
Accessing preferences:
- Go to Profile > Notification Settings
- Select the organization (if you belong to more than one)
- Configure each event type
Per-event settings:
| Setting | Description | Default |
|---|---|---|
| In-app | Show the notification in your feed and update the unread badge | On |
| Slack DM | Send a direct message via the Slack bot | Off |
Both channels can be independently toggled. You can enable Slack DMs without in-app notifications, or the reverse.
Quiet hours¶
Suppress Slack DM delivery during a time window. In-app notifications are still recorded and visible when you next open the platform.
- Go to Profile > Notification Settings
- Set Quiet hours start and Quiet hours end (24-hour format, for example 22:00 to 08:00)
- Save
Quiet hours wrap around midnight correctly. Setting start to 22:00 and end to 08:00 suppresses DMs from 10 PM through 8 AM.
Quiet hours apply only to Slack DM delivery. In-app notifications are always recorded regardless of the time.
API access¶
The notification system is available through the API for building custom integrations or notification dashboards.
Notification endpoints:
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/v1/notifications/ |
List notifications (paginated), includes unread count |
GET |
/api/v1/notifications/unread/ |
Get unread count only |
POST |
/api/v1/notifications/read/ |
Mark notifications as read |
Mark as read accepts either a list of notification IDs (up to 100) or an all: true flag to mark everything as read.
Preference endpoints:
| Method | Endpoint | Description |
|---|---|---|
GET |
/api/v1/orgs/{slug}/notification-preferences/ |
List all preferences for the current user |
PATCH |
/api/v1/orgs/{slug}/notification-preferences/{event_type}/ |
Update a single preference |
POST |
/api/v1/orgs/{slug}/notification-preferences/bulk/ |
Update multiple preferences at once |
All endpoints require authentication via session or API key. See the API documentation for authentication details.
Slack notifications¶
When the Slack integration is connected, two types of Slack notifications are available:
Channel notifications are posted to mapped Slack channels when events happen in the mapped project. These are configured per channel at Settings > Integrations > Slack Channels. See the Slack documentation for channel mapping setup.
Direct message notifications are sent to your personal Slack DMs based on your notification preferences. These are opt-in and controlled at Profile > Notification Settings.
Channel notifications and DM notifications are independent. You can receive channel notifications without DMs, or DMs without channel notifications.
Troubleshooting¶
No notifications appearing:
- Check that the event type is enabled in your preferences at Profile > Notification Settings
- Verify you are looking at the correct organization. Preferences are per-org.
- Confirm you are following or involved in the relevant ticket or page. Notifications only go to participants and followers.
Slack DMs not arriving:
- Verify Slack DM delivery is enabled for the event type in your notification preferences. It is off by default.
- Check quiet hours. DMs are suppressed during your configured quiet window.
- Confirm your Slack account is linked. Run
/jj linkin any channel where the JuhJuh bot is present. - Check the Slack connection status at Settings > Integrations > Slack.
Too many notifications:
- Disable specific event types you do not need at Profile > Notification Settings
- Unstar pages you no longer want update notifications for
- Unfollow tickets that are no longer relevant to your work
Unread count not updating:
Refresh the page. If the count still appears stale, sign out and sign back in to re-establish the real-time connection.
Related¶
- Slack: Slack integration setup, channel notifications, and DM delivery
- Tickets: ticket events that trigger notifications
- Pages: page update and comment notifications for starred pages
- Agents: agent completion and failure notifications
- Permissions: permission change notifications
- API: programmatic access to notification endpoints