Class bounce_to

source code

Used to route bounce messages to a handler for either soft or hard bounces. Set the soft/hard parameters to the function that represents the handler. The function should take one argument of the message that it needs to handle and should have a route that handles everything.

WARNING: You should only place this on the START of modules that will receive bounces, and every bounce handler should return START. The reason is that the bounce emails come from *mail daemons* not the actual person who bounced. You can find out who that person is using message.bounce.final_recipient. But the bounce handler is *actually* interacting with a message from something like MAILER-DAEMON@somehost.com. If you don't go back to start immediately then you will mess with the state for this address, which can be bad.