介绍
# Lead Inbox Automator
将线索捕获到一个集中的 Supabase 数据库中，并通过 Make.com 自动发送邮件。
## 描述
此技能为 Clawd 代理提供了一个完整的线索管理系统。它将线索存储在 Supabase 中，触发 Make.com Webhook 以自动回复邮件，并跟踪从“新建”到“合格”的完整对话生命周期。
## 配置
```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 分钟未回复）
## 架构
线索表： - id, email, name, phone, source, status, priority - custom_fields (JSON), metadata (JSON) - first_reply_sent_at, created_at
对话表： - id, lead_id, direction (inbound/outbound/automated) - content, subject, channel, sent_at
## 标签
线索, CRM, 销售, 自动化, 邮件, supabase
## 版本
1.0.0