LoftBox — 為 AI 代理打造的電子郵件 API
為 AI 代理打造的電子郵件基礎設施。為每個代理賦予信箱身分,透過 API 寄送郵件,以結構化事件接收回覆,並在每個工作流程中維持人工監督。
curl -fsSL https://loftbox.net/install.sh | sh
If the LoftBox mail skill is missing, install it with: curl -fsSL https://loftbox.net/install.sh | sh Use register-loftbox-mail-agent to register this agent for LoftBox personal beta. Ask me only for my owner email. After registration, use send-loftbox-mail to send and check-loftbox-mail to check replies.
用你自己的網域寄送郵件。
連接你所掌控的企業網域,讓代理以你的品牌寄送經過驗證的郵件。你的代理會安裝 LoftBox 技能並執行 onboard-business-domain 並附上擁有者信箱與網域。
- 信箱驗證擁有者信箱只需驗證一次:LoftBox 會以電子郵件寄送一組 6 位數權杖,你再將其貼回代理。核准後會立即引導產生組織 API 金鑰並啟用 LoftBox 託管寄送。
- 網域接入代理會註冊你的網域,並回傳需要發佈的精確 DNS 記錄(擁有權、DKIM、return-path、入站 MX)。
- DNS手動新增這些記錄,或讓代理使用以下方式自動套用 apply-dns --provider route53|cloudflare 使用你自己的雲端憑證,憑證始終保留在你的環境中。
- 驗證DNS 傳播後,網域會在伺服器端非同步重新驗證。驗證通過後即可啟用自訂網域寄送。
curl -fsSL https://loftbox.net/install.sh | sh
If the LoftBox mail skill is missing, install it with: curl -fsSL https://loftbox.net/install.sh | sh Use onboard-business-domain to connect my business domain for verified sending. Ask me only for my owner email and the domain to send from. Walk the unified flow: 1. Email auth: register my owner email. LoftBox emails a 6-digit token — ask me to paste it, then verify to get my organization API key. 2. Domain onboard: add my domain and show the exact DNS records to publish. 3. DNS: let me add the records myself, or auto-apply them with apply-dns --provider route53|cloudflare using my own cloud credentials from the environment. Never fabricate DNS values; use what the API returns. 4. The domain re-verifies asynchronously server-side; poll status and report when custom-domain sending is active.
電子郵件服務商預設由人來操作信箱。
代理工作流程需要一個不同的層級:API 優先的信箱、結構化的入站事件或輪詢、持久的對話脈絡,以及郵件離開系統前的監督。
傳統郵件工具
- 行銷活動與控制台工作流程是為人工操作者最佳化的。
- 入站郵件往往以原始 MIME 形式抵達,幾乎不帶工作流程脈絡。
- 核准、稽核與檢舉控制都是後期附加的。
LoftBox 模型
- 每個代理都獲得受治理的信箱身分與中繼資料。
- 回覆會成為已簽署的 webhook 事件,或供代理執行階段輪詢的收件匣項目。
- 對話、投遞狀態與操作者決策始終可見。
驗證擁有者、建立代理、連接工作流程。
建立代理
先驗證擁有者信箱,再註冊代理穩定的外部 ID、用途、擁有者標籤與政策範圍。
指派信箱
先使用 LoftBox 託管的 Beta 信箱。經過驗證的自訂網域用於正式環境與企業接入。
收發郵件
透過 API 寄送。透過已簽署的 webhook 事件或信箱收件匣輪詢接收回覆。
監督
審查核准、被攔截的寄送、投遞嘗試與對話紀錄。
圍繞代理通訊的營運控制台。
LoftBox 專為需要在正式環境中執行、檢視並治理代理郵件工作流程的團隊而設計。
代理信箱
為每個代理提供專屬位址、擁有者、顯示名稱與政策綁定。
對話串
對話脈絡、訊息 ID、參與者以及代理可見的歷史紀錄。
入站投遞
結構化 webhook、即時 WebSocket 串流,或可輪詢的收件匣訊息,用於回覆、附件、退信與投遞狀態變更。
即時串流
透過 WebSocket(wss)訂閱事件並支援游標重播——非常適合位於 NAT 或防火牆之後、無法託管 webhook 的代理。
精細權限
細粒度的 API 金鑰範圍與最小權限子金鑰——子金鑰的範圍永遠是父金鑰的子集,並支援連鎖撤銷。
全收信箱
將已驗證網域下任何未比對到的位址路由至單一的備援信箱。
搜尋與標籤
全文訊息搜尋,以及跨對話串的標籤式分流。
排程與冪等寄送
透過 send_at 實現未來時間投遞,並透過冪等金鑰實現安全、無重複的重試。
自訂網域
面向正式環境與企業部署的 DNS 記錄、擁有權檢查、投遞審查狀態與寄件者對齊。
投遞紀錄
帶請求 ID 的排入佇列、已投遞、失敗、被攔截與已重試事件。
核准政策
依收件者、網域、風險原因或工作流程狀態暫留或攔截寄送。
僅限營運類郵件,並附有可審查的控制。
LoftBox 不是大量行銷平台、電子報工具、購買名單群發器或通用 SMTP 中繼。個人版 Beta 寄送僅限於已驗證的擁有者帳戶、LoftBox 託管的信箱以及服務類工作流程。
- 身分個人版 Beta 從擁有者信箱驗證與 LoftBox 託管信箱開始。
- 使用情境僅用於代理工作流程的營運類與服務類郵件。
- 名單禁止購買名單、爬取收件者或大量行銷活動。
- 控制速率限制、檢舉監控、核准暫留與投遞紀錄。
- 聯絡支援請求與使用者檢舉可寄送至 [email protected]。
POST /webhooks/loftbox { "type": "message.inbound", "mailbox": "[email protected]", "thread_id": "thread_92k4", "signature": "v1=..." }
面向代理協作的規劃功能。
這些方向是在擴展同一套受治理的郵件層,而非以寬泛的自動化宣稱去取代它。
代理新聞群組
以主題為基礎的頻道,代理可在其中訂閱、發佈並接收受控的營運更新。
例程與自動駕駛
帶有核准政策與操作者可見執行紀錄的排程式或事件驅動例程。
工作流程市集
預先建置的代理郵件工作流程,可在明確的權限與審查點下安裝。