Overview

Notify users in real-time when important events happen in Odoo without needing complex automation platforms. Define rules once, and let Smart Record Notifications handle all communication channels automatically.

Key Features

Notification Channels

Recipient Options

• Static Users: Select specific users to always receive notifications.
• User Groups: Automatically include all members of security groups.
• Dynamic Recipients: Resolve recipient from a field on the record (e.g., user_id, salesperson_id, assigned_user_id).
• De-duplication: Recipients are merged automatically - no duplicate notifications.

Message Templates

Use simple template syntax to create dynamic messages:

Example Templates

• New Sale Order {{ name }} created by {{ user_id.name }} for {{ partner_id.name }}
• Task {{ name }} moved to {{ stage_id.name }} by {{ user_id.name }}
• Invoice {{ name }} totaling {{ amount_total }} has been validated

Trigger Types

Advanced Conditions & Filters

Notification Logs & Debugging

Every notification dispatched is logged with comprehensive details:

• Rule Name: Which rule triggered the notification.
• Trigger Type & Event: Creation, update, deletion, or state change.
• Model & Record: Target model and record identifier.
• Channel & Recipients: Which channel was used and who received it.
• Status & Error Details: Success or failure status with error messages for debugging.
• Webhook Status Code: HTTP response code for webhook deliveries.
• Message Content: Full subject and body of the notification sent.

Webhook Integration

Integrate with external services via webhook. JSON payload structure:

{
  "event": "create",
  "model": "sale.order",
  "record_id": 42,
  "record_name": "S00042",
  "subject": "New Sale Order S00042",
  "body": "Sale Order S00042 created by Admin",
  "rule_name": "Notify on New Sale Order",
  "timestamp": "2026-02-13T10:30:00"
}

Supports optional secret header: X-Webhook-Secret for authentication. Use with Slack, Microsoft Teams, n8n, Zapier, or any HTTP webhook receiver.

Quick Start

1. Go to Smart Notifications menu and click Notification Rules.
2. Click Create to add a new rule.
3. Select the Target Model (Sale Order, Task, Lead, etc.).
4. Choose a Trigger Event (Create, Update, Delete, State Change).
5. Enable notification channels: Inbox, Email, Webhook.
6. Add recipients: Users, groups, or dynamic field.
7. Write message template with field references.
8. Optionally add condition filters (domain, watched fields, state values).
9. Click Send Test to verify with a sample record.
10. Save and activate the rule.

Dependencies

• Base
• Mail

Technical Details

Module Architecture

The module is built with clean separation of concerns:

• Models: notification_rule.py (core logic), notification_log.py (audit trail)
• Services: notification_dispatcher.py (rendering, dispatch)
• Views: XML views for rules, logs, and menus
• Security: Group-based access control

Uses Odoo 19 hook registration pattern via setattr/origin method patching to intercept create/write/unlink operations on target models. All dispatch logic is fail-safe and never blocks business operations.

Example Use Cases