From 5105b5b607d692f8b369172cb32ae95a49b70412 Mon Sep 17 00:00:00 2001 From: Ralf Schmid Date: Tue, 10 Nov 2026 14:51:22 +0100 Subject: [PATCH] Fixes admin-1222 - Note that the failed email rake tasks cover pre-7.3 records Relates to zammad/zammad-admin-documentation#1222 Since 7.3 an email that cannot be processed becomes an error ticket instead of a failed email record (app/models/channel/email_parser.rb:136, see "Unprocessable emails no longer create FailedEmail records" in BREAKING_CHANGES.md). Rows that already exist are kept, keep counting in the monitoring (lib/monitoring_helper/health_checker/failed_email.rb:8) and keep working with the rake tasks. Reprocessing such a row now creates a ticket through FailedEmail#reprocess (app/models/failed_email.rb:4-26), which can be an error ticket as well. --- admin/console/other-useful-commands.rst | 14 ++++++++++++-- 1 file changed, 12 insertions(+), 2 deletions(-) diff --git a/admin/console/other-useful-commands.rst b/admin/console/other-useful-commands.rst index 440dbe44..0e8581f3 100644 --- a/admin/console/other-useful-commands.rst +++ b/admin/console/other-useful-commands.rst @@ -37,8 +37,18 @@ This will also show errors that might appear within that process. Reprocess Failed Emails ----------------------- -When Zammad fetches a mail it cannot parse (e.g. due to a parser bug or a -malformed message), it will store the mail in the database and warn in +.. note:: + + Since Zammad 7.3, an email that cannot be processed becomes a ticket titled + ``Unprocessable email`` instead of a failed email record. The commands below + only handle records that were created before the update. Reprocessing such + a record creates a ticket from it, which can be an error ticket as well. See + the :admin-docs:`unprocessable emails + ` page for the current + handling. + +When Zammad fetched a mail it could not parse (e.g. due to a parser bug or a +malformed message), it stored the mail in the database and warned in the monitoring section about it. In case of a malformed message (e.g. an invalid email address in one of the