Delphi DLL
Delphi DLL
Amazon SES v2: Send private appointment reminders and inspect each result
See more Amazon SES Examples
Replace the two recipients with test mailboxes you control. The example supplies an inline template and one private destination per entry. Store each successful message ID against its appointment. Schedule a retry with backoff only for entries with a retryable outcome. Correct permanent errors before resubmission.
SendBulkEmail · Per-entry outcomes
Chilkat Delphi DLL Downloads
var
success: Boolean;
request: HCkJsonObject;
firstReminder: HCkJsonObject;
secondReminder: HCkJsonObject;
region: PWideChar;
host: HCkStringBuilder;
signer: HCkAuthAws;
connection: HCkSocket;
rest: HCkRest;
sessionToken: PWideChar;
responseText: PWideChar;
response: HCkJsonObject;
count: Integer;
i: Integer;
recipient: PWideChar;
status: PWideChar;
begin
success := False;
// Assumes Chilkat is unlocked. See Global Unlock Sample.
success := False;
request := CkJsonObject_Create();
CkJsonObject_UpdateString(request,'FromEmailAddress','sender@example.com');
CkJsonObject_UpdateString(request,'DefaultContent.Template.TemplateContent.Subject','Appointment reminder');
CkJsonObject_UpdateString(request,'DefaultContent.Template.TemplateContent.Text','Hello {{name}}, your appointment is {{slot}}.');
CkJsonObject_UpdateString(request,'DefaultContent.Template.TemplateData','{"name":"there","slot":"in your booking confirmation"}');
firstReminder := CkJsonObject_Create();
CkJsonObject_UpdateString(firstReminder,'name','Avery');
CkJsonObject_UpdateString(firstReminder,'slot','Tuesday at 9 AM Central');
CkJsonObject_UpdateString(request,'BulkEmailEntries[0].Destination.ToAddresses[0]','avery@example.com');
CkJsonObject_UpdateString(request,'BulkEmailEntries[0].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData',CkJsonObject__emit(firstReminder));
secondReminder := CkJsonObject_Create();
CkJsonObject_UpdateString(secondReminder,'name','Robin');
CkJsonObject_UpdateString(secondReminder,'slot','Wednesday at 2 PM Central');
CkJsonObject_UpdateString(request,'BulkEmailEntries[1].Destination.ToAddresses[0]','robin@example.com');
CkJsonObject_UpdateString(request,'BulkEmailEntries[1].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData',CkJsonObject__emit(secondReminder));
// Use the same AWS Region for the identity, endpoint, and Signature Version 4.
region := 'us-west-2';
host := CkStringBuilder_Create();
CkStringBuilder_Append(host,'email.');
CkStringBuilder_Append(host,region);
CkStringBuilder_Append(host,'.amazonaws.com');
signer := CkAuthAws_Create();
// Supply the credentials from your application's credential provider.
CkAuthAws_putAccessKey(signer,'AWS_ACCESS_KEY_ID');
CkAuthAws_putSecretKey(signer,'AWS_SECRET_ACCESS_KEY');
CkAuthAws_putRegion(signer,region);
CkAuthAws_putServiceName(signer,'ses');
connection := CkSocket_Create();
CkSocket_putRequireSslCertVerify(connection,True);
success := CkSocket_Connect(connection,CkStringBuilder__getAsString(host),443,True,10000);
if (success <> True) then
begin
Memo1.Lines.Add(CkSocket__lastErrorText(connection));
Exit;
end;
rest := CkRest_Create();
success := CkRest_UseConnection(rest,connection,False);
if (success <> True) then
begin
Memo1.Lines.Add(CkRest__lastErrorText(rest));
Exit;
end;
success := CkRest_SetAuthAws(rest,signer);
if (success <> True) then
begin
Memo1.Lines.Add(CkRest__lastErrorText(rest));
Exit;
end;
// For temporary AWS credentials, supply the session token from the same provider.
sessionToken := '';
if (sessionToken <> '') then
begin
CkRest_AddQueryParam(rest,'X-Amz-Security-Token',sessionToken);
end;
CkRest_AddHeader(rest,'Content-Type','application/json');
responseText := CkRest__fullRequestString(rest,'POST','/v2/email/outbound-bulk-emails',CkJsonObject__emit(request));
if (CkRest_getLastMethodSuccess(rest) <> True) then
begin
Memo1.Lines.Add(CkRest__lastErrorText(rest));
Exit;
end;
if (CkRest_getResponseStatusCode(rest) <> 200) then
begin
Memo1.Lines.Add('SES returned HTTP ' + IntToStr(CkRest_getResponseStatusCode(rest)) + ' ' + responseText);
Exit;
end;
response := CkJsonObject_Create();
success := CkJsonObject_Load(response,responseText);
if (success <> True) then
begin
Memo1.Lines.Add(CkJsonObject__lastErrorText(response));
Exit;
end;
count := CkJsonObject_SizeOfArray(response,'BulkEmailEntryResults');
if (count <> CkJsonObject_SizeOfArray(request,'BulkEmailEntries')) then
begin
Memo1.Lines.Add('Incomplete results. Reconcile the original batch before retrying.');
Exit;
end;
i := 0;
while (i < count) do
begin
CkJsonObject_putI(response,i);
CkJsonObject_putI(request,i);
recipient := CkJsonObject__stringOf(request,'BulkEmailEntries[i].Destination.ToAddresses[0]');
status := CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].Status');
if (status = 'SUCCESS') then
begin
Memo1.Lines.Add(recipient + ' accepted: ' + CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].MessageId'));
end
else
begin
if ((status = 'ACCOUNT_THROTTLED') or (status = 'TRANSIENT_FAILURE')) then
begin
Memo1.Lines.Add(recipient + ' retry later: ' + status);
end
else
begin
Memo1.Lines.Add(recipient + ' review before retry: ' + status + ' ' + CkJsonObject__stringOf(response,'BulkEmailEntryResults[i].Error'));
end;
end;
i := i + 1;
end;
CkJsonObject_Dispose(request);
CkJsonObject_Dispose(firstReminder);
CkJsonObject_Dispose(secondReminder);
CkStringBuilder_Dispose(host);
CkAuthAws_Dispose(signer);
CkSocket_Dispose(connection);
CkRest_Dispose(rest);
CkJsonObject_Dispose(response);