Tcl

SES Send Plain-Text Email

See more Amazon SES Examples

Sends a simple plain-text email to one or more recipients.

See SES SendEmail for more information.

Tcl

load ./chilkat.dll

set success 0

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

set rest [new_CkRest]

# Connect to the Amazon AWS REST server.
# such as https://email.us-west-2.amazonaws.com/
set bTls 1
set port 443
set bAutoReconnect 1
set success [CkRest_Connect $rest "email.us-west-2.amazonaws.com" $port $bTls $bAutoReconnect]

# Provide AWS credentials for the REST call.
set authAws [new_CkAuthAws]

CkAuthAws_put_AccessKey $authAws "AWS_ACCESS_KEY"
CkAuthAws_put_SecretKey $authAws "AWS_SECRET_KEY"
# the region should match our URL above..
CkAuthAws_put_Region $authAws "us-west-2"
CkAuthAws_put_ServiceName $authAws "ses"

CkRest_SetAuthAws $rest $authAws

CkRest_AddQueryParam $rest "Action" "SendEmail"

CkRest_AddQueryParam $rest "Message.Body.Text.Data" "This is a sample plain-text email."
CkRest_AddQueryParam $rest "Message.Body.Text.Charset" "utf-8"

CkRest_AddQueryParam $rest "Message.Subject.Data" "Sample plain-text SES email"
CkRest_AddQueryParam $rest "Message.Subject.Charset" "utf-8"

# 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_AddQueryParam $rest "Destination.ToAddresses.member.1" "success@simulator.amazonses.com"
# Please do not test by sending email to Chilkat (Thanks!)
# Please do not test by sending email to Chilkat (Thanks!)
# Please do not test by sending email to Chilkat (Thanks!)
CkRest_AddQueryParam $rest "Destination.CcAddresses.member.1" "support@chilkatsoft.com"
CkRest_AddQueryParam $rest "Destination.CcAddresses.member.2" "somebody@yahoo.com"
CkRest_AddQueryParam $rest "Destination.BccAddresses.member.1" "somebody@gmail.com"

CkRest_AddQueryParam $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.
set responseXml [CkRest_fullRequestFormUrlEncoded $rest "POST" "/"]
if {[CkRest_get_LastMethodSuccess $rest] == 0} then {
    puts [CkRest_lastErrorText $rest]
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# A successful response will have a status code equal to 200.
if {[CkRest_get_ResponseStatusCode $rest] != 200} then {
    puts "response status code = [CkRest_get_ResponseStatusCode $rest]"
    puts "response status text = [CkRest_responseStatusText $rest]"
    puts "response header: [CkRest_responseHeader $rest]"
    puts "response body: $responseXml"
    delete_CkRest $rest
    delete_CkAuthAws $authAws
    exit
}

# Examine the successful XML response.
set xml [new_CkXml]

CkXml_LoadXml $xml $responseXml
puts [CkXml_getXml $xml]

# To get the MessageId
puts "MessageId: [CkXml_chilkatPath $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>

delete_CkRest $rest
delete_CkAuthAws $authAws
delete_CkXml $xml