---
title: "将 ThunderPhone 与 Zapier 配合使用"
description: "将 Zapier 上的 ThunderPhone 应用连接到您的组织，并构建一个在每次通话结束时运行的 Zap。"
---

[Zapier](https://zapier.com) 通过称为 Zap 的自动化工作流连接各类应用。Zapier 上的 ThunderPhone 应用提供：

- **触发器：** 当电话、网页或测试通话结束时，**通话已完成**会触发。完成通话的评分可用时，**通话已评分**会触发。
- **操作：** **发起外呼**、**将联系人添加到活动**和**启动活动**。
- **搜索：** **查找通话**会按 ID 查找通话，并在录音可用时返回通话记录、转录文本和已签名的录音 URL。

您可在 [Zapier 上的 ThunderPhone](https://zapier.com/apps/thunderphone/integrations) 中找到它。有关通过 Zapier 使用 ThunderPhone 的两种方式的概述，请参阅 [Zapier 集成页面](https://thunderphone.com/integrations/zapier)。

## 连接您的组织

该应用通过 OAuth 连接。您登录 ThunderPhone 并批准一个组织的访问权限，无需将 API 密钥复制到 Zapier 中。

<Steps>
  <Step title="添加 ThunderPhone 步骤">
    在 Zap 编辑器中搜索 **ThunderPhone**（显示 Beta 标签），然后选择触发器或操作。当 Zapier 要求选择账户时，请连接一个新账户。Zapier 会打开 ThunderPhone 登录窗口。
  </Step>
  <Step title="登录并选择组织">
    登录后，查看所请求的权限，选择组织，然后选择 **批准**。该应用会请求读取您的智能体和电话号码、读取和写入通话及活动、管理 webhook 端点等集成，以及查看您的账户邮箱。
  </Step>
  <Step title="检查连接名称">
    Zapier 会以您批准的组织为连接命名，因此当您属于多个组织时，可以区分不同连接。
  </Step>
</Steps>

请使用在该组织中具有管理员或所有者角色的账户进行连接。启用或停用触发器 Zap，以及执行每项操作，都需要该角色。已启用的触发器 Zap 会在角色变更或连接被撤销后继续接收通话事件。请将其停用以停止接收事件。任何成员都可以使用查找通话。

该应用本身不收取 ThunderPhone 费用。它发起或启动的通话将按您常规的 ThunderPhone 费率计费，Zapier 则会根据您的 Zapier 套餐计算任务数。

## 构建第一个 Zap

此 Zap 会在每次通话结束时向 Google 表格添加一行。

<Steps>
  <Step title="进行一次通话以用作示例数据">
    在构建器中打开一个智能体，点击 **通话**，然后结束通话。构建器测试通话会触发“通话已完成”，因此可为触发器提供最近一次通话以供加载。
  </Step>
  <Step title="添加触发器">
    选择 **ThunderPhone** 作为触发器应用，将事件设为 **通话已完成**，然后选择您的 ThunderPhone 连接。测试触发器。Zapier 会加载您最近完成的通话作为示例，其结构与实时事件相同。
  </Step>
  <Step title="添加 Google 表格">
    添加一个用于创建电子表格行的 Google 表格操作。选择包含标题行的工作表，然后将每列映射到触发器中的字段（见下表）。
  </Step>
  <Step title="发布 Zap">
    发布并启用 Zap。启用后，会在您的 ThunderPhone 组织中创建一个名为 **Zapier：通话已完成** 的 Webhook 端点。停用 Zap 会删除该端点。
  </Step>
  <Step title="测试">
    再进行一次构建器测试通话。通话结束后，Zap 将运行并显示新的一行。
  </Step>
</Steps>

实用列：

| 列 | 通话已完成字段 |
|---|---|
| 通话 ID | 通话 ID |
| 智能体 | 智能体名称 |
| 方向 | 方向 |
| 呼出号码 | 呼出号码 |
| 呼入号码 | 呼入号码 |
| 开始时间 | 开始时间 |
| 结束时间 | 结束时间 |
| 时长（秒） | 时长（秒） |
| 状态 | 状态 |
| 结束原因 | 结束原因 |
| 通话链接 | 输入 `https://app.thunderphone.com/dashboard/call-history/`，然后插入通话 ID |

通话链接会为您组织中的成员在 ThunderPhone 控制台中打开该通话，并显示其转录文本和录音，因此表格无需保存这两项内容。

事件还可以包含作为轮次列表的转录文本，以及会过期的已签名链接“录音 URL”。仅在表格需要时添加它们。通话转录文本、摘要和录音可能包含个人信息或健康信息。仅将其发送到您的组织获准用于处理该数据的应用；如果涉及健康信息，请在 BAA 下使用，并且仅保留您需要的字段。有关所有字段，请参阅
[`telephony.complete` / `web.complete`](/zh/webhooks/call-complete)。

<Note>
  每次投递均已签名。Zap 运行前，应用会根据端点的密钥检查 `X-ThunderPhone-Signature`
  HMAC，并会停止处理任何未签名或无效的投递。如果 Zapier 未接受某次投递，ThunderPhone
  最多会重试 24 小时。请参阅 [Webhook 概述](/zh/webhooks/overview)。
</Note>

## 触发器、操作和搜索

**通话已评分**会提供通话 ID、智能体 ID、智能体名称以及评分信息：评分
ID、分数、通话结果、摘要、评分器模型和评分时间。启用 Zap
会创建一个名为 **Zapier：通话已评分** 的端点。一次通话可以被多次评分，每次完成的评分运行都会触发此触发器。请参阅
[`call.graded`](/zh/webhooks/events)。

**查找通话**接受通话 ID，并提供最近通话的下拉列表。它会返回
通话对应的智能体、方向、号码、开始和结束时间、状态、结束
原因、评分分数和通话结果、转录文本，以及可用时的已签名录音
URL。未知的通话 ID 不会返回错误，而是返回无结果。

**发起外呼**接受：

| 字段 | 含义 |
|---|---|
| 智能体 | 已保存的智能体。下拉列表会列出您的智能体。 |
| 目标号码 | E.164 格式的目标号码，例如 `+14155552671`。 |
| 主叫号码 | 下拉列表仅列出已启用外呼的号码。 |
| 变量 | 可选的 JSON 对象，用于为智能体提示词中的占位符提供值。 |
| 幂等性键 | 来自触发器或源记录的稳定 ID。必填。 |

它会返回通话 ID、状态和幂等重放。

**将联系人添加到营销活动**会将联系人添加到草稿营销活动中。对于单个
联系人，请以 E.164 格式填写 **电话号码**，并可选择填写 **联系人
变量**，即属性会成为营销活动变量的 JSON 对象。对于批量操作，请在
**联系人 JSON** 中填写最多包含 5,000 个对象的数组。每个对象都需要
`phone_number`，其余属性会成为变量。当所有联系人均被拒绝时，该步骤会失败；仅部分联系人被拒绝时，则会设置 **部分成功**。

**启动营销活动**会启动或继续至少包含一位联系人的营销活动。该操作需要
**计费同意**。请参阅
[外呼营销活动](/zh/guides/outbound-campaigns)。

## Zap 发起通话之前

发起外呼和启动营销活动会拨打真实电话号码并开始计费通话。

- 如果 ThunderPhone 要求您的组织确认其外呼通话遵守 TCPA 和其他通话法律，则管理员必须先在控制台中记录该确认，Zap 才能开始发起通话。
- 主叫号码必须已启用外呼。您从自己的运营商引入的号码在完成验证后即可使用。ThunderPhone 提供的号码起初仅支持呼入，您可以在控制台中为其申请外呼权限。请参阅[获取电话号码](/zh/guides/get-a-phone-number)。
- 发起外呼需要 **幂等性键**。请映射触发器或源记录中的稳定 ID，例如 ThunderPhone 事件 ID 或 CRM 记录 ID。如果 Zapier 重试此步骤，ThunderPhone 会识别该键并返回原始通话，而不会再次发起通话。请避免使用时间戳、随机值或仅使用 Zap ID。
- 启动营销活动需要 **计费同意**，以确认 Zap 可以在您的账户中开始计费外呼。
- 您的组织负责确保已获得拨打每个号码的同意，并遵守适用的通话法律。请参阅
  [外呼通话法律](/zh/guides/outbound-calling-laws)。

幂等性键在您的组织内必须唯一，且最多可包含 128 个
字符。使用同一键但指定不同的智能体、号码或变量会因冲突而失败，因此如果两个 Zap 都可能针对同一记录发起通话，请在记录 ID 前为每个 Zap 添加各自固定的前缀。
[发起外呼](/zh/guides/place-outbound-calls)介绍了此操作背后的 API。

## Zap 示例

- **将已完成通话发送到 CRM。** 为每次已完成的通话记录活动，包括其状态、结束原因和转录文本。
- **将已评分通话用于后续跟进。** 根据通话结果或评分进行筛选，并将通话路由到合适的后续跟进工作流。
- **将新潜在客户添加到营销活动。** 使用“将联系人添加到营销活动”将潜在客户添加到草稿营销活动中，然后在有人批准列表后运行“启动营销活动”。

通话转录文本、摘要和录音可能包含个人信息或健康信息。仅将其发送到您的组织获准用于处理此类数据的应用；如涉及健康信息，请在业务伙伴协议（BAA）下处理；并且仅保留您所需的字段。

## 故障排除

**某个步骤因授权错误而失败。** 在 Zapier 中重新连接 ThunderPhone 连接并再次批准。当建立连接的人员在 ThunderPhone 的 **组织 → 密钥 → 已授权应用** 中撤销连接、该人员离开组织，或连续 30 天未能成功刷新令牌时，连接将停止工作。请参阅[通过 OAuth 连接](/zh/guides/oauth)。

**启用或关闭 Zap 失败，或者操作被拒绝。** 建立连接的人员需要拥有组织中的管理员或所有者角色。请使用具备该角色的账户重新连接。已启用的触发器 Zap 会在角色变更或连接被撤销后继续接收通话事件。请将其关闭以停止接收这些事件。

**您想要断开应用连接。** 请先关闭您的 ThunderPhone Zaps，再撤销连接，因为关闭 Zap 会删除其端点，并且需要有效的连接。如果您先撤销了连接，请使用管理员 API 密钥通过 `DELETE /v1/developer/webhook-endpoints/{id}` 删除残留的 **Zapier：…** 端点。请参阅 [Webhook 端点](/zh/webhooks/endpoints)。

**Zap 应使用其他组织。** 每个连接仅涵盖一个组织。请先关闭 Zap，以便从当前组织中删除其 webhook 端点。然后在 Zapier 中连接新的 ThunderPhone 账户，在您批准时选择其他组织，并在每个 ThunderPhone 步骤中选择该连接。不同组织中的智能体、号码和营销活动各不相同，因此请在包含这些字段的每个步骤中再次选择 **智能体**、**主叫号码** 和 **营销活动**。然后重新启用 Zap。

**触发器停止触发。** 每个使用 ThunderPhone 触发器的 Zap 都在您的组织中拥有一个 webhook 端点，名为 **Zapier：通话已完成** 或 **Zapier：通话已评分**。该端点会在 Zap 启用时创建，并在 Zap 关闭时删除。请保持原样。如果该端点在 ThunderPhone 中被编辑或删除，请关闭 Zap 后再重新启用，以创建新的端点。
使用管理员 API 密钥，
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
可查看最近的投递尝试。

<Note>
  希望智能体在通话期间而不是通话结束后使用 Zapier 操作？
  请在 **连接 → MCP** 下连接 Zapier MCP 端点。请参阅
  [MCP 服务器](/zh/guides/mcp-servers)。如需将相同的通话事件发送到您自己的服务器，请参阅 [Webhook 端点](/zh/webhooks/endpoints)。
</Note>