(DataFlex) Bounced Email Handling

Demonstrates how to examine emails and detect which are bounced (automated) replies. Classifies each email according to the type of bounce.

Chilkat ActiveX Downloads ActiveX for 32-bit and 64-bit Windows

Use ChilkatAx-win32.pkg

Procedure Test
    Handle hoBounce
    Handle hoMailman
    Variant vBundle
    Handle hoBundle
    Integer i
    Variant vEmail
    Handle hoEmail
    Boolean iSuccess
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    Get Create (RefClass(cComChilkatBounce)) To hoBounce
    If (Not(IsComObjectCreated(hoBounce))) Begin
        Send CreateComObject of hoBounce
    End

    // The mailman object is used for receiving (POP3) 
    // and sending (SMTP) email.
    Get Create (RefClass(cComChilkatMailMan)) To hoMailman
    If (Not(IsComObjectCreated(hoMailman))) Begin
        Send CreateComObject of hoMailman
    End

    // Set the POP3 server's hostname
    Set ComMailHost Of hoMailman To "mail.chilkatsoft.com"

    // Set the POP3 login/password.
    Set ComPopUsername Of hoMailman To "myLogin"
    Set ComPopPassword Of hoMailman To "myPassword"

    // Copy the all email from the user's POP3 mailbox 
    // into a bundle object.  The email remains on the server.
    // (There are other methods for deleting email from a POP3 server.)
    Get ComCopyMail Of hoMailman To vBundle
    If (IsComObject(vBundle)) Begin
        Get Create (RefClass(cComChilkatEmailBundle)) To hoBundle
        Set pvComObject Of hoBundle To vBundle
    End
    Get ComLastMethodSuccess Of hoMailman To bTemp1
    If (bTemp1 = False) Begin
        Get ComLastErrorText Of hoMailman To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    Move 0 To i

    While (i < (ComMessageCount(hoBundle)))
        Get ComGetEmail Of hoBundle i To vEmail
        If (IsComObject(vEmail)) Begin
            Get Create (RefClass(cComChilkatEmail)) To hoEmail
            Set pvComObject Of hoEmail To vEmail
        End

        Get ComExamineEmail Of hoBounce vEmail To iSuccess
        If (iSuccess = False) Begin
            Get ComLastErrorText Of hoBounce To sTemp1
            Showln sTemp1
            Send Destroy of hoBundle
            Procedure_Return
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 1) Begin
            // Hard bounce, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Hard Bounce: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 2) Begin
            // Soft bounce, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Soft Bounce: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 3) Begin
            // General bounce, no email address available.
            Showln "General Bounce: No email address"
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 4) Begin
            // General bounce, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "General Bounce: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 5) Begin
            // Mail blocked, log the email address
            // A bounce occured because the sender was blocked. 
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Mail Blocked: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 6) Begin
            // Auto-reply, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Auto-Reply: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 7) Begin
            // Transient (recoverable) Failure, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Transient Failure: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 8) Begin
            // Subscribe request, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Subscribe Request: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 9) Begin
            // Unsubscribe Request, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Unsubscribe Request: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 10) Begin
            // Virus Notification, log the email address
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Virus Notification: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 11) Begin
            // Suspected bounce.
            // This should be rare.  It indicates that the Bounce
            // component found strong evidence that this is a bounced
            // email, but couldn't quite recognize everything it
            // needed to be 100% sure.  Feel free to notify
            // support@chilkatsoft.com regarding emails having this
            // bounce type.
            Showln "Suspected Bounce!"
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 12) Begin
            // Challenge/Response - Auto-reply message sent by SPAM software 
            // where only verified email addresses are accepted. 
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Challenge: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 13) Begin
            // Address Change Notification Message.
            Get ComBounceAddress Of hoBounce To sTemp1
            Showln "Address Change: " sTemp1
        End

        Get ComBounceType Of hoBounce To iTemp1
        If (iTemp1 = 14) Begin
            // Success DSN indicating that the message was successfully relayed.
            Showln "DSN Successful Relay: "
        End

        Send Destroy of hoEmail

        Move (i + 1) To i
    Loop

    Send Destroy of hoBundle

    Get ComPop3EndSession Of hoMailman To iSuccess


End_Procedure