(Tcl) Outlook Send HTML Email with Embedded Images and Attachments

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.

Chilkat Tcl Extension Downloads

Chilkat Tcl Extension Downloads

load ./chilkat.dll

# 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)
# resp is a CkHttpResponse
set resp [CkHttp_PostJson3 $http "https://graph.microsoft.com/v1.0/me/sendMail" "application/json" $json]
if {[CkHttp_get_LastMethodSuccess $http] != 1} 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
    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_CkHttpResponse $resp


delete_CkHttp $http
delete_CkStringBuilder $sbHtmlBody
delete_CkBinData $jpgStarfish
delete_CkBinData $jpgHedgeHogs
delete_CkBinData $attach1
delete_CkBinData $attach2
delete_CkJsonObject $json