SendEmail

---

🎯 Purpose

The SendEmail node enables automated email delivery within ThreoAI workflows.
It supports both simple notifications and dynamic, templated emails, making it useful for customer communication, order confirmations, appointment reminders, and team notifications.

📥 Inputs

• Dynamic Data: Email addresses, subject lines, and message bodies can be pulled from previous nodes.
• Supports multiple recipients and CC addresses.

📤 Outputs

The node returns confirmation of successful email delivery or an error message.

Output Format (example):

    {
      "email_status": "sent",
      "recipient": "user@example.com"
    }

⚙️ Parameters

Name	Type	Required	Default	Description
To Email (toEmail)	Text	✅	Empty	Primary recipient email address. Supports static or dynamic values.
CC Email (toEmailCc)	Text	Optional	Empty	Additional recipients copied on the email.
Subject (subject)	Text	✅	Empty	Subject line for the email.
Body (body)	Rich text	✅	Empty	Main content of the email (supports HTML and variables).
Template Engine (templateEngine)	Dropdown	Optional	Simple Variables	Defines how placeholders are processed. Options: Simple Variables, Advanced Templates.
Custom SMTP (customSmtp)	Toggle	Optional	Off	Enable to send emails via your own SMTP server instead of the default.
SMTP Host (smtpHost)	Text	Required if custom SMTP	Empty	SMTP server address (e.g., smtp.gmail.com).
SMTP Username (smtpUser)	Text	Required if custom SMTP	Empty	SMTP account username.
SMTP Password (smtpPass)	Password	Required if custom SMTP	Empty	SMTP account password (use app-specific credentials if available).
SMTP Port (smtpPort)	Number	Required if custom SMTP	587	Communication port (25, 465, 587, or 2525).
From Email (customFromEmail)	Text	Optional	Empty	Sender address displayed in recipients’ inboxes.

💡 Example Usage

• Customer Welcome Email: Send a personalized welcome message when a new account is created.
• Order Confirmation: Email order and tracking details to customers, with CC to fulfillment teams.
• Appointment Reminder: Notify patients of upcoming appointments 24 hours in advance.
• Support Ticket Updates: Alert customers and internal staff when ticket status changes.

📘 Best Practices

• Use short, clear subject lines to improve open rates.
• Apply dynamic variables ({{customerName}}, {{orderNumber}}) for personalization.
• For better deliverability, configure custom SMTP with your business domain.
• Avoid spam-trigger words and monitor bounce rates.
• Use SPF/DKIM authentication to improve trust and reduce spam filtering.
• Store SMTP credentials securely and rotate them periodically.

🧪 Test Cases

• Given: toEmail = test@example.com, subject = "Hello"
  → Expected: { "email_status": "sent" }

• Given: ccEmail = manager@example.com, body includes {{orderNumber}} = 12345
  → Expected: email sent to both addresses with variable replaced.