使用 ThunderPhone 配合 Zapier

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

Zapier 透過名為 Zaps 的自動化工作流程連接各個應用程式。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 Sheet 新增一列。

1. 進行通話以取得範例資料

   在建構器中開啟一個智能體，按一下 通話，然後結束通話。建構器測試通話會觸發「通話完成」，因此觸發條件可以載入最近的通話資料。

2. 新增觸發條件

   選擇 ThunderPhone 作為觸發應用程式，將事件設定為 通話完成，然後選擇你的 ThunderPhone 連線。測試觸發條件。Zapier 會以最近完成的通話作為範例載入，格式與即時事件相同。

3. 新增 Google Sheets

   新增一個建立試算表列的 Google Sheets 動作。選擇設有標題列的工作表，然後將每個欄位對應至觸發條件中的欄位（見下表）。

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 開啟時建立，並在關閉時刪除。請保持原狀。如端點曾在 ThunderPhone 中被編輯或刪除，請先關閉再重新開啟 Zap，以建立新的端點。 使用管理員 API 金鑰， GET /v1/developer/webhook-deliveries 可查看最近的傳送嘗試。