Mock Mail Server

This module provides tools to test incoming email processing in Odoo without the need for actual email servers. It allows developers and testers to emulate receiving emails and create test scenarios for various email-based workflows.

Key features include:

• Test Email Creation: Create mock emails with custom subjects, senders, recipients, and body content
• Email Processing Simulation: Emulate the process of receiving and processing emails through Odoo's mail gateway
• Integration Testing: Test email-based workflows such as lead creation, user assignment, and email routing
• Debugging Tools: Track the processing status and results of test emails
• Error Handling: Capture and display errors that occur during email processing

Usage Guide

Setting up a Test Mail Server

1. Go to Settings > Technical > Email > Incoming Mail Servers
2. Create a new server with type "Odoo Test Server"
3. Configure the target model that should process the incoming emails
4. Set the server to "Confirmed" state

Creating and Processing Test Emails

1. From the test server form view, click on the "Test Emails" button to access the test emails interface
2. Click "Create" to create a new test email
3. Fill in the required fields:
   • Subject: The email subject
   • From: The sender's email address
   • To: The recipient's email address
   • Body: The content of the email
   • Server: The test server to use (pre-filled if accessed from server)
4. Click "Save" to save the test email
5. Use one of the action buttons:
   • Queue for Processing: Add the email to the processing queue
   • Process Now: Process the email immediately

Viewing Test Results

1. After processing, the test email status will change to "Processed" or "Error"
2. The processing log will show details of what happened during processing
3. If a record was created, you'll see:
   • The model and ID of the created record
   • A link to view the created record
   • The user assigned to the record (if applicable)
4. If an error occurred, the error message will be displayed in the "Error Message" field
5. You can use the "Reset Test" button to clear results and try again

Technical Details

The module extends Odoo's fetchmail functionality by adding a new server type called "Odoo Test Server" which doesn't require actual connection to an email server. Instead, it processes mock emails created within the system.

Models

• kw.mock.email: Stores test email data and processing results
• fetchmail.server: Extended to support the "Odoo Test Server" type

Use Cases

• CRM Testing: Test lead creation from emails
• Helpdesk Testing: Test ticket creation and assignment
• Email Routing: Test routing rules and processing logic
• User Assignment: Test automatic user assignment based on email recipients

Bug Tracker

Bugs are tracked on https://kitworks.systems/requests. In case of trouble, please check there if your issue has already been reported.

Maintainer

KitWorks Systems. Our web site: https://kitworks.systems

We can provide you further Odoo Support, Odoo implementation, Odoo customization, Odoo 3rd Party development and integration software, consulting services. Our main goal is to provide the best quality product for you.

For any questions contact us.