用途:管理 Vapi 外呼 Campaign,适合需要把联系人、生命周期和结果放在一起管理的持久化外呼任务。创建即启动或排期,没有草稿或单独启动动作。
主要能力:创建、排期、复制、检查、取消、归档和排查 Campaign;支持 CSV 或 API 导入联系人;可配置并发、排期窗口、Webhook 和预拨号检查。
使用方式:新集成使用 /v2/campaign,旧版 /campaign 仅在维护既有集成时使用。API 密钥从 VAPI_API_KEY 读取,仅用于可信服务器。创建时需指定 name、assistantId 或 squadId 之一、phoneNumberId、非空 customers 数组和 maxConcurrency。复制使用 duplicateFromCampaignId。取消用 PATCH /v2/campaign/{id} 并传 {"status":"cancelled"}。归档用 DELETE /v2/campaign/{id}。
限制:Campaign 创建后不可变,不能直接修改呼叫方、联系人、排期、并发或 Webhook 配置。联系人 1 到 10000 个,优先 E.164 号码。CSV 有 5 MB 限制。Vapi 免费号码不能启动 Campaign。启动会产生真实计费呼叫,需确认目标、号码、受众数量、时间、并发和 Webhook 行为。超时或 5xx 不能证明失败,重试前先搜索是否已创建。合规要求需用户自行核实。