NoteMail

NoteMail is not just an email tool—it’s an AI Communication Partner that helps you build, maintain, and deepen relationships through email.

Overview

NoteMail transforms email marketing from a tedious task into an intelligent, automated relationship-building system:

import { NoteMail } from '@notemail/sdk'
 
const client = new NoteMail({
  apiKey: process.env.NOTEMAIL_API_KEY
})
 
// Send personalized emails with AI assistance
await client.emails.send({
  to: '[email protected]',
  intent: 'welcome-new-customer',
  personalization: {
    name: 'John',
    company: 'Acme Corp'
  }
})

Key Features

NoteMail solves five fundamental problems in email marketing:

1. Who to Email? 📧

• Lead Generation System: Import from third-party databases, trade shows, and industry directories
• Web Scraping Engine: Automatically discover potential users from LinkedIn, company websites, and public sources
• API Integration: Sync contacts from CRM, product backends, and third-party platforms
• Bulk Import: Support for CSV/Excel with field mapping and deduplication

2. Who Are They? 👤

• Dynamic Profile System: Automatically update user profiles based on behavior events
  • Basic attributes: name, email, company, position, industry
  • Behavioral tags: open rate, click rate, reply rate, engagement level
  • Interest preferences: clicked links, browsed content categories
  • Lifecycle stage: new, active, dormant, churned
• AI Profile Enhancement: Analyze email content and replies to infer user intent and needs
• Event Timeline: Record all interactions to form complete user stories

3. How to Write? ✍️

• Multi-Scenario Template System:
  • Transactional emails: OTP codes, account notifications, order confirmations (multi-language)
  • Marketing emails: product promotions, event announcements, content distribution
  • Personalized emails: one-on-one sales emails, customer follow-ups
• Visual Editor: Drag-and-drop component library, no coding required
• Variable System: Support personalization variables (name, company, behavioral data), type-safe
• AI Writing Assistant:
  • Generate personalized content based on user profiles
  • Optimize subject lines and body text to improve open rates
  • Multi-language translation and localization
• Version Control: Template versioning with A/B testing and rollback support

4. Did They See It? 👀

• Full-Chain Tracking: Real-time tracking of email lifecycle via AWS SES/SNS
  • Sent
  • Delivered
  • Opened (filter machine opens - Apple MPP)
  • Clicked (track specific clicked links)
  • Bounced (soft/hard bounce)
  • Complained (marked as spam)
• Real-Time Alerts: Instant notifications for key behaviors (first open, click, reply)
• Visual Analytics:
  • Funnel analysis: sent → delivered → opened → clicked → converted
  • Time distribution: best open time, click heatmap
  • Device distribution: mobile/desktop/email client
  • Geographic distribution: user locations
• STO (Send Time Optimization): Intelligently recommend best send times based on user history

5. How Did They Respond? 💬

• Unified Inbox: Centrally manage all user replies to avoid missing any
• Smart Classification: AI automatically identifies reply intent
  • High intent: inquiries, consultations, meeting requests
  • Medium intent: requesting materials, feedback
  • Low intent: polite replies, auto-replies
  • Negative: complaints, unsubscribe requests
• Sentiment Analysis: Identify user emotions (positive/neutral/negative), prioritize negative feedback
• Automated Tasks: Automatically create tasks based on reply content and assign to relevant team members
• Conversation Threads: Automatically associate email exchanges to form complete conversation history
• Profile Updates: Automatically update user profiles and tags based on reply content
• AI Reply Assistance: Provide reply suggestions to improve response efficiency

Product Architecture

NoteMail is built on a modern, scalable architecture:

┌─────────────────────────────────────────────────────────────┐
│                      Dashboard Layer                         │
│         Intent-Driven Interface & AI Recommendations         │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                   Lead Acquisition Layer                     │
│    Lead Database Integration · Web Scraping · API Sync      │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                     Profile Layer                            │
│   Dynamic Profiles · Behavioral Tags · AI Enhancement        │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                    Delivery Layer                            │
│  Template System · Visual Editor · AI Assistant · STO        │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                    Tracking Layer                            │
│  Real-Time Events · Analytics · Machine Open Filtering       │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                   Interaction Layer                          │
│   Unified Inbox · AI Classification · Auto Reply             │
└─────────────────────────┬───────────────────────────────────┘
                          ↓
┌─────────────────────────────────────────────────────────────┐
│                   Automation Layer                           │
│      Journey Orchestration · A/B Testing · Optimization      │
└─────────────────────────────────────────────────────────────┘

Core Principles

1. Intent-Driven Experience

Features are presented by “what you want to do” rather than by modules. Users immediately see intent cards when entering the system:

• 💌 Welcome new customers
• 🔥 Announce promotions
• 🌱 Re-engage dormant users
• 📈 Report achievements

2. AI Co-Creation

AI doesn’t write for you—it co-creates with you:

• Real-time Co-writing: AI generates drafts, you adjust the tone
• Tone Slider: Sincere ↔ Casual ↔ Formal
• Smart Suggestions: “Add empathy sentence”, “Optimize subject line”
• Multiple Drafts: “Generate another version” for comparison

3. Dual Persona Experience

Developers and marketers share the underlying infrastructure but each has their optimized path:

4. Frictionless Intelligence

AI suggestions don’t interrupt operations—they flow naturally into the process:

• Personalized Greetings: “Good morning! 3 customers need follow-up, want to send?”
• AI Recommended Actions: “12 users clicked but didn’t buy, suggest sending limited-time offer”
• Smart Inbox: Automatically identify high-intent replies, prioritize processing

5. Reflective Learning

Data analysis transforms into personal communication growth stories:

• Story-based Reports: “Your narrative opening increased email click rate by 18%”
• Relationship Garden: Visualize contact relationship strength
• Interaction Timeline: Complete journey of each relationship

Technology Stack

NoteMail is built with modern, production-ready technologies:

• Frontend: Next.js 15, React 19, TypeScript, Tailwind CSS
• Backend: tRPC, Drizzle ORM, PostgreSQL
• Email: AWS SES, Custom SMTP support
• AI: OpenAI GPT-4, Claude, LangChain
• Deployment: Docker, Vercel, Railway

Getting Started

Install NoteMail SDK in your project:

npm install @notemail/sdk
# or
pnpm add @notemail/sdk

Set up your API client:

import { NoteMail } from '@notemail/sdk'
 
const client = new NoteMail({
  apiKey: process.env.NOTEMAIL_API_KEY,
  baseUrl: 'https://api.notemail.me'
})
 
// Send a simple email
await client.emails.send({
  to: '[email protected]',
  subject: 'Welcome to NoteMail',
  html: '<p>Hello, world!</p>'
})
 
// Send with AI assistance
await client.emails.sendWithAI({
  to: '[email protected]',
  intent: 'welcome-new-customer',
  context: {
    userName: 'John',
    productName: 'Premium Plan',
    trialDays: 14
  }
})

Next Steps

Community

Join our community to get help, share ideas, and stay updated:

• GitHub Discussions: Share ideas and ask questions 
• GitHub Issues: Report bugs and request features 
• Twitter: Follow @notemail  for updates
• Discord: Join our community server 

License

NoteMail is MIT licensed .