OWL Mailbox & Email Client for Odoo

Mailbox Square is a professional mailbox management system inside Odoo. Manage external mail without switching between Gmail, Outlook, webmail, and ERP screens—ideal for Odoo Gmail integration, Odoo Microsoft 365 integration, Odoo Outlook integration, and Odoo webmail client scenarios.

Step 1: Open Google Cloud Console

• Create or select a Google Cloud project.
• Enable Gmail API.
• Configure OAuth consent screen.
• Add application name and support email.
• Add authorized domain if required.

Step 2: Create OAuth Credentials

• Go to APIs & Services > Credentials.
• Create OAuth Client ID.
• Select Web Application.
• Add the Odoo callback/redirect URL.
• Copy Client ID and Client Secret.

Step 3: Configure Gmail in Odoo

• Open Mailbox Square > Configuration > Settings.
• Paste Gmail Client ID.
• Paste Gmail Client Secret.
• Save settings.

Step 4: Create Gmail Mailbox Account

• Go to Mailbox Square > Accounts.
• Create a new account.
• Select Provider = Gmail.
• Enter email address and account name.
• Save the account.

Step 5: Connect Gmail Account

• Click Connect Gmail.
• Login with the Gmail/Google Workspace account.
• Approve requested Gmail permissions.
• After callback, the account becomes connected.

Step 6: Sync Mailbox

• Click Sync Now or wait for scheduled cron.
• Inbox, Sent, Drafts, Trash, Spam, Archive, and Gmail categories sync into Odoo.
• Users can read, compose, reply, forward, and link emails to Odoo records.

Step 1: Open Microsoft Azure Portal

• Go to Microsoft Entra ID.
• Open App Registrations.
• Create a new app registration.
• Select supported account type based on company needs.

Step 2: Configure Redirect URI

• Add Web redirect URI pointing to the Odoo Microsoft callback URL.
• Save the app registration.

Step 3: Add Microsoft Graph API Permissions

• Mail.Read
• Mail.ReadWrite
• Mail.Send
• offline_access
• User.Read

Admin consent may be required depending on tenant policy.

Step 4: Create Client Secret

• Open Certificates & Secrets.
• Create new client secret.
• Copy the generated value immediately.

Step 5: Configure Microsoft 365 in Odoo

• Open Mailbox Square > Configuration > Settings.
• Paste Microsoft Client ID.
• Paste Microsoft Client Secret.
• Save settings.

Step 6: Create Microsoft Mailbox Account

• Go to Mailbox Square > Accounts.
• Create a new account.
• Select Provider = Microsoft 365 / Outlook.
• Enter email address and account name.
• Save.

Step 7: Connect Microsoft Account

• Click Connect Microsoft.
• Login using Microsoft 365 or Outlook account.
• Accept requested permissions.
• Account becomes connected after OAuth callback.

Step 8: Sync and Use

• Sync mailbox folders from Microsoft Graph.
• Read, send, reply, forward, download attachments, and link emails with Odoo records.

Step 1: Collect Mail Server Details

• Email address
• IMAP host and port
• IMAP encryption SSL/TLS or STARTTLS
• SMTP host and port
• SMTP encryption SSL/TLS or STARTTLS
• Username
• Password or app password

Step 2: Enable IMAP/SMTP on Mail Server

Examples: cPanel webmail, Zoho Mail, private company mail server, hosting provider webmail, custom domain email.

Step 3: Create Webmail Account in Odoo

• Open Mailbox Square > Accounts.
• Create new account.
• Select Provider = IMAP/SMTP.
• Enter email address, username, IMAP and SMTP server details.
• Save.

Step 4: Store Password Securely

• Use the password wizard to store the mailbox password.
• Password should be encrypted and not shown in plain text.

Step 5: Test Connection

• Test IMAP connection.
• Test SMTP sending connection.
• Fix host, port, SSL/TLS, or credential issues if connection fails.

Step 6: Sync and Send Emails

• Sync folders from IMAP.
• Send outgoing email using SMTP.
• Use mailbox folders, attachments, signatures, and record linking.