Tcl
Tcl
Outlook Send HTML Email with Embedded Images and Attachments
See more Outlook Examples
This example sends an HTML email with both embedded images and attachments. Other examples exist for:- Sending plain-text email.
- Sending HTML email.
- Sending HTML email with embedded images.
- Sending plain-text email with attachments.
This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com
Chilkat Tcl Downloads
load ./chilkat.dll
set success 0
# Important: This example requires Chilkat v9.5.0.68 or greater.
# This example requires the Chilkat API to have been previously unlocked.
# See Global Unlock Sample for sample code.
set http [new_CkHttp]
# Use your previously obtained access token here:
# See the following examples for getting an access token:
# Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
# Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
# Refresh Access Token (Azure AD v2.0 Endpoint).
# Refresh Access Token (Azure AD Endpoint).
CkHttp_put_AuthToken $http "MICROSOFT_GRAPH_ACCESS_TOKEN"
# To send mail, we'll POST to the following endpoint:
#
# POST /users/{id | userPrincipalName}/sendMail
#
# (The special keyword "me" may be used in place of a principal name.)
#
# This example will send HTML email containing the following HTML body.
# After the
# <html>
# <head>
# <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
# <meta content="text/html; charset=utf-8">
# </head>
# <body bgcolor="#FFFFFF">
# <font face="Calibri">This is a test <b>HTML email with embedded images</b>.<br>
# <br>
# <img alt="" src="cid:starfish"><br>
# <img alt="" src="cid:hedgehogs"><br>
# </font>
# </body>
# </html>
# Build the HTML body...
set bCrlf 1
set sbHtmlBody [new_CkStringBuilder]
CkStringBuilder_AppendLine $sbHtmlBody "<html>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<head>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<meta content=\"text/html; charset=utf-8\">" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "</head>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<body bgcolor=\"#FFFFFF\">" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<font face=\"Calibri\">This is a test <b>HTML email with embedded images</b>.<br>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<br>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<img alt=\"\" src=\"cid:starfish\"><br>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "<img alt=\"\" src=\"cid:hedgehogs\"><br>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "</font>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "</body>" $bCrlf
CkStringBuilder_AppendLine $sbHtmlBody "</html>" $bCrlf
# Load the embedded image files.
set jpgStarfish [new_CkBinData]
CkBinData_LoadFile $jpgStarfish "qa_data/jpg/starfish.jpg"
set jpgHedgeHogs [new_CkBinData]
CkBinData_LoadFile $jpgHedgeHogs "qa_data/jpg/hedgehogs.jpg"
# Load files that are to be attached (not inline images)
set attach1 [new_CkBinData]
CkBinData_LoadFile $attach1 "qa_data/pdf/fishing.pdf"
set attach2 [new_CkBinData]
CkBinData_LoadFile $attach2 "qa_data/msword/sample.docx"
# The body of the POST request contains JSON that specifies the email subject, body,
# recipients, etc. This example will build the following JSON HTML email with
# two embedded images and two attachments.
#
# The only difference between an embedded inline image and an attachment is that the
# inline image must have a cid that corresponds to the "cid:" found in the "src" attribute
# of an IMG tag within the HTML body of the email. (The inline image is also marked as "isInline",
# whereas the attachments are not, but I don't know if this actually makes a difference..)
#
# {
# "message": {
# "subject": "Sample HTML Email with Embedded Images and Attachments",
# "body": {
# "contentType": "html",
# "content": "The HTML body goes here..."
# },
# "toRecipients": [
# {
# "emailAddress": {
# "name": "Chilkat Software",
# "address": "admin@chilkat.io"
# }
# },
# {
# "emailAddress": {
# "address": "chilkat.support@gmail.com"
# }
# }
# ],
# "ccRecipients": [
# {
# "emailAddress": {
# "name": "Chilkat Blog",
# "address": "admin@cknotes.com"
# }
# }
# ],
# "attachments": [
# {
# "@odata.type": "#microsoft.graph.fileAttachment",
# "name": "starfish.jpg",
# "contentType": "image/jpeg",
# "size": 6497,
# "isInline": true,
# "contentId": "starfish",
# "contentLocation": null,
# "contentBytes": "base64_data_here"
# },
# {
# "@odata.type": "#microsoft.graph.fileAttachment",
# "name": "hedgehogs.jpg",
# "contentType": "image/jpeg",
# "size": 48845,
# "isInline": true,
# "contentId": "hedgehogs",
# "contentLocation": null,
# "contentBytes": "base64_data_here"
# },
# {
# "@odata.type": "#microsoft.graph.fileAttachment",
# "name": "fishing.pdf",
# "contentType": "application/pdf",
# "size": <theActualSize>,
# "isInline": false,
# "contentBytes": "base64_data_here"
# },
# {
# "@odata.type": "#microsoft.graph.fileAttachment",
# "name": "sample.docx",
# "contentType": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
# "size": <theActualSize>,
# "isInline": false,
# "contentBytes": "base64_data_here"
# }
# ]
# },
# "saveToSentItems": true
# }
#
# Build the above JSON.
set json [new_CkJsonObject]
CkJsonObject_UpdateString $json "message.subject" "Sample HTML Email with Embedded Images and Attachments"
CkJsonObject_UpdateString $json "message.body.contentType" "html"
CkJsonObject_UpdateString $json "message.body.content" [CkStringBuilder_getAsString $sbHtmlBody]
CkJsonObject_UpdateString $json "message.toRecipients[0].emailAddress.name" "Chilkat Software"
CkJsonObject_UpdateString $json "message.toRecipients[0].emailAddress.address" "admin@chilkat.io"
CkJsonObject_UpdateString $json "message.toRecipients[1].emailAddress.address" "chilkat.support@gmail.com"
CkJsonObject_UpdateString $json "message.ccRecipients[0].emailAddress.name" "Chilkat Blog"
CkJsonObject_UpdateString $json "message.ccRecipients[0].emailAddress.address" "admin@cknotes.com"
CkJsonObject_UpdateString $json "message.attachments[0].\"@odata.type\"" "#microsoft.graph.fileAttachment"
CkJsonObject_UpdateString $json "message.attachments[0].name" "starfish.jpg"
CkJsonObject_UpdateString $json "message.attachments[0].contentType" "image/jpeg"
CkJsonObject_UpdateInt $json "message.attachments[0].size" [CkBinData_get_NumBytes $jpgStarfish]
CkJsonObject_UpdateBool $json "message.attachments[0].isInline" 1
# This contentId must match the "cid:" in the HTML
CkJsonObject_UpdateString $json "message.attachments[0].contentId" "starfish"
CkJsonObject_UpdateNull $json "message.attachments[0].contentLocation"
CkJsonObject_UpdateBd $json "message.attachments[0].contentBytes" "base64" $jpgStarfish
CkJsonObject_UpdateString $json "message.attachments[1].\"@odata.type\"" "#microsoft.graph.fileAttachment"
CkJsonObject_UpdateString $json "message.attachments[1].name" "hedgehogs.jpg"
CkJsonObject_UpdateString $json "message.attachments[1].contentType" "image/jpeg"
CkJsonObject_UpdateInt $json "message.attachments[1].size" [CkBinData_get_NumBytes $jpgHedgeHogs]
CkJsonObject_UpdateBool $json "message.attachments[1].isInline" 1
# This contentId must match the "cid:" in the HTML
CkJsonObject_UpdateString $json "message.attachments[1].contentId" "hedgehogs"
CkJsonObject_UpdateNull $json "message.attachments[1].contentLocation"
CkJsonObject_UpdateBd $json "message.attachments[1].contentBytes" "base64" $jpgHedgeHogs
CkJsonObject_UpdateString $json "message.attachments[2].\"@odata.type\"" "#microsoft.graph.fileAttachment"
CkJsonObject_UpdateString $json "message.attachments[2].name" "fishing.pdf"
CkJsonObject_UpdateString $json "message.attachments[2].contentType" "application/pdf"
CkJsonObject_UpdateInt $json "message.attachments[2].size" [CkBinData_get_NumBytes $attach1]
CkJsonObject_UpdateBool $json "message.attachments[2].isInline" 0
CkJsonObject_UpdateBd $json "message.attachments[2].contentBytes" "base64" $attach1
CkJsonObject_UpdateString $json "message.attachments[3].\"@odata.type\"" "#microsoft.graph.fileAttachment"
CkJsonObject_UpdateString $json "message.attachments[3].name" "sample.docx"
CkJsonObject_UpdateString $json "message.attachments[3].contentType" "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
CkJsonObject_UpdateInt $json "message.attachments[3].size" [CkBinData_get_NumBytes $attach2]
CkJsonObject_UpdateBool $json "message.attachments[3].isInline" 0
CkJsonObject_UpdateBd $json "message.attachments[3].contentBytes" "base64" $attach2
CkJsonObject_UpdateBool $json "saveToSentItems" 1
# -------------------------------------------------------------
# Important: This example requires Chilkat v9.5.0.68 or greater.
# -------------------------------------------------------------
# Send the HTTP POST (i.e. send the HTML email)
set resp [new_CkHttpResponse]
set success [CkHttp_HttpJson $http "POST" "https://graph.microsoft.com/v1.0/me/sendMail" $json "application/json" $resp]
if {$success == 0} then {
puts [CkHttp_lastErrorText $http]
delete_CkHttp $http
delete_CkStringBuilder $sbHtmlBody
delete_CkBinData $jpgStarfish
delete_CkBinData $jpgHedgeHogs
delete_CkBinData $attach1
delete_CkBinData $attach2
delete_CkJsonObject $json
delete_CkHttpResponse $resp
exit
}
# The send succeeded if the response status code = 202.
# In the success case, there is no response body. (We just get the response code to know that it succeeded.)
if {[CkHttpResponse_get_StatusCode $resp] != 202} then {
CkJsonObject_Load $json [CkHttpResponse_bodyStr $resp]
CkJsonObject_put_EmitCompact $json 0
puts [CkJsonObject_emit $json]
puts "Failed, response status code = [CkHttpResponse_get_StatusCode $resp]"
} else {
puts "Outlook HTML Mail Sent."
}
delete_CkHttp $http
delete_CkStringBuilder $sbHtmlBody
delete_CkBinData $jpgStarfish
delete_CkBinData $jpgHedgeHogs
delete_CkBinData $attach1
delete_CkBinData $attach2
delete_CkJsonObject $json
delete_CkHttpResponse $resp