Sending Email

Send transactional and marketing emails through CloudContactAI using your verified domain.

Overview

CloudContactAI supports sending both transactional emails (order confirmations, password resets, notifications) and marketing emails (newsletters, promotions, drip campaigns). Emails are sent through your choice of email provider, with built-in support for Amazon SES and Twilio SendGrid, ensuring high deliverability.

Prerequisites

Before sending email, you need to:

Configure your email domain with Amazon SES
Verify your sending domain in CloudContactAI
Have your API key and Client ID ready

Email Types

Transactional Email

One-to-one emails triggered by a specific action (e.g., a user signs up, places an order, or resets a password). These are time-sensitive and expected by the recipient.

Examples:

Welcome emails
Order confirmations
Password reset links
Account notifications

Marketing Email

Bulk emails sent to a list of opted-in contacts for promotional or informational purposes.

Examples:

Newsletters
Product announcements
Promotional offers
Event invitations

Sending a Single Email

Use the SDK to send a single transactional email:

import { CCAI } from 'ccai-node';

const ccai = new CCAI({
  clientId: process.env.CCAI_CLIENT_ID,
  apiKey: process.env.CCAI_API_KEY
});

const response = await ccai.email.sendSingle(
  "John",                              // First name
  "Doe",                               // Last name
  "[email protected]",                  // Recipient email
  "Welcome to Our Service",            // Subject
  "<p>Hello ${firstName},</p><p>Thank you for signing up!</p>",  // HTML body
  "[email protected]",           // Sender email
  "[email protected]",             // Reply-to email
  "Your Company",                      // Sender name
  "Welcome Email"                      // Campaign title
);

console.log(`Email sent with ID: ${response.id}`);

Sending an Email Campaign

Send to multiple recipients in a single call:

const emailAccounts = [
  { firstName: "John", lastName: "Doe", email: "[email protected]" },
  { firstName: "Jane", lastName: "Smith", email: "[email protected]" }
];

const campaign = {
  subject: "Monthly Newsletter",
  title: "July Newsletter",
  message: `
    <h1>Monthly Newsletter</h1>
    <p>Hello \${firstName},</p>
    <p>Here are our updates for this month...</p>
  `,
  senderEmail: "[email protected]",
  replyEmail: "[email protected]",
  senderName: "Your Company Newsletter",
  accounts: emailAccounts,
  campaignType: "EMAIL",
  addToList: "noList",
  contactInput: "accounts",
  fromType: "single",
  senders: []
};

const response = await ccai.email.sendCampaign(campaign);
console.log(`Email campaign sent with ID: ${response.id}`);

Scheduling an Email

Schedule an email campaign to send at a future time:

const tomorrow = new Date();
tomorrow.setDate(tomorrow.getDate() + 1);
tomorrow.setHours(10, 0, 0, 0);

const scheduledCampaign = {
  subject: "Upcoming Event Reminder",
  title: "Event Reminder Campaign",
  message: "<p>Hello ${firstName},</p><p>Reminder about our event tomorrow.</p>",
  senderEmail: "[email protected]",
  replyEmail: "[email protected]",
  senderName: "Your Company Events",
  accounts: emailAccounts,
  scheduledTimestamp: tomorrow.toISOString(),
  scheduledTimezone: "America/New_York"
};

const response = await ccai.email.sendCampaign(scheduledCampaign);
console.log(`Email campaign scheduled with ID: ${response.id}`);

Dynamic Variables

Use ${variableName} syntax in your email subject and body to personalize content:

Variable	Description
`${firstName}`	Recipient's first name
`${lastName}`	Recipient's last name
`${email}`	Recipient's email address

HTML Email Best Practices

Use inline CSS styles (many email clients strip <style> blocks)
Keep email width under 600px for mobile compatibility
Include a plain-text fallback when possible
Always include an unsubscribe link in marketing emails
Test rendering across major email clients (Gmail, Outlook, Apple Mail)

Deliverability Tips

Only send to contacts who have explicitly opted in
Keep your bounce rate below 2%
Keep your complaint rate below 0.1%
Warm up new sending domains gradually
Use a consistent "From" address
Authenticate your domain with SPF, DKIM, and DMARC

Configure Email Domain - Set up Amazon SES
Register Email Domain - Verify your domain with CCAI
Multi-Domain Email - Send from multiple domains