Notifications
Deliverty Hub sends automated notifications to keep customers, agents, and admins informed about task progress. Notifications are powered by Novu and delivered across multiple channels.
Notification Channels
| Channel | Description | Recipients |
|---|---|---|
| In-App | Real-time notifications in the dashboard and mobile app. Appear in the notification bell with unread count badge. | Admins, Agents, Customers |
| Email notifications for important events like task creation, completion, and cancellation. | Admins, Customers | |
| Push | Mobile push notifications via the Deliverty Driver app for time-sensitive agent actions. | Agents |
| SMS | Text messages for critical delivery updates (in transit, completed). | Customers |
Notification Matrix
The following table shows which notifications are sent for each task status change, and through which channels:
| Event | Customer | Agent | Admin |
|---|---|---|---|
| Task Created | In-App Email | — | In-App Email |
| Task Assigned | — | In-App Push | In-App |
| Task Accepted | In-App Email | — | In-App |
| In Transit | In-App Email SMS | — | In-App |
| Completed | In-App Email SMS | In-App Push | In-App Email |
| Cancelled | In-App Email | In-App Push | In-App Email |
In-App Notifications
Dashboard
The dashboard header includes a notification bell icon with a real-time unread count badge. Clicking it opens the notification inbox where admins can:
- View all notifications in reverse chronological order
- Click a notification to navigate to the relevant task
- Mark notifications as read individually or all at once
Notifications update in real-time via WebSocket — no page refresh needed.
Mobile App
Agents receive notifications in the Deliverty Driver app through:
- Push notifications: Appear even when the app is in the background or closed. Tapping opens the relevant task.
- In-app inbox: A notifications tab that lists all received notifications with timestamps.
- Badge count: The app icon and notifications tab show unread count.
Admin Notification Recipients
Admin notifications are sent to:
- Organization Admins: Users with the Organization Admin role in the task's organization.
- Super Admins: All Super Admin users receive notifications for all organizations.
Recipients are de-duplicated — if a user is both an Organization Admin and a Super Admin, they receive each notification only once.
Requirements for Notifications
Notifications are only sent if the recipient has the required contact details:
- Email notifications require a valid email address on the user/customer record.
- SMS notifications require a valid phone number on the customer record.
- Push notifications require the agent to have the Deliverty Driver app installed and logged in.
- In-app notifications work for all registered users automatically.
If a required field is missing, that notification channel is silently skipped — no error is raised.
Real-Time Delivery
In-app notifications are delivered in real-time using WebSocket connections. Both the dashboard and mobile app maintain persistent connections that receive new notifications as soon as they are triggered — typically within 1-2 seconds of the task status change.
Notifications are for people (admins, agents, customers). If you need system-to-system event delivery, use webhooks instead. Webhooks send HTTP callbacks to your server when events occur.