Odoo Integration

EmBoux provides two Odoo modules for zero-code email management:

Modules

EmBoux Core (emboux_core)

The universal connector. Install it on any Odoo 19 instance to manage domains, mailboxes, and aliases directly from the Odoo backend.

• Works with both master and client tokens
• Automatic API sync on create/delete
• Split-brain resolution (handles duplicates gracefully)

EmBoux SaaS (emboux_saas)

The commercial layer for SaaS platforms. Extends Core with:

• Product plans — Starter, Business, Enterprise with configurable limits
• Customer quotas — Automatic quota management from subscriptions
• Grace periods — 30-day window with email reminders before suspension
• Auto-suspension — Excess domains frozen automatically after grace
• Auto-reactivation — Domains restored when customer pays
• Portal — Customer self-service at /my/emboux
• API Key provisioning — Automatic key generation on first purchase
• Overage billing — Monthly invoice for excess mailboxes/aliases

Setup

1. Install the modules

Upload emboux_core and emboux_saas to your Odoo addons path and install them.

Dependencies:

• emboux_core: base, mail
• emboux_saas: emboux_core, portal, sale, whatsapp

2. Configure API connection

Go to Settings > EmBoux and set:

Field	Value
API URL	https://api.emboux.com
API Token	Your master token

3. Create plans (SaaS only)

Pre-built plans are installed with the module:

Plan	Price	Domains	Mailboxes	Storage	Retention
Starter	$9.99	1	1/domain	1 GB	30 days
Business	$49.99	10	5/domain	2 GB	60 days
Enterprise	$199.99	Unlimited	20/domain	5 GB	90 days

You can modify these or create new ones at Sales > Products.

How It Works

Customer Purchase Flow

1. Customer buys an EmBoux plan via Sale Order
2. On SO confirmation:
   • Quota record created automatically
   • API key provisioned on EmBoux
   • Limits synced (domains, mailboxes, storage, retention, transfer)
   • Welcome email sent
3. Customer visits /my/emboux to manage their domains

Suspension Flow

1. Customer exceeds domain quota (e.g., creates 6 domains on a 5-domain plan)
2. State transitions to exceeded, grace period starts (30 days)
3. Email reminders sent at days 7, 15, and 22
4. After day 30: excess domains are suspended on EmBoux (LIFO order)
5. Customer buys upgrade or addon → domains reactivated automatically

Cron Jobs

The module installs three automated jobs:

Job	Interval	Purpose
Grace Period Check	Daily	Advance grace states, apply suspensions
Usage Sync	Every 6 hours	Pull usage data from EmBoux
Overage Billing	Monthly	Invoice for excess mailboxes/aliases

Portal Features

Customers can self-manage at /my/emboux:

• View quota status (OK, Grace Period, Suspended)
• Add/delete domains
• Add/delete mailboxes (with password reveal on creation)
• Add/delete aliases
• View and manage API keys
• See usage statistics