> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 外呼活动
> 上传联系人列表，让智能体逐一处理——支持呼叫时间窗口、重试和实时进度。
营销活动会代表您拨打联系人列表：选择一个智能体，上传 CSV，设置允许呼叫的时间，然后 ThunderPhone 会依次处理列表——按照您选择的计划重试无人接听和语音信箱。您可在 **互动 → 营销活动**（`/dashboard/campaigns`）下找到它们。
如需进行一次性的程序化呼叫，请改用[外呼 API](/zh/guides/place-outbound-calls)。
## 前提条件
* 一个已部署的语音智能体。
* 一个已连接到您组织的 **VoIP 电话号码**，用于外呼——演示号码仅支持呼入，无法发起营销活动呼叫。请参阅[连接 VoIP 提供商](/zh/guides/voip-providers)。
* 包含 `phone` 或 `phone_number` 列的联系人 CSV 文件（或粘贴的 JSON）。**每次上传最多 5,000 行**，采用 UTF-8 编码。任何额外的列都会作为每个联系人的变量保留在营销活动的联系人记录中。
## 创建营销活动
为其命名，选择**语音智能体**，并选择**外呼号码**（您的其中一个 VoIP 号码）。
电话号码无效的行会被单独拒绝，并返回其行号——其余行仍可正常导入。
选择一个**时区**以及每日的**开始/结束**时间窗口；营销活动仅会在该窗口内拨号。时间窗口可跨越午夜（例如 22:00 → 02:00）。您还可以选择设置**开始时间**以安排启动时间，以及设置**结束时间**，营销活动将在此后自动完成。
* **并发呼叫数**——此营销活动同时进行的呼叫数量（1–10，默认值为 3）。您的组织在所有功能中的**并发外呼数**也上限为 **10**，因此并行营销活动会共享该额度。
* **最大尝试次数**——每位联系人最多可拨打的次数（默认值为 2）。
* **重试退避时间（分钟）**——重试前的等待时间（默认值为 60）。
* **重试条件**——触发重试的结果：**无人接听**、**语音信箱**、**失败**（默认全部启用）。
营销活动会以草稿形式创建——仅可在营销活动处于草稿状态时添加联系人。启动营销活动需要明确同意承担通话费用。如果设置了未来的**开始时间**，其状态将变为*已计划*；否则会立即开始*运行*。
## 结果和重试机制
每次通话后，联系人都会获得一个结果——成功通话会标记为已完成；如果通话被判定为无人接听、检测为语音信箱或失败，且该结果位于您的**重试条件**列表中并且联系人还有剩余尝试次数，则会进行重试。尝试次数用尽的联系人会标记为*已耗尽*；不可重试的失败会标记为*失败*。
当您的账户余额不足时，拨号会自动暂停，并会在余额恢复后继续。对于长期营销活动，请保持启用[自动充值](/zh/guides/billing-and-topups)。
## 监控和控制
每张营销活动卡片都会显示其状态和进度（例如“248 个中已完成 173 个”）。打开营销活动可查看状态明细、每位联系人的结果和最近通话——每项均可链接到通话记录中的完整转录文本和录音。
* **暂停 / 恢复**——暂停会阻止新的拨号；正在进行的通话会自然结束。已暂停的营销活动可以编辑和恢复。
* **取消**——永久停止该营销活动。
* 当每位联系人都达到最终状态，或超过**结束时间**时，营销活动会自行完成。
营销活动状态：`draft`、`scheduled`、`running`、`paused`、`completed`、`cancelled`。联系人状态：`pending`、`scheduled`、`calling`、`completed`、`failed`、`exhausted`。
## 后续步骤
在营销活动通话进行时旁听。
以编程方式发起单通电话。