跳到内容
Esc
↑↓导航↵打开⌘J预览
本页内容

日誌與匯出

找出任何一封 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 請求日誌中移除該位址。

这个页面有帮助吗?