日誌與匯出
找出任何一封 Email 或 API 請求、查看發生了什麼事,並把資料下載成 CSV。
有三個工具可以幫你回答「這件事後來怎麼了」:Email 清單、API 請求日誌,以及 CSV 匯出。
郵件
在控制台的郵件頁面會列出團隊寄出的每一封 Email。可以用收件者、主旨或 Email ID 搜尋,並依狀態、API 金鑰、品牌(寄件網域)、來源(交易郵件或群發)與時間範圍篩選。
打開一封 Email 可以看到:
- 依序列出的事件:已寄出、已送達、延遲、退信、開信、點擊等,並附上延遲或退信的原因;
- 寄出時的內容(預覽、HTML 或純文字)與標頭;
- 尚未寄出的 Email 為什麼在等待(方案限制、預熱、安全檢查等);
- 它的送達率洞察分數。
透過 API,GET /emails 會列出 Email(最新的在前,採用游標分頁),GET /emails/{id} 會回傳單封 Email 與它的最後事件。兩者都需要具備完整權限的 API 金鑰。想在事件發生時就收到推送,請使用 Webhook。
所有方案的 Email 內文與歷史記錄都保存 30 天,之後會移除。
API 請求日誌
控制台的日誌會列出最近 30 天內,使用你的 API 金鑰或透過 MCP 發出的每一個請求。每一列顯示狀態、方法、路徑、發出請求的金鑰或已連接的應用程式,以及時間。
- 可依路徑、金鑰或請求 ID 搜尋。可依來源(API 金鑰或 MCP)、API 金鑰、狀態類別(
2xx、4xx、5xx)與時間範圍篩選。 - 打開一列可以看到請求與回應的內文,幫助你找出呼叫為什麼回傳
422或403。 - 內文只在是 JSON 且小於 64 KB 時才會儲存。Email 內容(
html、text)會以大小取代,權杖與密碼這類機密會顯示為[redacted],標頭則完全不儲存。 - 只有擁有者、管理員與開發者看得到內文。
匯出成 CSV
列出你資料的頁面都有匯出 CSV 按鈕。檔案會帶入你套用的篩選條件,因此與畫面上看到的一致。一次匯出最多 50,000 列,最新的在前。匯出使用你的控制台登入身分,所以沒有對應的 API 端點。
能匯出什麼取決於你的團隊角色:
| 匯出項目 | 位置 | 角色 |
|---|---|---|
| 聯絡人、退訂、群發收件者 | 聯絡人頁面,以及群發的頁面 | 擁有者、管理員、行銷 |
| 網域、API 金鑰、API 請求日誌 | 各自的頁面 | 擁有者、管理員、開發者 |
| 郵件、抑制清單、稽核日誌 | 郵件、聯絡人 → 抑制清單、設定 | 擁有者、管理員 |
請求日誌的匯出檔有 request_id、created_at、method、path、status、duration_ms 與 caller 欄位。聯絡人的匯出檔包含 unsubscribed 欄與 unsubscribed_domains 欄(* 代表整個團隊)。
清除個人資料
要從歷史記錄中移除某位收件者,請依聯絡人的說明,用 erase: true 刪除該聯絡人。這也會從 Email 歷史記錄、事件內容與 API 請求日誌中移除該位址。