---
title: "搭配 Zapier 使用 ThunderPhone"
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 Sheets">
    新增一個建立試算表資料列的 Google Sheets 動作。選擇具有標題列的工作表，然後將每個欄位對應至觸發條件中的欄位（請參閱下表）。
  </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-Hant/webhooks/call-complete) 以取得所有欄位資訊。

<Note>
  每次傳送都會簽署。應用程式會在 Zap 執行前，使用端點的密鑰檢查 `X-ThunderPhone-Signature`
  HMAC，並阻擋任何未簽署或無效的內容。如果 Zapier 未接受傳送內容，ThunderPhone
  最多會重試 24 小時。請參閱 [Webhook 概覽](/zh-Hant/webhooks/overview)。
</Note>

## 觸發條件、動作與搜尋

**通話已評分**會提供通話 ID、智慧體 ID、智慧體名稱，以及評分資訊：評分
ID、分數、通話結果、摘要、評分模型與評分時間。啟用 Zap 後，會建立名為
**Zapier：通話已評分**的端點。一通電話可評分多次，每次完成評分執行時都會觸發
此條件。請參閱
[`call.graded`](/zh-Hant/webhooks/events)。

**尋找通話**接受通話 ID，並提供近期通話的下拉式選單。它會傳回通話的智慧體、
方向、號碼、開始與結束時間、狀態、結束原因、評分分數與通話結果、逐字稿，以及
可用時的已簽署錄音 URL。未知的通話 ID 不會傳回錯誤，而是沒有結果。

**撥打外撥電話**接受：

| 欄位 | 說明 |
|---|---|
| 智慧體 | 已儲存的智慧體。下拉式選單會列出你的智慧體。 |
| 目的地號碼 | E.164 格式的目的地號碼，例如 `+14155552671`。 |
| 撥出號碼 | 下拉式選單只會列出已啟用外撥電話的號碼。 |
| 變數 | 選填的 JSON 物件，用於智慧體提示詞中預留位置的值。 |
| 冪等性金鑰 | 來自觸發條件或來源紀錄的穩定 ID。必填。 |

它會傳回通話 ID、狀態與冪等重播。

**將聯絡人新增至行銷活動**會將聯絡人新增至草稿行銷活動。若要新增一位
聯絡人，請以 E.164 格式填寫**電話號碼**，並可選填**聯絡人變數**，即其屬性會
成為行銷活動變數的 JSON 物件。若要批次新增，請在**聯絡人 JSON**中填入最多
5,000 個物件的陣列。每個物件都需要 `phone_number`，其餘屬性會成為變數。當
所有聯絡人都遭拒絕時，此步驟會失敗；只有部分遭拒絕時，則會設定**部分成功**。

**開始行銷活動**會啟動或繼續至少有一位聯絡人的行銷活動。它需要
**同意收費**。請參閱
[外撥行銷活動](/zh-Hant/guides/outbound-campaigns)。

## Zap 撥打電話之前

「撥打外撥電話」與「開始行銷活動」會撥打真實電話號碼，並開始計費通話。

- 若 ThunderPhone 要求你的組織確認其外撥電話遵循 TCPA 與其他通話法規，
  管理員必須先在控制台中記錄該確認，Zap 才能開始撥打電話。
- 撥出號碼必須已啟用外撥電話。你從自有電信業者帶入的號碼，經驗證後即可使用。
  ThunderPhone 提供的號碼一開始僅限接聽來電，你可在控制台中申請其外撥權限。
  請參閱[取得電話號碼](/zh-Hant/guides/get-a-phone-number)。
- 「撥打外撥電話」需要**冪等性金鑰**。請對應觸發條件或來源紀錄中的穩定 ID，
  例如 ThunderPhone 事件 ID 或 CRM 紀錄 ID。若 Zapier 重試此步驟，
  ThunderPhone 會辨識該金鑰並傳回原始通話，而不會再撥打一通電話。請避免使用
  時間戳記、隨機值，或僅使用 Zap ID。
- 「開始行銷活動」需要**同意收費**，以確認 Zap 可在你的帳戶上開始計費的外撥
  通話。
- 你的組織有責任取得撥打每個號碼所需的同意，並遵守適用的通話法規。請參閱
  [外撥通話法規](/zh-Hant/guides/outbound-calling-laws)。

冪等性金鑰在你的組織內必須是唯一，且最多可有 128 個字元。以不同的智慧體、
號碼或變數重複使用同一金鑰會因衝突而失敗，因此若兩個 Zap 可能針對同一筆紀錄
撥打電話，請在紀錄 ID 前為每個 Zap 加上各自固定的前綴。
[撥打外撥電話](/zh-Hant/guides/place-outbound-calls)說明此動作背後的 API。

## Zap 範例

- **已完成通話至 CRM。** 為每通已完成的通話記錄活動，包括其狀態、結束原因及逐字稿。
- **已評分通話至後續追蹤。** 依通話結果或分數篩選，並將通話導向正確的後續追蹤工作流程。
- **新潛在客戶至行銷活動。** 使用「將聯絡人加入行銷活動」將潛在客戶加入草稿行銷活動，然後在有人核准名單後執行「開始行銷活動」。

通話逐字稿、摘要及錄音可能包含個人或健康資訊。僅將其傳送至你的組織獲准用於處理該資料的應用程式；如涉及健康資訊，請依據 BAA 處理，並且只保留你需要的欄位。

## 疑難排解

**某個步驟因授權錯誤而失敗。** 在 Zapier 中重新連結 ThunderPhone 連線並再次授權。當建立連線的人在 ThunderPhone 的 **組織 → 金鑰 → 已授權的應用程式** 中撤銷連線、該人離開組織，或連線連續 30 天未成功更新權杖時，連線就會停止運作。請參閱
[使用 OAuth 連線](/zh-Hant/guides/oauth)。

**啟用或停用 Zap 失敗，或動作遭拒。** 建立連線的人必須在組織中具有管理員或擁有者角色。請使用具備該角色的帳戶重新連結。已啟用的觸發 Zap 即使角色變更或連線遭撤銷，仍會持續接收通話事件。請將其停用以停止接收事件。

**你想要中斷應用程式連線。** 請在撤銷連線前先停用你的 ThunderPhone Zaps，因為停用 Zap 會刪除其端點，而且需要可用的連線。如果你已先撤銷連線，請使用管理員 API 金鑰透過 `DELETE /v1/developer/webhook-endpoints/{id}` 刪除遺留的 **Zapier：…** 端點。請參閱 [Webhook 端點](/zh-Hant/webhooks/endpoints)。

**Zap 應使用不同的組織。** 每個連線僅涵蓋一個組織。請先停用 Zap，以便從目前組織刪除其 Webhook 端點。接著在 Zapier 中連結新的 ThunderPhone 帳戶，在授權時選擇另一個組織，並在每個 ThunderPhone 步驟中選取該連線。不同組織的智慧體、電話號碼及行銷活動各不相同，因此請在每個包含這些欄位的步驟中重新選取 **智慧體**、**撥出號碼** 及 **行銷活動**。然後重新啟用 Zap。

**觸發程序已停止觸發。** 每個具有 ThunderPhone 觸發程序的 Zap 都會在你的組織中擁有一個 Webhook 端點，名稱為 **Zapier：通話已完成** 或 **Zapier：通話已評分**。該端點會在 Zap 啟用時建立，並在停用時刪除。請勿變更它。如果它已在 ThunderPhone 中遭編輯或刪除，請先停用再重新啟用 Zap，以建立新的端點。
使用管理員 API 金鑰，
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
可顯示最近的傳送嘗試。

<Note>
  想讓智慧體在通話期間使用 Zapier 動作，而非在通話結束後嗎？
  請在 **連線 → MCP** 下連結 Zapier MCP 端點。請參閱
  [MCP 伺服器](/zh-Hant/guides/mcp-servers)。若要將相同的通話事件傳送至你自己的伺服器，請參閱 [Webhook 端點](/zh-Hant/webhooks/endpoints)。
</Note>