Delphi DLL
Delphi DLL
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 Delphi DLL Downloads
uses
Winapi.Windows, Winapi.Messages, System.SysUtils, System.Variants, System.Classes, Vcl.Graphics,
Vcl.Controls, Vcl.Forms, Vcl.Dialogs, Vcl.StdCtrls, Http, StringBuilder, HttpResponse, BinData, JsonObject;
...
procedure TForm1.Button1Click(Sender: TObject);
var
success: Boolean;
http: HCkHttp;
bCrlf: Boolean;
sbHtmlBody: HCkStringBuilder;
jpgStarfish: HCkBinData;
jpgHedgeHogs: HCkBinData;
json: HCkJsonObject;
resp: HCkHttpResponse;
begin
success := False;
// 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.
http := CkHttp_Create();
// 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_putAuthToken(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...
bCrlf := True;
sbHtmlBody := CkStringBuilder_Create();
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 image files.
jpgStarfish := CkBinData_Create();
CkBinData_LoadFile(jpgStarfish,'qa_data/jpg/starfish.jpg');
jpgHedgeHogs := CkBinData_Create();
CkBinData_LoadFile(jpgHedgeHogs,'qa_data/jpg/hedgehogs.jpg');
// 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.
json := CkJsonObject_Create();
CkJsonObject_UpdateString(json,'message.subject','Sample HTML Email with Embedded Images');
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_getNumBytes(jpgStarfish));
CkJsonObject_UpdateBool(json,'message.attachments[0].isInline',True);
// 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_getNumBytes(jpgHedgeHogs));
CkJsonObject_UpdateBool(json,'message.attachments[1].isInline',True);
// 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_UpdateBool(json,'saveToSentItems',True);
// -------------------------------------------------------------
// Important: This example requires Chilkat v9.5.0.68 or greater.
// -------------------------------------------------------------
// Send the HTTP POST (i.e. send the HTML email)
resp := CkHttpResponse_Create();
success := CkHttp_HttpJson(http,'POST','https://graph.microsoft.com/v1.0/me/sendMail',json,'application/json',resp);
if (success = False) then
begin
Memo1.Lines.Add(CkHttp__lastErrorText(http));
Exit;
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 (CkHttpResponse_getStatusCode(resp) <> 202) then
begin
CkJsonObject_Load(json,CkHttpResponse__bodyStr(resp));
CkJsonObject_putEmitCompact(json,False);
Memo1.Lines.Add(CkJsonObject__emit(json));
Memo1.Lines.Add('Failed, response status code = ' + IntToStr(CkHttpResponse_getStatusCode(resp)));
end
else
begin
Memo1.Lines.Add('Outlook HTML Mail Sent.');
end;
CkHttp_Dispose(http);
CkStringBuilder_Dispose(sbHtmlBody);
CkBinData_Dispose(jpgStarfish);
CkBinData_Dispose(jpgHedgeHogs);
CkJsonObject_Dispose(json);
CkHttpResponse_Dispose(resp);
end;