Sample code for 30+ languages & platforms
C++

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 C++ Downloads

C++
#include <CkJsonObject.h>
#include <CkStringBuilder.h>
#include <CkAuthAws.h>
#include <CkSocket.h>
#include <CkRest.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    success = false;

    CkJsonObject request;
    request.UpdateString("FromEmailAddress","sender@example.com");
    request.UpdateString("DefaultContent.Template.TemplateContent.Subject","Appointment reminder");
    request.UpdateString("DefaultContent.Template.TemplateContent.Text","Hello {{name}}, your appointment is {{slot}}.");
    request.UpdateString("DefaultContent.Template.TemplateData","{\"name\":\"there\",\"slot\":\"in your booking confirmation\"}");

    CkJsonObject firstReminder;
    firstReminder.UpdateString("name","Avery");
    firstReminder.UpdateString("slot","Tuesday at 9 AM Central");
    request.UpdateString("BulkEmailEntries[0].Destination.ToAddresses[0]","avery@example.com");
    request.UpdateString("BulkEmailEntries[0].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData",firstReminder.emit());

    CkJsonObject secondReminder;
    secondReminder.UpdateString("name","Robin");
    secondReminder.UpdateString("slot","Wednesday at 2 PM Central");
    request.UpdateString("BulkEmailEntries[1].Destination.ToAddresses[0]","robin@example.com");
    request.UpdateString("BulkEmailEntries[1].ReplacementEmailContent.ReplacementTemplate.ReplacementTemplateData",secondReminder.emit());
    //  Use the same AWS Region for the identity, endpoint, and Signature Version 4.
    const char *region = "us-west-2";
    CkStringBuilder host;
    host.Append("email.");
    host.Append(region);
    host.Append(".amazonaws.com");

    CkAuthAws signer;
    //  Supply the credentials from your application's credential provider.
    signer.put_AccessKey("AWS_ACCESS_KEY_ID");
    signer.put_SecretKey("AWS_SECRET_ACCESS_KEY");
    signer.put_Region(region);
    signer.put_ServiceName("ses");

    CkSocket connection;
    connection.put_RequireSslCertVerify(true);
    success = connection.Connect(host.getAsString(),443,true,10000);
    if (success != true) {
        std::cout << connection.lastErrorText() << "\r\n";
        return;
    }

    CkRest rest;
    success = rest.UseConnection(connection,false);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    success = rest.SetAuthAws(signer);
    if (success != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    //  For temporary AWS credentials, supply the session token from the same provider.
    const char *sessionToken = "";
    if (sessionToken != "") {
        rest.AddQueryParam("X-Amz-Security-Token",sessionToken);
    }

    rest.AddHeader("Content-Type","application/json");
    const char *responseText = rest.fullRequestString("POST","/v2/email/outbound-bulk-emails",request.emit());
    if (rest.get_LastMethodSuccess() != true) {
        std::cout << rest.lastErrorText() << "\r\n";
        return;
    }

    if (rest.get_ResponseStatusCode() != 200) {
        std::cout << "SES returned HTTP " << rest.get_ResponseStatusCode() << " " << responseText << "\r\n";
        return;
    }

    CkJsonObject response;
    success = response.Load(responseText);
    if (success != true) {
        std::cout << response.lastErrorText() << "\r\n";
        return;
    }

    int count = response.SizeOfArray("BulkEmailEntryResults");
    if (count != request.SizeOfArray("BulkEmailEntries")) {
        std::cout << "Incomplete results. Reconcile the original batch before retrying." << "\r\n";
        return;
    }

    int i = 0;
    while ((i < count)) {
        response.put_I(i);
        request.put_I(i);
        const char *recipient = request.stringOf("BulkEmailEntries[i].Destination.ToAddresses[0]");
        const char *status = response.stringOf("BulkEmailEntryResults[i].Status");
        if (status == "SUCCESS") {
            std::cout << recipient << " accepted: " << response.stringOf("BulkEmailEntryResults[i].MessageId") << "\r\n";
        }
        else {
            if ((status == "ACCOUNT_THROTTLED") || (status == "TRANSIENT_FAILURE")) {
                std::cout << recipient << " retry later: " << status << "\r\n";
            }
            else {
                std::cout << recipient << " review before retry: " << status << " " << response.stringOf("BulkEmailEntryResults[i].Error") << "\r\n";
            }

        }

        i = i + 1;
    }
    }