Bot Butcher

Bot Butcher 是什麼

Bot Butcher是Hillside Lab Inc.所提供的網站聯絡表單反垃圾郵件API，其主要功能是幫助開發者在訊息進入電子郵箱、客戶關係系統或工單系統之前，先對其進行分類。

它分析訪客提交的訊息內容，並可結合網站域名理解上下文，返回是否屬於垃圾資訊的結構化結果。

主要功能

• 上下文分類：將表單訊息發送到分類介面，可附上網站域名，讓系統區分正常諮詢、推銷內容及自動化垃圾訊息。
• 結構化判定：介面會回傳 spam 的布林值、message_id 與狀態碼，程式可據此放行、隔離、標記或拒絕訊息。
• 歷史記錄查詢：使用 message_id 可查詢已處理消息的時間、原文、域名、元數據及分類結果，便於排查工作流。
• 自訂元資料：請求可附上 JSON 元資料，用於儲存表單、租戶、活動或內部記錄的識別資訊。
• 無驗證碼體驗：檢測發生在服務端，不要求訪客識別圖片或完成互動挑戰，適合降低表單提交的阻力。
• 多站點使用：定價權益包含不限網站表單，可由同一帳戶保護多個專案，但調用量仍按帳戶累計。
• 隱私控制：使用者可開啟不保存訊息以及禁止將訊息用於訓練的選項，目前兩項均不額外收費。

輸入與輸出

接入流程

1. 使用信箱完成註冊驗證，或透過支援的第三方帳戶登入，並同意服務條款。
2. 在帳戶中取得 API 金鑰，將金鑰保存在服務端環境變數或金鑰管理系統中。
3. 在聯絡表單後端收集 message，並按需要加入 domain 和 metadata。
4. 向分類接口發送請求，在請求頭中加入金鑰，再解析返回的 spam 值和 message_id。
5. 根據業務風險設定放行、隔離、人工複核或拒絕規則，不要只依賴單次自動判定永久刪除消息。
6. 用測試消息覆蓋正常諮詢、推銷、不同語言、空內容和異常請求，確認錯誤處理與超時策略。
7. 上線後監控調用量、誤判和費用，並按隱私要求設定是否保存消息及是否用於訓練。

開發語言與實現方式

文件提供了 cURL、Python、JavaScript、TypeScript、Java、C# 與 Rust 的請求範例，其核心功能亦能被其他可發送網路請求並解析 JSON 的後端語言所調用。

這些程式碼片段屬於介面呼叫範例，不應視為已發布的完整官方 SDK。

適合用戶與場景

• 需要減少聯絡表單垃圾郵件的企業網站與獨立站開發者。
• 為多個客戶維護網站，希望共用一套反垃圾接口的建站團隊。
• 需要在潛在客戶進入客戶關係系統前進行篩選的行銷和銷售技術團隊。
• 運營網站生成器、垂直 SaaS 或多租戶表單產品的平台開發者。
• 希望避免訪客完成傳統驗證碼，同時保留服務端風險判斷的產品團隊。

產品優勢

• 接口輸入和返回結構簡潔，容易嵌入現有表單後端及消息處理鏈路。
• 域名上下文可幫助模型理解同一句話在不同網站中的含義。
• 不保存消息和禁止訓練選項為敏感業務提供更明確的數據控制。
• 不限表單數量，多個站點可以集中管理調用與費用。
• 按低用量設定免費或低固定費用，適合先用真實流量驗證效果。

能力邊界與使用限制

• 任何自動分類都可能出現誤判，重要的銷售線索應進入隔離區或由人員重新核對，而非直接永久刪除。
• 官網公佈的準確率來自其自行進行的人工評分基準，並非獨立第三方測試，實際效果取決於語言、行業和消息分布。
• domain 為可選欄位，但省略後上下文會減少；官方隱私說明稱其測試中準確率約下降 6%。
• 介面需要將表單內容傳送給外部服務，在處理敏感、醫療、財務或受監管的資訊之前，應先完成合規評估。
• 無效域名仍可能得到分類結果和提示，但判斷品質可能降低，呼叫方應校驗輸入。
• 網路超時、額度或鑒權錯誤不能等同於正常消息或垃圾消息，應用必須設定獨立的失敗策略。
• 目前未公開具體模型名稱、固定回應時延、服務等級協議或獨立安全審計報告。

價格與計費

階梯是根據每個月的請求量來計算的，實際帳單還可能受到稅費、帳戶所在地區或結算設定的影響，應以帳戶結算頁面為準。

條款寫明訂閱終止前已支付或產生的費用不可退，取消不會免除已累計費用。

隱私、安全與資料處理

• 可在配置中選擇不保存消息，使提交內容不進入歷史消息儲存。
• 可選擇禁止發送的訊息用於模型訓練，該選項目前不額外收費。
• domain 可以省略以減少共享的網站上下文，但會在隱私與分類效果之間形成取捨。
• 隱私說明指出，儲存資料時所採用的方式符合 HIPAA 的要求，但僅使用此服務並不能讓客戶的業務自動符合所有的醫療合規義務。
• 隱私政策說明可能收集帳戶資料、設備和瀏覽資訊，並把必要資訊提供給服務供應商。
• 支付卡由支付處理商處理，Bot Butcher 表示不直接收集卡片資訊。
• API 金鑰只能放在服務端，不能嵌入公開網頁、行動前端或公開程式碼倉庫。
• 提交前應減少無關個人數據，在自己的隱私政策中說明處理目的、第三方處理和保存規則。

API、代碼與開源狀態

總結

Bot Butcher 適合將聯絡表單的垃圾資訊識別功能整合到伺服器端的工作流程中，特別適用於需要多站點管理、降低互動負擔，且能自訂資料使用方式的團隊。

正式接入前應使用自己的真實消息集評估誤判，並同時落實失敗回退、人工複核、金鑰保護、隱私告知和成本監控。