介绍
# Lead Inbox Automator
将线索捕获到集中的 Supabase 数据库中，并通过 Make.com 实现自动邮件自动化。
## 描述
该技能为 Clawd 代理提供了一个完整的线索管理系统。它在 Supabase 中存储线索，触发 Make.com Webhook 以发送自动回复邮件，并跟踪从“new”到“qualified”的完整对话生命周期。
## 配置
```json { "supabaseUrl": "https://your-project.supabase.co", "supabaseKey": "eyJ...your-service-role-key", "orgId": "550e8400-e29b-41d4-a716-446655440000", "defaultPriority": "medium" } ```
**重要：** 请使用 Service Role Key（服务角色密钥），而不是 Anon Key（匿名密钥），以获得完整的数据库访问权限。
## 动作
### createLead
创建一个新线索并自动触发自动化工作流。
**参数：** - `email`（字符串，必填）：联系人电子邮件地址 - `name`（字符串，可选）：联系人姓名 - `phone`（字符串，可选）：电话号码 - `source`（字符串，可选）：来源渠道（默认：“clawd_agent”） - `priority`（字符串，可选）：“low”、“medium”、“high”、“urgent” - `custom_fields`（对象，可选）：任何附加数据
**返回：** ```json { "success": true, "lead_id": "uuid", "status": "new", "automation_triggered": true, "message": "Lead captured. Auto-reply will be sent within 60 seconds." } ```
**示例：** ```typescript const result = await skill.createLead({ email: "[email protected]", name: "Max Mustermann", source: "chat_bot", custom_fields: { product: "saas_basic" } }); ```
### getLead
检索线索详细信息，包括完整的对话历史。
**参数：** - `id`（字符串，必填）：线索 UUID
**返回：** 包含 `conversations` 数组和 `reply_pending` 布尔值的线索对象。
### listLeads
列出线索，支持筛选选项。
**参数：** - `status`（字符串，可选）：按状态筛选 - `priority`（字符串，可选）：按优先级筛选 - `limit`（数字，可选）：最大结果数（默认：50） - `dateFrom`（字符串，可选）：ISO 日期筛选
**返回：** 线索数组和总数。
### updateStatus
更新线索生命周期状态。
**参数：** - `id`（字符串，必填）：线索 UUID - `status`（字符串，必填）：“qualified”、“won”、“lost”等。 - `notes`（字符串，可选）：资格认定备注
### addConversation
向线索线程添加手动回复或备注。
**参数：** - `leadId`（字符串，必填）：线索 UUID - `content`（字符串，必填）：消息文本 - `subject`（字符串，可选）：主题行
### getAutomationStatus
检查自动回复邮件是否已成功发送。
**参数：** - `leadId`（字符串，必填）：线索 UUID
**返回：** ```json { "auto_reply_sent": true, "minutes_since_creation": 2, "automation_ok": true } ```
## 使用流程
1. **捕获：** 当用户表达兴趣时，调用 `createLead()` 2. **验证：** 60-120 秒后，调用 `getAutomationStatus()` 确认自动回复 3. **资格认定：** 对话期间，如果感兴趣，将状态更新为“qualified” 4. **记录：** 使用 `addConversation()` 存储您的代理回复
## 错误处理
常见错误： - 电子邮件格式无效 - 重复线索（24 小时内） - Supabase 凭据缺失 - 自动化超时（超过 5 分钟无回复）
## 数据库架构
Leads 表： - id, email, name, phone, source, status, priority - custom_fields (JSON), metadata (JSON) - first_reply_sent_at, created_at
Conversations 表： - id, lead_id, direction (inbound/outbound/automated) - content, subject, channel, sent_at
## 标签
lead, crm, sales, automation, email, supabase
## 版本
1.0.0