Odoo Community Association

Fetchmail Incoming Test

Beta License: AGPL-3 OCA/mail Translate me on Weblate Try me on Runboat

This module lets you simulate an incoming email directly from Odoo, without a real mail server or SMTP client.

It adds a Simulate Incoming Email button (and matching Action menu entry) on the Incoming Mail Server, opening a small composer (From, To, Cc, Bcc, Subject, Body). On send, the email is used as if it had been fetched from a server, it is then routed by alias and creates the target record (helpdesk ticket, lead, task, …).

It is meant for testing mail-driven flows on environments that have no inbound mail server, like test instances.

It also adds a Replay Email File button, which takes a raw message file (usually a .eml exported from a mail client) and feeds it to the gateway untouched. Useful to reproduce how a specific email that a customer received was handled, byte for byte.

Table of contents

Usage

To use this module, follow these steps:

  • Go to Settings > Technical > Email > Incoming Mail Servers.
  • Open a saved server, or select one in the list.
  • Click Simulate Incoming Email (button on the form, or the Action menu).
  • Fill in the composer:
    • To: the alias that routes to your target model, e.g. a Helpdesk team alias.
    • From, Cc, Bcc, Subject, Body as needed.
  • Click Send.

The message goes through the standard mail gateway and the created record (e.g. a Helpdesk ticket) appears, just as if the email had been received.

To replay a real email instead of composing one:

  • Click Replay Email File (button on the form, or the Action menu).
  • Upload the message file, then click Process.

The file is sent to the gateway as if it was received through fetchmail. Malformed HTML and unusual headers are preserved.

Both wizards reuse the Create a New Record model of the server they were opened from, exactly like a real fetch: when the email replies to nothing and matches no alias, the gateway creates a record of that model instead of refusing the email.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Camptocamp

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

This module is part of the OCA/mail project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.