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 适合把联系表单垃圾信息识别加入服务端工作流，特别是需要多站点管理、低交互阻力和可配置数据使用方式的团队。

正式接入前应使用自己的真实消息集评估误判，并同时落实失败回退、人工复核、密钥保护、隐私告知和成本监控。