unloopa-api

核心用法

Unloopa API 是一个面向本地企业销售的自动化营销平台，通过 REST API 提供完整的线索获取到成交转化流程。用户首先需配置 UNLOOPA_API_KEY 环境变量进行身份验证，所有请求通过 HTTPS 发送至 dashboard.unloopa.com/api/v1//。

核心工作流分为四个层次：

1. 全自动管道（/command）：输入自然语言指令（如"Find 50 plumbers in Miami"），系统自动完成 Google Maps 线索抓取 → AI 网站生成 → 邮箱/社交资料丰富 → 外联邮件发送。这是推荐的标准用法，无需手动编排各步骤。

2. 邮件外联：通过 /outreach 系列端点管理 SMTP 账户、自定义模板、批量发送。支持动态变量（{{business_name}}、、{{city}}` 等），新账户需 4 周预热期（5→25 封/天）。

3. 语音通话（Pro 专属）：需依次配置电话号码（最多 3 个）、语音 Agent（最多 3 个）、创建外呼活动。支持 ElevenLabs 语音合成，动态脚本变量，以及批量活动管理。

4. 完整漏斗：组合上述能力，实现从线索发现到电话成交的闭环。

关键前置检查：每次会话必须以 GET /quota 开始，获取用户套餐类型（Starter $47/月 或 Pro $97/月）、功能开关状态、剩余额度及购买链接，据此调整可用功能。

显著优点

• 端到端自动化：单一自然语言指令触发完整营销管道，大幅降低操作复杂度
• AI 原生设计：网站生成、邮件撰写、语音脚本均基于 AI，无需人工内容生产
• 灵活的线索筛选：支持城市、行业、评分、评论数、联系方式存在性等多维度过滤
• 合规友好机制：内置邮件预热、重复发送检测、DNS 健康检查
• 实时进度追踪：Job 轮询机制提供详细步骤状态（scraping → website_generation → enrichment → outreach）
• 动态变量系统：模板和脚本支持自动填充线索数据，实现个性化规模化

潜在缺点与局限性

• 处理延迟：完整管道需 8-10 分钟，网站生成是主要瓶颈；视频生成进一步延长耗时
• 套餐功能割裂：语音通话、视频生成等核心功能锁定 Pro 套餐，Starter 用户频繁遇到功能限制
• 硬数量限制：电话号码、语音 Agent 均限 3 个，大规模外呼需频繁轮换
• 指令解析限制：自然语言中的数字被忽略，必须通过 max_results 参数控制数量
• 外部依赖集中：完全依赖 Unloopa 平台稳定性，无本地降级方案
• 合规责任转移：平台提供工具，但用户需自行承担 CAN-SPAM、TCPA 等法规合规责任

适合的目标群体

• 本地营销代理商：为餐饮、家政、维修等本地服务企业批量生成线索和展示网站
• SaaS 销售团队：需要自动化冷启动流程的 B2B 销售组织
• 数字游民/独立开发者：希望快速验证本地服务市场需求的轻量级创业者
• 现有 Unloopa 付费用户：已通过 Whop 订阅平台，需要 API 集成扩展工作流

不适合：对数据隐私要求极高的企业、需要完全离线运行的场景、或无法承担合规审查成本的组织。

使用风险

• 合规风险：自动化邮件/电话可能触发反垃圾邮件法规诉讼，需建立退订机制和呼叫同意流程
• API 密钥泄露：Bearer Token 形式传输，环境变量配置不当可能导致密钥暴露
• 服务中断：依赖单一商业 SaaS，存在定价变更、服务下线或账户封禁风险
• 成本失控：语音通话按信用点计费（$0.20/通），批量活动可能产生意外账单
• 数据质量波动：Google Maps 抓取的数据完整性和准确性不受平台控制