将 ThunderPhone 与 Zapier 配合使用

将 Zapier 上的 ThunderPhone 应用连接到您的组织，并构建一个在每次通话结束时运行的 Zap。

Zapier 通过称为 Zap 的自动化工作流连接各类应用。Zapier 上的 ThunderPhone 应用提供：

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

您可在 Zapier 上的 ThunderPhone 中找到它。有关通过 Zapier 使用 ThunderPhone 的两种方式的概述，请参阅 Zapier 集成页面。

连接您的组织#

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

1. 添加 ThunderPhone 步骤

   在 Zap 编辑器中搜索 ThunderPhone（显示 Beta 标签），然后选择触发器或操作。当 Zapier 要求选择账户时，请连接一个新账户。Zapier 会打开 ThunderPhone 登录窗口。

2. 登录并选择组织

   登录后，查看所请求的权限，选择组织，然后选择 批准。该应用会请求读取您的智能体和电话号码、读取和写入通话及活动、管理 webhook 端点等集成，以及查看您的账户邮箱。

3. 检查连接名称

   Zapier 会以您批准的组织为连接命名，因此当您属于多个组织时，可以区分不同连接。

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

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

构建第一个 Zap#

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

1. 进行一次通话以用作示例数据

   在构建器中打开一个智能体，点击 通话，然后结束通话。构建器测试通话会触发“通话已完成”，因此可为触发器提供最近一次通话以供加载。

2. 添加触发器

   选择 ThunderPhone 作为触发器应用，将事件设为 通话已完成，然后选择您的 ThunderPhone 连接。测试触发器。Zapier 会加载您最近完成的通话作为示例，其结构与实时事件相同。

3. 添加 Google 表格

   添加一个用于创建电子表格行的 Google 表格操作。选择包含标题行的工作表，然后将每列映射到触发器中的字段（见下表）。

4. 发布 Zap

   发布并启用 Zap。启用后，会在您的 ThunderPhone 组织中创建一个名为 Zapier：通话已完成 的 Webhook 端点。停用 Zap 会删除该端点。

5. 测试

   再进行一次构建器测试通话。通话结束后，Zap 将运行并显示新的一行。

实用列：

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

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

触发器、操作和搜索#

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

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

发起外呼接受：

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

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

启动营销活动会启动或继续至少包含一位联系人的营销活动。该操作需要 计费同意。请参阅 外呼营销活动。

Zap 发起通话之前#

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

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

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

Zap 示例#

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

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

故障排除#

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

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

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

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

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