Email Engine

发送事务性邮件与外联邮件，执行批量营销活动，利用 AI 对入站邮件进行分类，生成上下文相关的自动回复，并管理可复用的邮件模板。专为需要在自主工作流中通过电子邮件与人类通信的 AI 代理而设计。

认证

所有端点均需支付 x402（Base L2 上的 USDC）。若未携带付款发起请求，将在 402 响应中返回定价信息。

端点

发送单封邮件

• 方法： POST
• 路径： /api/email/send
• 价格： 每次调用 $0.02
• 描述： 发送一封邮件。支持 HTML 与纯文本格式、附件及基于 reply-to 的会话线程追踪。

请求：

{
  "to": "mike@comfortzonehvac.com",
  "from": "cameron@mcfagentic.com",
  "subject": "Quick question about your scheduling, Mike",
  "body_html": "
Hi Mike,
I noticed Comfort Zone HVAC is crushing it on reviews...
",
  "body_text": "Hi Mike, I noticed Comfort Zone HVAC is crushing it on reviews...",
  "reply_to": "cameron@mcfagentic.com",
  "track_opens": true,
  "track_clicks": true
}

响应：

{
  "id": "msg_4k9xr2",
  "status": "sent",
  "to": "mike@comfortzonehvac.com",
  "sent_at": "2026-04-01T14:40:00Z"
}

批量发送

• 方法： POST
• 路径： /api/email/send-bulk
• 价格： 每个收件人 $0.01
• 描述： 向多个收件人发送营销活动邮件。支持个性化变量与错峰投递（staggered delivery）。

请求：

{
  "template_id": "tmpl_cold_outreach_v2",
  "recipients": [
    {"email": "mike@comfortzonehvac.com", "variables": {"first_name": "Mike", "company": "Comfort Zone HVAC"}},
    {"email": "sarah@northtexasair.com", "variables": {"first_name": "Sarah", "company": "North Texas Air"}}
  ],
  "from": "cameron@mcfagentic.com",
  "stagger_minutes": 5,
  "track_opens": true
}

响应：

{
  "campaign_id": "camp_7n3mp1",
  "total_recipients": 2,
  "status": "queued",
  "estimated_completion": "2026-04-01T14:50:00Z"
}

AI 分类

• 方法： POST
• 路径： /api/email/ai/classify
• 价格： 每次调用 $0.05
• 描述： 使用 AI 对入站邮件进行分类。返回意图（intent）、情感倾向（sentiment）、紧急程度（urgency）、分类标签（category）及建议操作（suggested action）。

请求：

{
  "subject": "Re: Quick question about your scheduling",
  "body": "Hey Cameron, this sounds interesting. We've been struggling with scheduling for a while. Can you tell me more about pricing?",
  "sender": "mike@comfortzonehvac.com"
}

响应：

{
  "classification": {
    "intent": "interested",
    "sentiment": "positive",
    "urgency": "medium",
    "category": "sales-reply",
    "suggested_action": "send-pricing",
    "confidence": 0.94
  }
}

AI 回复

• 方法： POST
• 路径： /api/email/ai/reply
• 价格： 每次调用 $0.10
• 描述： 利用 AI 为邮件会话生成上下文相关的回复。支持传入对话历史与 CRM 上下文信息。

请求：

{
  "thread": [
    {"from": "cameron@mcfagentic.com", "body": "Quick question about your scheduling..."},
    {"from": "mike@comfortzonehvac.com", "body": "This sounds interesting. Can you tell me more about pricing?"}
  ],
  "context": {
    "lead_stage": "qualified",
    "solution": "ai-scheduling-bundle",
    "monthly_price": "$497"
  },
  "tone": "casual-professional",
  "goal": "book-a-call"
}

响应：

{
  "reply": {
    "subject": "Re: Quick question about your scheduling",
    "body": "Hey Mike,\n\nGlad it caught your eye. The AI scheduling package runs $497/mo and typically pays for itself within the first month...",
    "call_to_action": "calendar-link"
  }
}

管理模板

• 方法： POST
• 路径： /api/email/templates
• 价格： 每次调用 $0.02
• 描述： 创建或更新支持个性化变量的可复用邮件模板。

请求：

{
  "name": "Cold Outreach v2",
  "subject": "Quick question about your {{pain_point}}, {{first_name}}",
  "body_html": "
Hi {{first_name}},
I noticed {{company}} is doing great work in {{industry}}...
",
  "variables": ["first_name", "company", "industry", "pain_point"]
}

响应：

{
  "id": "tmpl_cold_outreach_v2",
  "name": "Cold Outreach v2",
  "variables": ["first_name", "company", "industry", "pain_point"],
  "created_at": "2026-04-01T14:45:00Z"
}

典型应用场景

• 外联代理从销售线索池中向潜在客户发送个性化的冷邮件
• 客服代理对入站邮件进行 AI 分类，并将其路由至对应的工作流
• 自主销售代理根据潜在客户的回复，自动生成并发送跟进邮件
• 营销代理在细分的线索列表上运行培育式邮件系列（drip campaigns）
• 代理编排器（agent orchestrator）监控邮件会话，对紧急消息进行升级处理

定价