PureBasic

Request a Return Receipt for an Email

Demonstrates the Chilkat Email.ReturnReceipt property. Set it to true to request a return-receipt when the message is received; this causes a Disposition-Notification-To header to be added when the email is sent. The default is false. This example enables the request.

Background: A return receipt (technically a Message Disposition Notification, MDN) asks the recipient's mail client to send back a small confirmation when the message is opened. It is only a request: the receiving client or server is free to ignore it, and many prompt the user before sending anything. Because of this, a return receipt is not reliable proof that a human actually read the message — treat it as a courtesy signal, not a guarantee.

Chilkat PureBasic Downloads

Download Chilkat for PureBasic

PureBasic

IncludeFile "CkEmail.pb"

Procedure ChilkatExample()

    ;  Demonstrates the Email.ReturnReceipt property.  Set to true to request a
    ;  return-receipt when the email is received.  This causes a Disposition-Notification-To
    ;  header to be added when the email is sent.  The default is false.

    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkSubject(email, "Please confirm receipt")
    CkEmail::setCkBody(email, "Kindly confirm you received this message.")
    CkEmail::setCkFrom(email, "alice@example.com")
    CkEmail::ckAddTo(email,"Bob","bob@example.com")

    ;  Request a return receipt.
    CkEmail::setCkReturnReceipt(email, 1)

    Debug "ReturnReceipt = " + Str(CkEmail::ckReturnReceipt(email))


    CkEmail::ckDispose(email)


    ProcedureReturn
EndProcedure