(PureBasic) SendRawEmail (HTML Email with PDF Attachment)

See more Amazon SES Examples

Demonstrates how to use the SES SendRawEmail action to send an email with an attachment. Note: The total size of an SES email cannot exceed 10MB.

See SES SendRawEmail for more information.

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkAuthAws.pb"
IncludeFile "CkRest.pb"
IncludeFile "CkXml.pb"
IncludeFile "CkEmail.pb"
IncludeFile "CkCrypt2.pb"

Procedure ChilkatExample()

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

    ; Let's first prepare the email to be sent..
    email.i = CkEmail::ckCreate()
    If email.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkEmail::setCkCharset(email, "utf-8")
    CkEmail::setCkSubject(email, "Test email with PDF attachment.")
    CkEmail::ckSetHtmlBody(email,"<html><body><p>This is a test <b>HTML email with a PDF attachment</b></p></body></html>")

    ; The AddFileAttachment method returns the content-type selected based on the 
    ; file extension.   This example has no need of using the return value..
    contentType.s = CkEmail::ckAddFileAttachment(email,"qa_data/pdf/fishing.pdf")
    If CkEmail::ckLastMethodSuccess(email) <> 1
        Debug CkEmail::ckLastErrorText(email)
        CkEmail::ckDispose(email)
        ProcedureReturn
    EndIf

    ; Add the From header, and some recipients.
    ; The From address should be an email address verified for use
    ; as a sender for your Amazon SES account.
    ; The From address will also be the Source parameter for the SES SendRawEmail request.
    CkEmail::setCkFrom(email, "Chilkat Software <admin@chilkatdownload.com>")

    ; Add recipients...
    ; Note: We DO NOT add BCC recipients to the email.  A BCC address should not be
    ; present in the MIME header of the email (otherwise it would not be "blind" because
    ; other recipients would be able to see it).
    ; These same addresses will be added as parameters to the SendRawEmail request.
    ; (BCC addresses are added as parameters at that time.)
    CkEmail::ckAddTo(email,"Mr. Simulator","success@simulator.amazonses.com")
    CkEmail::ckAddCC(email,"Chilkat Support","support@chilkatsoft.com")
    CkEmail::ckAddCC(email,"Some Yahoo","somebody@yahoo.com")

    ; Get the MIME of the email to be sent.
    mimeStr.s = CkEmail::ckGetMime(email)

    ; We'll need the MIME base64 encoded for the SES REST request..
    crypt.i = CkCrypt2::ckCreate()
    If crypt.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    mimeBase64.s = CkCrypt2::ckEncodeString(crypt,mimeStr,"utf-8","base64")

    ; OK.. our MIME email is prepared.  Now use Chilkat REST to send it..

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

    ; Connect to the Amazon AWS REST server.
    ; such as https://email.us-west-2.amazonaws.com/
    bTls.i = 1
    port.i = 443
    bAutoReconnect.i = 1
    success.i = CkRest::ckConnect(rest,"email.us-west-2.amazonaws.com",port,bTls,bAutoReconnect)

    ; Provide AWS credentials for the REST call.
    authAws.i = CkAuthAws::ckCreate()
    If authAws.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkAuthAws::setCkAccessKey(authAws, "AWS_ACCESS_KEY")
    CkAuthAws::setCkSecretKey(authAws, "AWS_SECRET_KEY")
    ; the region should match our URL above..
    CkAuthAws::setCkRegion(authAws, "us-west-2")
    CkAuthAws::setCkServiceName(authAws, "ses")

    CkRest::ckSetAuthAws(rest,authAws)

    CkRest::ckAddQueryParam(rest,"Action","SendRawEmail")

    CkRest::ckAddQueryParam(rest,"RawMessage.Data",mimeBase64)

    ; Add up to 100 TO, CC, and BCC recipients.
    ; If your SES account is still in the sandbox, you also must verify every recipient email address except for the recipients 
    ; provided by the Amazon SES mailbox simulator. (See http://docs.aws.amazon.com/ses/latest/DeveloperGuide/mailbox-simulator.html)
    CkRest::ckAddQueryParam(rest,"Destination.ToAddresses.member.1","success@simulator.amazonses.com")
    ; Please do not test by sending email to Chilkat (Thank You!)
    ; Please do not test by sending email to Chilkat (Thank You!)
    ; Please do not test by sending email to Chilkat (Thank You!)
    CkRest::ckAddQueryParam(rest,"Destination.CcAddresses.member.1","support@chilkatsoft.com")
    CkRest::ckAddQueryParam(rest,"Destination.CcAddresses.member.2","somebody@yahoo.com")
    CkRest::ckAddQueryParam(rest,"Destination.BccAddresses.member.1","somebody@gmail.com")

    CkRest::ckAddQueryParam(rest,"Source","admin@chilkatdownload.com")

    ; Because there may be a large amount of data in the query params, use a POST
    ; where the params are sent in the body of the HTTP Request.
    responseXml.s = CkRest::ckFullRequestFormUrlEncoded(rest,"POST","/")
    If CkRest::ckLastMethodSuccess(rest) <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkEmail::ckDispose(email)
        CkCrypt2::ckDispose(crypt)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        ProcedureReturn
    EndIf

    ; A successful response will have a status code equal to 200.
    If CkRest::ckResponseStatusCode(rest) <> 200
        Debug "response status code = " + Str(CkRest::ckResponseStatusCode(rest))
        Debug "response status text = " + CkRest::ckResponseStatusText(rest)
        Debug "response header: " + CkRest::ckResponseHeader(rest)
        Debug "response body: " + responseXml
        CkEmail::ckDispose(email)
        CkCrypt2::ckDispose(crypt)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        ProcedureReturn
    EndIf

    ; Examine the successful XML response.
    xml.i = CkXml::ckCreate()
    If xml.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkXml::ckLoadXml(xml,responseXml)
    Debug CkXml::ckGetXml(xml)

    ; To get the MessageId
    Debug "MessageId: " + CkXml::ckChilkatPath(xml,"SendEmailResult|MessageId|*")

    ; A sample successful response:
    ; <?xml version="1.0" encoding="utf-8" ?>
    ; <SendEmailResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
    ;     <SendEmailResult>
    ;         <MessageId>010101579081d2c1-043c693f-5a23-4c64-a8c1-66187d3725a0-000000</MessageId>
    ;     </SendEmailResult>
    ;     <ResponseMetadata>
    ;         <RequestId>e2b5b480-8a4e-11e6-85cd-21b1f1f6d432</RequestId>
    ;     </ResponseMetadata>
    ; </SendEmailResponse>


    CkEmail::ckDispose(email)
    CkCrypt2::ckDispose(crypt)
    CkRest::ckDispose(rest)
    CkAuthAws::ckDispose(authAws)
    CkXml::ckDispose(xml)


    ProcedureReturn
EndProcedure