(Delphi DLL) 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 for Delphi Downloads Chilkat non-ActiveX DLL for Delphi Chilkat ActiveX DLL for Delphi * The examples here use the non-ActiveX DLL.

uses
    Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
    Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, MailMan, EmailBundle, Email, Bounce;

...

procedure TForm1.Button1Click(Sender: TObject);
var
bounce: HCkBounce;
mailman: HCkMailMan;
bundle: HCkEmailBundle;
i: Integer;
email: HCkEmail;
success: Boolean;

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

bounce := CkBounce_Create();

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

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

// Set the POP3 login/password.
CkMailMan_putPopUsername(mailman,'myLogin');
CkMailMan_putPopPassword(mailman,'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.)
bundle := CkMailMan_CopyMail(mailman);
if (CkMailMan_getLastMethodSuccess(mailman) = False) then
  begin
    Memo1.Lines.Add(CkMailMan__lastErrorText(mailman));
    Exit;
  end;

i := 0;

while i < CkEmailBundle_getMessageCount(bundle) do
  begin
    email := CkEmailBundle_GetEmail(bundle,i);

    success := CkBounce_ExamineEmail(bounce,email);
    if (success = False) then
      begin
        Memo1.Lines.Add(CkBounce__lastErrorText(bounce));
        CkEmailBundle_Dispose(bundle);
        Exit;
      end;

    if (CkBounce_getBounceType(bounce) = 1) then
      begin
        // Hard bounce, log the email address
        Memo1.Lines.Add('Hard Bounce: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 2) then
      begin
        // Soft bounce, log the email address
        Memo1.Lines.Add('Soft Bounce: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 3) then
      begin
        // General bounce, no email address available.
        Memo1.Lines.Add('General Bounce: No email address');
      end;
    if (CkBounce_getBounceType(bounce) = 4) then
      begin
        // General bounce, log the email address
        Memo1.Lines.Add('General Bounce: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 5) then
      begin
        // Mail blocked, log the email address
        // A bounce occured because the sender was blocked. 
        Memo1.Lines.Add('Mail Blocked: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 6) then
      begin
        // Auto-reply, log the email address
        Memo1.Lines.Add('Auto-Reply: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 7) then
      begin
        // Transient (recoverable) Failure, log the email address
        Memo1.Lines.Add('Transient Failure: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 8) then
      begin
        // Subscribe request, log the email address
        Memo1.Lines.Add('Subscribe Request: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 9) then
      begin
        // Unsubscribe Request, log the email address
        Memo1.Lines.Add('Unsubscribe Request: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 10) then
      begin
        // Virus Notification, log the email address
        Memo1.Lines.Add('Virus Notification: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 11) then
      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.
        Memo1.Lines.Add('Suspected Bounce!');
      end;
    if (CkBounce_getBounceType(bounce) = 12) then
      begin
        // Challenge/Response - Auto-reply message sent by SPAM software 
        // where only verified email addresses are accepted. 
        Memo1.Lines.Add('Challenge: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 13) then
      begin
        // Address Change Notification Message.
        Memo1.Lines.Add('Address Change: ' + CkBounce__bounceAddress(bounce));
      end;
    if (CkBounce_getBounceType(bounce) = 14) then
      begin
        // Success DSN indicating that the message was successfully relayed.
        Memo1.Lines.Add('DSN Successful Relay: ');
      end;

    CkEmail_Dispose(email);

    i := i + 1;
  end;

CkEmailBundle_Dispose(bundle);

success := CkMailMan_Pop3EndSession(mailman);

CkBounce_Dispose(bounce);
CkMailMan_Dispose(mailman);

end;