AM 支援以你的自有網域寄信，並透過正確的 DKIM 簽章提升送達率。
系統內建模板、投遞追蹤與退信處理。
寄送郵件
直接寄送
POST /api/accounts/:account_id/email-messages/send以明確內容寄送郵件：
- From/To/CC/BCC 聯絡人
- 主旨與內文（text + HTML）
模板寄送
POST /api/accounts/:account_id/email-messages/send-template使用模板加上變數替換寄送（{{name}} → “Jane”）。
Email Identities
Email identity 是帳戶可使用的核准寄件地址。
| 操作 | Endpoint |
|---|---|
| 建立 | POST /api/accounts/:account_id/email-identities |
| 列表 | GET /api/accounts/:account_id/email-identities |
| 更新 | PATCH /api/email-identities/:email_identity_id |
| 刪除 | DELETE /api/email-identities/:email_identity_id |
網域與 DKIM
設定流程
- 註冊網域：
POST /api/accounts/:account_id/domains - 執行檢查：
POST /api/domains/:domain_id/checks - 建立 DKIM 金鑰：
POST /api/domains/:domain_id/dkim-keys - 啟用 DKIM 金鑰：
PATCH /api/dkim-keys/:dkim_key_id
DNS 紀錄
| Record | Name | 用途 |
|---|---|---|
| TXT | _acme.mail.example.com | 網域擁有權驗證 |
| TXT | selector._domainkey.mail.example.com | DKIM 公鑰 |
網域檢查
AM 會驗證：
- TXT 擁有權紀錄
- CNAME 設定
- A 記錄
- TLS 憑證
- SPF、DKIM、DMARC、BIMI
- MX 記錄
Email 模板
可建立含變數的可重用模板：
Subject: Welcome, {{name}}!
Hi {{name}},
Your account {{account_name}} is ready.| 操作 | Endpoint |
|---|---|
| 建立 | POST /api/accounts/:account_id/email-templates |
| 列表 | GET /api/accounts/:account_id/email-templates |
| 取得 | GET /api/email-templates/:email_template_id |
| 更新 | PATCH /api/email-templates/:email_template_id |
| 刪除 | DELETE /api/email-templates/:email_template_id |
投遞追蹤
事件可追蹤郵件生命週期。event_type 由 provider 決定，常見值如下：
| Event | 說明 |
|---|---|
queued | 已接受並排入投遞佇列 |
sent | 已交付至收件端 MTA |
bounced | 永久投遞失敗 |
Message 與 Event API
| 操作 | Endpoint |
|---|---|
| 列出訊息 | GET /api/accounts/:account_id/email-messages |
| 搜尋訊息 | POST /api/accounts/:account_id/email-messages/search |
| 依搜尋條件刪除訊息 | POST /api/accounts/:account_id/email-messages/search-delete |
| 取得訊息 | GET /api/email-messages/:email_message_id |
| 列出事件 | GET /api/accounts/:account_id/email-message-events |
| 搜尋事件 | POST /api/accounts/:account_id/email-message-events/search |
| 依搜尋條件刪除事件 | POST /api/accounts/:account_id/email-message-events/search-delete |
退信處理
硬退信會自動建立 email address ban，以保護寄件信譽。
| 操作 | Endpoint |
|---|---|
| 列出封鎖 | GET /api/accounts/:account_id/email-address-bans |
| 建立封鎖 | POST /api/accounts/:account_id/email-address-bans |
| 刪除封鎖 | DELETE /api/accounts/:account_id/email-address-bans/:email_address_ban_id |
相關
- 網域 - 網域設定
- DKIM 金鑰 - 簽章金鑰
- Email Identity - 核准寄件者
- Email Message - 郵件紀錄
- Email Template - 模板