搭配 Zapier 使用 ThunderPhone

將 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 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 可顯示最近的傳送嘗試。