Lua Requires Chilkat v9.5.0.68+
Lua
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 Lua Downloads
local chilkat = require("chilkat")
-- This example requires the Chilkat API to have been previously unlocked.
-- See Global Unlock Sample for sample code.
local http = chilkat.Http.new()
-- 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).
http.auth_token = "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...
local bCrlf = true
local sbHtmlBody = chilkat.StringBuilder.new()
sbHtmlBody:append_line("<html>", bCrlf)
sbHtmlBody:append_line("<head>", bCrlf)
sbHtmlBody:append_line("<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">", bCrlf)
sbHtmlBody:append_line("<meta content=\"text/html; charset=utf-8\">", bCrlf)
sbHtmlBody:append_line("</head>", bCrlf)
sbHtmlBody:append_line("<body bgcolor=\"#FFFFFF\">", bCrlf)
sbHtmlBody:append_line("<font face=\"Calibri\">This is a test <b>HTML email with embedded images</b>.<br>", bCrlf)
sbHtmlBody:append_line("<br>", bCrlf)
sbHtmlBody:append_line("<img alt=\"\" src=\"cid:starfish\"><br>", bCrlf)
sbHtmlBody:append_line("<img alt=\"\" src=\"cid:hedgehogs\"><br>", bCrlf)
sbHtmlBody:append_line("</font>", bCrlf)
sbHtmlBody:append_line("</body>", bCrlf)
sbHtmlBody:append_line("</html>", bCrlf)
-- Load the embedded image files.
local jpgStarfish = chilkat.BinData.new()
jpgStarfish:load_file("qa_data/jpg/starfish.jpg")
local jpgHedgeHogs = chilkat.BinData.new()
jpgHedgeHogs:load_file("qa_data/jpg/hedgehogs.jpg")
-- Load files that are to be attached (not inline images)
local attach1 = chilkat.BinData.new()
attach1:load_file("qa_data/pdf/fishing.pdf")
local attach2 = chilkat.BinData.new()
attach2:load_file("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.
local json = chilkat.JsonObject.new()
json:update_string("message.subject", "Sample HTML Email with Embedded Images and Attachments")
json:update_string("message.body.contentType", "html")
json:update_string("message.body.content", sbHtmlBody:get_as_string())
json:update_string("message.toRecipients[0].emailAddress.name", "Chilkat Software")
json:update_string("message.toRecipients[0].emailAddress.address", "admin@chilkat.io")
json:update_string("message.toRecipients[1].emailAddress.address", "chilkat.support@gmail.com")
json:update_string("message.ccRecipients[0].emailAddress.name", "Chilkat Blog")
json:update_string("message.ccRecipients[0].emailAddress.address", "admin@cknotes.com")
json:update_string("message.attachments[0].\"@odata.type\"", "#microsoft.graph.fileAttachment")
json:update_string("message.attachments[0].name", "starfish.jpg")
json:update_string("message.attachments[0].contentType", "image/jpeg")
json:update_int("message.attachments[0].size", jpgStarfish.num_bytes)
json:update_bool("message.attachments[0].isInline", true)
-- This contentId must match the "cid:" in the HTML
json:update_string("message.attachments[0].contentId", "starfish")
json:update_null("message.attachments[0].contentLocation")
json:update_bd("message.attachments[0].contentBytes", "base64", jpgStarfish)
json:update_string("message.attachments[1].\"@odata.type\"", "#microsoft.graph.fileAttachment")
json:update_string("message.attachments[1].name", "hedgehogs.jpg")
json:update_string("message.attachments[1].contentType", "image/jpeg")
json:update_int("message.attachments[1].size", jpgHedgeHogs.num_bytes)
json:update_bool("message.attachments[1].isInline", true)
-- This contentId must match the "cid:" in the HTML
json:update_string("message.attachments[1].contentId", "hedgehogs")
json:update_null("message.attachments[1].contentLocation")
json:update_bd("message.attachments[1].contentBytes", "base64", jpgHedgeHogs)
json:update_string("message.attachments[2].\"@odata.type\"", "#microsoft.graph.fileAttachment")
json:update_string("message.attachments[2].name", "fishing.pdf")
json:update_string("message.attachments[2].contentType", "application/pdf")
json:update_int("message.attachments[2].size", attach1.num_bytes)
json:update_bool("message.attachments[2].isInline", false)
json:update_bd("message.attachments[2].contentBytes", "base64", attach1)
json:update_string("message.attachments[3].\"@odata.type\"", "#microsoft.graph.fileAttachment")
json:update_string("message.attachments[3].name", "sample.docx")
json:update_string("message.attachments[3].contentType", "application/vnd.openxmlformats-officedocument.wordprocessingml.document")
json:update_int("message.attachments[3].size", attach2.num_bytes)
json:update_bool("message.attachments[3].isInline", false)
json:update_bd("message.attachments[3].contentBytes", "base64", attach2)
json:update_bool("saveToSentItems", true)
-- Send the HTTP POST (i.e. send the HTML email)
local resp = chilkat.HttpResponse.new()
local success = http:http_json("POST", "https://graph.microsoft.com/v1.0/me/sendMail", json, "application/json", resp)
if not success then
print(http.last_error_text)
return
end
-- 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 resp.status_code ~= 202 then
json:load(resp.body_str)
json.emit_compact = false
print(json:emit())
print("Failed, response status code = " .. resp.status_code)
else
print("Outlook HTML Mail Sent.")
end