Bounced Email Handling

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

Downloads:

MS Windows Visual C/C++ Libraries

Linux/CentOS C/C++ Libraries

MAC OS X C/C++ Libraries

Solaris C/C++ Libraries

C++ Builder Libraries

#include <CkBounce.h>
#include <CkMailMan.h>
#include <CkEmailBundle.h>
#include <CkEmail.h>

void ChilkatSample(void)
    {
    CkBounce bounce;

    bool success;
    success = bounce.UnlockComponent("Anything for 30-day trial");
    if (success == false) {
        printf("%s\n",bounce.lastErrorText());
        return;
    }

    //  The mailman object is used for receiving (POP3)
    //  and sending (SMTP) email.
    CkMailMan mailman;

    //  Any string argument automatically begins the 30-day trial.
    success = mailman.UnlockComponent("30-day trial");
    if (success != true) {
        printf("%s\n",mailman.lastErrorText());
        return;
    }

    //  Set the POP3 server's hostname
    mailman.put_MailHost("mail.chilkatsoft.com");

    //  Set the POP3 login/password.
    mailman.put_PopUsername("myLogin");
    mailman.put_PopPassword("myPassword");

    CkEmailBundle *bundle = 0;
    //  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.)
    bundle = mailman.CopyMail();

    if (bundle == 0 ) {
        printf("%s\n",mailman.lastErrorText());
        return;
    }

    long i;
    CkEmail *email = 0;
    for (i = 0; i <= bundle->get_MessageCount() - 1; i++) {
        email = bundle->GetEmail(i);

        success = bounce.ExamineEmail(*email);
        if (success == false) {
            printf("%s\n",bounce.lastErrorText());
            return;
        }

        if (bounce.get_BounceType() == 1) {
            //  Hard bounce, log the email address
            printf("Hard Bounce: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 2) {
            //  Soft bounce, log the email address
            printf("Soft Bounce: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 3) {
            //  General bounce, no email address available.
            printf("General Bounce: No email address\n");
        }

        if (bounce.get_BounceType() == 4) {
            //  General bounce, log the email address
            printf("General Bounce: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 5) {
            //  Mail blocked, log the email address
            //  A bounce occured because the sender was blocked.
            printf("Mail Blocked: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 6) {
            //  Auto-reply, log the email address
            printf("Auto-Reply: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 7) {
            //  Transient (recoverable) Failure, log the email address
            printf("Transient Failure: %s\n"
                ,bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 8) {
            //  Subscribe request, log the email address
            printf("Subscribe Request: %s\n"
                ,bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 9) {
            //  Unsubscribe Request, log the email address
            printf("Unsubscribe Request: %s\n"
                ,bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 10) {
            //  Virus Notification, log the email address
            printf("Virus Notification: %s\n"
                ,bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 11) {
            //  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.
            printf("Suspected Bounce!\n");
        }

        if (bounce.get_BounceType() == 12) {
            //  Challenge/Response - Auto-reply message sent by SPAM software
            //  where only verified email addresses are accepted.
            printf("Challenge: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 13) {
            //  Address Change Notification Message.
            printf("Address Change: %s\n",bounce.bounceAddress());
        }

        if (bounce.get_BounceType() == 14) {
            //  Success DSN indicating that the message was successfully relayed.
            printf("DSN Successful Relay: \n");
        }

        delete email;
    }

    delete bundle;

    mailman.Pop3EndSession();
    }