---
title: "使用 ThunderPhone 配合 Zapier"
description: "將 Zapier 上的 ThunderPhone 應用程式連接至你的機構，並建立一個會在每次通話結束時執行的 Zap。"
---

[Zapier](https://zapier.com) 透過名為 Zaps 的自動化工作流程連接各個應用程式。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 Sheet 新增一列。

<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`](/yue/webhooks/call-complete) 了解所有欄位。

<Note>
  每次傳送均附有簽章。應用程式會在 Zap 執行前，使用端點的密鑰驗證 `X-ThunderPhone-Signature` HMAC，並拒絕任何未簽署或無效的傳送。如果 Zapier 未能接受傳送，ThunderPhone 最長會重試 24 小時。請參閱 [Webhook 概覽](/yue/webhooks/overview)。
</Note>

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

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

**尋找通話**需要通話 ID，並提供最近通話的下拉選單。當中會傳回通話的
智能體、方向、電話號碼、開始及結束時間、狀態、結束原因、評分分數及通話結果、
逐字稿，以及可用時的已簽署錄音 URL。未知的通話 ID 不會傳回結果，而不會報錯。

**撥打外撥電話**需要：

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

此動作會傳回通話 ID、狀態及冪等重播。

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

**啟動活動**會啟動或繼續進行至少有一位聯絡人的活動。此動作需要 **同意收費**。
請參閱
[外撥活動](/yue/guides/outbound-campaigns)。

## Zap 撥打電話之前

「撥打外撥電話」及「啟動活動」會撥打真實電話號碼，並發起可收費通話。

- 如 ThunderPhone 要求你的機構確認外撥通話符合 TCPA 及其他電話法例，管理員必須先在控制台記錄此確認，Zap 才可發起通話。
- 撥出號碼必須已啟用外撥通話。從你自己的電訊商帶入的號碼，經驗證後即可使用。由 ThunderPhone 提供的號碼初始時只限接聽來電，你可在控制台為這些號碼申請外撥權限。請參閱 [取得電話號碼](/yue/guides/get-a-phone-number)。
- 「撥打外撥電話」需要 **冪等金鑰**。請對應觸發條件或來源記錄中的穩定 ID，例如 ThunderPhone 事件 ID 或 CRM 記錄 ID。如 Zapier 重試此步驟，ThunderPhone 會識別該金鑰並傳回原有通話，而不會再次撥號。避免使用時間戳記、隨機值，或只使用 Zap ID。
- 「啟動活動」需要 **同意收費**，以確認 Zap 可以在你的帳戶發起可收費的外撥通話。
- 你的機構有責任取得撥打每個號碼所需的同意，並遵守適用的電話法例。請參閱
  [外撥電話法例](/yue/guides/outbound-calling-laws)。

冪等金鑰在你的機構內必須唯一，且最多可包含 128 個字元。以不同的智能體、號碼
或變數重複使用同一金鑰時，會因衝突而失敗。因此，如兩個 Zap 都可能就同一記錄
撥號，請在記錄 ID 前為每個 Zap 加上各自固定的前綴。
[撥打外撥電話](/yue/guides/place-outbound-calls)說明此動作背後的 API。

## Zap 範例

- **將已完成通話記錄至 CRM。** 為每個已完成通話記錄活動，包括其狀態、結束原因及逐字稿。
- **將已評分通話用作跟進。** 根據通話結果或評分篩選，並將通話導向合適的跟進工作流程。
- **將新潛在客戶加入推廣活動。** 使用「將聯絡人加入推廣活動」將潛在客戶加入草稿推廣活動，然後在有人批准名單後執行「開始推廣活動」。

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

## 疑難排解

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

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

**你想中斷應用程式連線。** 撤銷連線前，請先關閉你的 ThunderPhone Zaps，因為關閉 Zap 會刪除其端點，並需要有效連線。如果你先行撤銷連線，請使用管理員 API 金鑰透過 `DELETE /v1/developer/webhook-endpoints/{id}`
刪除遺留的 **Zapier：…** 端點。請參閱 [Webhook 端點](/yue/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 伺服器](/yue/guides/mcp-servers)。如要將相同通話事件傳送至你的
  自有伺服器，請參閱 [Webhook 端點](/yue/webhooks/endpoints)。
</Note>