Zig
Zig
Outlook Send HTML Email with Embedded Images
See more Outlook Examples
This example sends an HTML email with embedded images. Other examples exist for:- Sending plain-text email.
- Sending email with attachments.
- Sending HTML email with embedded images and attachments.
This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com
Chilkat Zig Downloads
const std = @import("std");
const chilkat = @import("chilkat");
pub fn main(init: std.process.Init) !void {
const alloc = init.arena.allocator();
// 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.
const http = try chilkat.Http.init();
defer http.deinit();
// 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.setAuthToken("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...
const b_crlf = true;
const sb_html_body = try chilkat.StringBuilder.init();
defer sb_html_body.deinit();
sb_html_body.appendLine("<html>", b_crlf) catch {};
sb_html_body.appendLine("<head>", b_crlf) catch {};
sb_html_body.appendLine("<meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">", b_crlf) catch {};
sb_html_body.appendLine("<meta content=\"text/html; charset=utf-8\">", b_crlf) catch {};
sb_html_body.appendLine("</head>", b_crlf) catch {};
sb_html_body.appendLine("<body bgcolor=\"#FFFFFF\">", b_crlf) catch {};
sb_html_body.appendLine("<font face=\"Calibri\">This is a test <b>HTML email with embedded images</b>.<br>", b_crlf) catch {};
sb_html_body.appendLine("<br>", b_crlf) catch {};
sb_html_body.appendLine("<img alt=\"\" src=\"cid:starfish\"><br>", b_crlf) catch {};
sb_html_body.appendLine("<img alt=\"\" src=\"cid:hedgehogs\"><br>", b_crlf) catch {};
sb_html_body.appendLine("</font>", b_crlf) catch {};
sb_html_body.appendLine("</body>", b_crlf) catch {};
sb_html_body.appendLine("</html>", b_crlf) catch {};
// Load the image files.
const jpg_starfish = try chilkat.BinData.init();
defer jpg_starfish.deinit();
jpg_starfish.loadFile("qa_data/jpg/starfish.jpg") catch {};
const jpg_hedge_hogs = try chilkat.BinData.init();
defer jpg_hedge_hogs.deinit();
jpg_hedge_hogs.loadFile("qa_data/jpg/hedgehogs.jpg") catch {};
// 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:
//
// {
// "message": {
// "subject": "Sample HTML Email with Embedded Images",
// "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"
// }
// ]
// },
// "saveToSentItems": true
// }
//
// Build the above JSON.
const json = try chilkat.JsonObject.init();
defer json.deinit();
json.updateString("message.subject", "Sample HTML Email with Embedded Images") catch {};
json.updateString("message.body.contentType", "html") catch {};
json.updateString("message.body.content", try sb_html_body.getAsString(alloc)) catch {};
json.updateString("message.toRecipients[0].emailAddress.name", "Chilkat Software") catch {};
json.updateString("message.toRecipients[0].emailAddress.address", "admin@chilkat.io") catch {};
json.updateString("message.toRecipients[1].emailAddress.address", "chilkat.support@gmail.com") catch {};
json.updateString("message.ccRecipients[0].emailAddress.name", "Chilkat Blog") catch {};
json.updateString("message.ccRecipients[0].emailAddress.address", "admin@cknotes.com") catch {};
json.updateString("message.attachments[0].\"@odata.type\"", "#microsoft.graph.fileAttachment") catch {};
json.updateString("message.attachments[0].name", "starfish.jpg") catch {};
json.updateString("message.attachments[0].contentType", "image/jpeg") catch {};
json.updateInt("message.attachments[0].size", jpg_starfish.getNumBytes()) catch {};
json.updateBool("message.attachments[0].isInline", true) catch {};
// This contentId must match the "cid:" in the HTML
json.updateString("message.attachments[0].contentId", "starfish") catch {};
json.updateNull("message.attachments[0].contentLocation") catch {};
json.updateBd("message.attachments[0].contentBytes", "base64", jpg_starfish) catch {};
json.updateString("message.attachments[1].\"@odata.type\"", "#microsoft.graph.fileAttachment") catch {};
json.updateString("message.attachments[1].name", "hedgehogs.jpg") catch {};
json.updateString("message.attachments[1].contentType", "image/jpeg") catch {};
json.updateInt("message.attachments[1].size", jpg_hedge_hogs.getNumBytes()) catch {};
json.updateBool("message.attachments[1].isInline", true) catch {};
// This contentId must match the "cid:" in the HTML
json.updateString("message.attachments[1].contentId", "hedgehogs") catch {};
json.updateNull("message.attachments[1].contentLocation") catch {};
json.updateBd("message.attachments[1].contentBytes", "base64", jpg_hedge_hogs) catch {};
json.updateBool("saveToSentItems", true) catch {};
// -------------------------------------------------------------
// Important: This example requires Chilkat v9.5.0.68 or greater.
// -------------------------------------------------------------
// Send the HTTP POST (i.e. send the HTML email)
const resp = try chilkat.HttpResponse.init();
defer resp.deinit();
http.httpJson("POST", "https://graph.microsoft.com/v1.0/me/sendMail", json, "application/json", resp) catch {
std.debug.print("{s}\n", .{try http.getLastErrorText(alloc)});
return;
};
// 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.getStatusCode() != 202) {
json.load(try resp.getBodyStr(alloc)) catch {};
json.setEmitCompact(false);
std.debug.print("{s}\n", .{try json.emit(alloc)});
std.debug.print("Failed, response status code = {d}\n", .{resp.getStatusCode()});
} else {
std.debug.print("Outlook HTML Mail Sent.\n", .{});
}
}