用途:作为 Clay 集成的最小可用示例,演示如何把一条记录发送到 Clay 表格并获取 enrichment 结果。Clay 没有传统 SDK,交互方式为 webhook 输入数据、HTTP API 列输出数据以及网页界面操作。
前置条件:已完成 clay-install-auth 配置;Clay workbook 中已配置 webhook 数据源;表格中已至少添加一个 enrichment 列。
主要步骤:在 Clay 网页界面新建 workbook,添加 domain、company_name、employee_count、industry 等列,通过底部 + Add 选择 Webhooks > Monitor webhook 并复制 webhook URL,再添加 enrichment 列(+ Add Column > Enrich Company,以 domain 列为输入)。随后用 curl 向 webhook 发送记录,例如:curl -X POST "https://app.clay.com/api/v1/webhooks/YOUR_WEBHOOK_ID" -H "Content-Type: application/json" -d '{"domain": "openai.com"}'。也支持循环批量发送多个域名,或从 Node.js(fetch)、Python(requests,使用环境变量 CLAY_WEBHOOK_URL)发送线索对象,字段可包含 email、domain、first_name、last_name、linkedin_url。
错误处理:404 通常为 webhook URL 无效,需重新复制;422 为 JSON 负载无效,需先校验结构;行出现但无 enrichment 说明 enrichment 列未配置或未启用自动运行;429 为超出限流,可在请求间加 100ms 延迟;webhook 达到 50K 上限时需在表格上新建 webhook 源。
限制与注意事项:webhook 成功确认并不代表 enrichment 质量合格、数据使用合法或已发布到 CRM;建议使用合成或明确批准的测试记录,日志中避免记录 webhook URL 和个人数据,并在授权暂存表中检查配置条件后再继续。遇到 4xx/5xx 应停止,不要新建 webhook 或重复发送。