---
title: "ใช้ ThunderPhone กับ Zapier"
description: "เชื่อมต่อแอป ThunderPhone บน Zapier กับองค์กรของคุณ และสร้าง Zap ที่ทำงานทุกครั้งเมื่อการโทรสิ้นสุดลง"
---

[Zapier](https://zapier.com) เชื่อมต่อแอปด้วยเวิร์กโฟลว์อัตโนมัติที่เรียกว่า
Zaps แอป ThunderPhone บน Zapier มีฟีเจอร์ดังนี้:

- **ทริกเกอร์:** **การโทรเสร็จสิ้น** ทำงานเมื่อการโทรทางโทรศัพท์ เว็บ หรือการทดสอบสิ้นสุดลง
  **ให้คะแนนการโทรแล้ว** ทำงานเมื่อมีผลการให้คะแนนของการโทรที่เสร็จสิ้นแล้ว
- **การดำเนินการ:** **โทรออก**, **เพิ่มผู้ติดต่อไปยังแคมเปญ** และ
  **เริ่มแคมเปญ**
- **ค้นหา:** **ค้นหาการโทร** ค้นหาการโทรตาม ID และส่งคืนข้อมูลพร้อม
  บทสนทนาและ URL ของไฟล์บันทึกเสียงที่ลงนามแล้วเมื่อมี

ค้นหาได้ที่ [ThunderPhone บน Zapier](https://zapier.com/apps/thunderphone/integrations)
สำหรับภาพรวมของทั้งสองวิธีในการใช้ Zapier กับ ThunderPhone โปรดดู
[หน้าการผสานรวม Zapier](https://thunderphone.com/integrations/zapier)

## เชื่อมต่อองค์กรของคุณ

แอปเชื่อมต่อผ่าน OAuth คุณลงชื่อเข้าใช้ ThunderPhone และอนุมัติ
การเข้าถึงสำหรับหนึ่งองค์กร โดยไม่ต้องคัดลอก API key ไปยัง 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="โทรเพื่อใช้เป็นข้อมูลตัวอย่าง">
    เปิดเอเจนต์ในตัวสร้าง คลิก **สนทนา** แล้ววางสาย การโทรทดสอบจากตัวสร้างจะทริกเกอร์ Call Completed ดังนั้นทริกเกอร์จึงมีสายล่าสุดให้โหลด
  </Step>
  <Step title="เพิ่มทริกเกอร์">
    เลือก **ThunderPhone** เป็นแอปทริกเกอร์ ตั้งค่าเหตุการณ์เป็น **การโทรเสร็จสมบูรณ์** และเลือกการเชื่อมต่อ ThunderPhone ของคุณ ทดสอบทริกเกอร์ Zapier จะโหลดสายที่เสร็จสมบูรณ์ล่าสุดของคุณเป็นตัวอย่าง โดยมีโครงสร้างเดียวกับเหตุการณ์จริง
  </Step>
  <Step title="เพิ่ม Google Sheets">
    เพิ่มการดำเนินการ Google Sheets ที่สร้างแถวในสเปรดชีต เลือกชีตที่มีแถวส่วนหัว จากนั้นแมปแต่ละคอลัมน์กับฟิลด์จากทริกเกอร์ (ดูตารางด้านล่าง)
  </Step>
  <Step title="เผยแพร่ Zap">
    เผยแพร่และเปิดใช้ Zap การเปิดใช้จะสร้างปลายทาง webhook ในองค์กร ThunderPhone ของคุณชื่อ **Zapier: การโทรเสร็จสมบูรณ์** การปิด Zap จะลบปลายทางนั้น
  </Step>
  <Step title="ทดสอบ">
    โทรทดสอบจากตัวสร้างอีกครั้ง เมื่อสายสิ้นสุด Zap จะทำงานและมีแถวปรากฏขึ้น
  </Step>
</Steps>

คอลัมน์ที่มีประโยชน์:

| คอลัมน์ | ฟิลด์ Call Completed |
|---|---|
| รหัสการโทร | รหัสการโทร |
| เอเจนต์ | ชื่อเอเจนต์ |
| ทิศทาง | ทิศทาง |
| จาก | หมายเลขต้นทาง |
| ถึง | หมายเลขปลายทาง |
| เริ่มต้น | เวลาเริ่มต้น |
| สิ้นสุด | เวลาสิ้นสุด |
| ระยะเวลา (วินาที) | ระยะเวลาเป็นวินาที |
| สถานะ | สถานะ |
| เหตุผลที่สิ้นสุด | เหตุผลที่สิ้นสุด |
| ลิงก์การโทร | พิมพ์ `https://app.thunderphone.com/dashboard/call-history/` แล้วแทรกรหัสการโทร |

ลิงก์การโทรจะเปิดสายในแดชบอร์ด ThunderPhone สำหรับสมาชิกในองค์กรของคุณ พร้อมบทถอดเสียงและไฟล์บันทึกการโทร ดังนั้นชีตจึงไม่จำเป็นต้องเก็บข้อมูลทั้งสองอย่าง

เหตุการณ์ยังสามารถมีบทถอดเสียงในรูปแบบรายการของแต่ละช่วงการสนทนา และ URL ไฟล์บันทึกการโทร ซึ่งเป็นลิงก์ที่มีลายเซ็นและหมดอายุได้ เพิ่มข้อมูลเหล่านี้เฉพาะเมื่อชีตต้องใช้ บทถอดเสียง สรุป และไฟล์บันทึกการโทรอาจมีข้อมูลส่วนบุคคลหรือข้อมูลสุขภาพ ส่งข้อมูลเหล่านี้เฉพาะไปยังแอปที่องค์กรของคุณได้รับอนุญาตให้ใช้กับข้อมูลดังกล่าว ภายใต้ BAA เมื่อเกี่ยวข้องกับข้อมูลสุขภาพ และเก็บเฉพาะฟิลด์ที่จำเป็น ดู
[`telephony.complete` / `web.complete`](/th/webhooks/call-complete) สำหรับทุกฟิลด์

<Note>
  การส่งข้อมูลทุกครั้งมีการลงลายเซ็น แอปจะตรวจสอบ HMAC ของ `X-ThunderPhone-Signature` กับข้อมูลลับของปลายทางก่อนที่ Zap จะทำงาน และหยุดเมื่อพบข้อมูลที่ไม่มีลายเซ็นหรือไม่ถูกต้อง หาก Zapier ไม่ยอมรับการส่งข้อมูล ThunderPhone จะลองส่งซ้ำได้นานสูงสุด 24 ชั่วโมง ดู [ภาพรวม Webhooks](/th/webhooks/overview)
</Note>

## ทริกเกอร์ การดำเนินการ และการค้นหา

**จัดระดับการโทรแล้ว** จะให้รหัสการโทร รหัสเอเจนต์ ชื่อเอเจนต์ และข้อมูลการประเมิน ได้แก่ รหัสการประเมิน คะแนน ผลลัพธ์การโทร สรุป โมเดลผู้ประเมิน และเวลาที่ประเมิน การเปิดใช้ Zap จะสร้างปลายทางชื่อ **Zapier: จัดระดับการโทรแล้ว** การโทรหนึ่งรายการอาจได้รับการประเมินมากกว่าหนึ่งครั้ง และการประเมินแต่ละครั้งที่เสร็จสิ้นจะเรียกใช้ทริกเกอร์ ดู [`call.graded`](/th/webhooks/events)

**ค้นหาการโทร** รับรหัสการโทร พร้อมรายการแบบเลื่อนลงของการโทรล่าสุด โดยจะแสดงเอเจนต์ ทิศทาง หมายเลข เวลาเริ่มต้นและสิ้นสุด สถานะ เหตุผลที่สิ้นสุด คะแนนการประเมินและผลลัพธ์การโทร บทสนทนา และ URL ไฟล์บันทึกเสียงที่ลงนามแล้วเมื่อมี รหัสการโทรที่ไม่รู้จักจะไม่แสดงผลลัพธ์แทนที่จะเกิดข้อผิดพลาด

**โทรออก** รับข้อมูลดังนี้:

| ฟิลด์ | ความหมาย |
|---|---|
| เอเจนต์ | เอเจนต์ที่บันทึกไว้ รายการแบบเลื่อนลงจะแสดงเอเจนต์ของคุณ |
| หมายเลขปลายทาง | ปลายทางในรูปแบบ E.164 เช่น `+14155552671` |
| หมายเลขต้นทาง | รายการแบบเลื่อนลงจะแสดงเฉพาะหมายเลขที่เปิดใช้งานสำหรับการโทรออก |
| ตัวแปร | ออบเจ็กต์ JSON ที่ไม่บังคับสำหรับค่าของตัวยึดตำแหน่งในพรอมต์ของเอเจนต์ |
| คีย์ไอดอมโพเทนซี | รหัสที่คงที่จากทริกเกอร์หรือระเบียนต้นทาง จำเป็นต้องระบุ |

โดยจะแสดงรหัสการโทร สถานะ และการตอบกลับซ้ำแบบไอดอมโพเทนต์

**เพิ่มรายชื่อติดต่อไปยังแคมเปญ** จะเพิ่มรายชื่อติดต่อไปยังแคมเปญฉบับร่าง สำหรับรายชื่อติดต่อหนึ่งรายการ ให้กรอก **หมายเลขโทรศัพท์** ในรูปแบบ E.164 และระบุ **ตัวแปรรายชื่อติดต่อ** ได้ตามต้องการ ซึ่งเป็นออบเจ็กต์ JSON ที่พร็อพเพอร์ตีจะกลายเป็นตัวแปรของแคมเปญ สำหรับหลายรายการ ให้กรอก **JSON รายชื่อติดต่อ** ด้วยอาร์เรย์ของออบเจ็กต์สูงสุด 5,000 รายการ แต่ละรายการต้องมี `phone_number` และพร็อพเพอร์ตีอื่นจะกลายเป็นตัวแปร ขั้นตอนจะล้มเหลวเมื่อรายชื่อติดต่อทั้งหมดถูกปฏิเสธ และกำหนด **สำเร็จบางส่วน** เมื่อสำเร็จเพียงบางรายการ

**เริ่มแคมเปญ** จะเริ่มต้นหรือดำเนินการต่อสำหรับแคมเปญที่มีรายชื่อติดต่ออย่างน้อยหนึ่งรายการ โดยต้องระบุ **ความยินยอมให้เรียกเก็บเงิน** ดู [แคมเปญโทรออก](/th/guides/outbound-campaigns)

## ก่อนที่ Zap จะโทรออก

การโทรออกและการเริ่มแคมเปญจะโทรไปยังหมายเลขโทรศัพท์จริงและเริ่มการโทรที่มีค่าใช้จ่าย

- หาก ThunderPhone ขอให้องค์กรของคุณยืนยันว่าการโทรออกเป็นไปตาม TCPA และกฎหมายการโทรอื่นๆ ผู้ดูแลระบบต้องบันทึกการยืนยันดังกล่าวในแดชบอร์ดก่อนที่ Zap จะเริ่มการโทรได้
- หมายเลขต้นทางต้องเปิดใช้งานสำหรับการโทรออก หมายเลขที่คุณนำมาจากผู้ให้บริการของคุณเองจะมีสิทธิ์เมื่อยืนยันแล้ว หมายเลขที่ ThunderPhone จัดหาให้จะเริ่มต้นเป็นหมายเลขรับสายเข้าเท่านั้น และคุณสามารถขอสิทธิ์โทรออกสำหรับหมายเลขเหล่านั้นได้ในแดชบอร์ด ดู [รับหมายเลขโทรศัพท์](/th/guides/get-a-phone-number)
- การโทรออกต้องใช้ **คีย์ไอดอมโพเทนซี** จับคู่รหัสที่คงที่จากทริกเกอร์หรือระเบียนต้นทาง เช่น รหัสเหตุการณ์ ThunderPhone หรือรหัสระเบียน CRM หาก Zapier ลองขั้นตอนนี้อีกครั้ง ThunderPhone จะจดจำคีย์และส่งคืนการโทรเดิมแทนการโทรครั้งที่สอง หลีกเลี่ยงการใช้การประทับเวลา ค่าสุ่ม หรือรหัส Zap เพียงอย่างเดียว
- การเริ่มแคมเปญต้องใช้ **ความยินยอมให้เรียกเก็บเงิน** ซึ่งยืนยันว่า Zap สามารถเริ่มการโทรออกที่มีค่าใช้จ่ายในบัญชีของคุณได้
- องค์กรของคุณมีหน้าที่รับผิดชอบในการได้รับความยินยอมเพื่อโทรไปยังแต่ละหมายเลข และปฏิบัติตามกฎหมายการโทรที่เกี่ยวข้อง ดู [กฎหมายการโทรออก](/th/guides/outbound-calling-laws)

คีย์ไอดอมโพเทนซีต้องไม่ซ้ำกันทั่วทั้งองค์กรของคุณและมีความยาวได้สูงสุด 128 อักขระ การใช้คีย์เดิมกับเอเจนต์ หมายเลข หรือตัวแปรอื่นจะล้มเหลวเนื่องจากความขัดแย้ง ดังนั้นหาก Zap สองรายการสามารถโทรเกี่ยวกับระเบียนเดียวกันได้ ให้กำหนดคำนำหน้าคงที่ของแต่ละ Zap ไว้ก่อนรหัสระเบียน
[โทรออก](/th/guides/place-outbound-calls) อธิบาย API ที่อยู่เบื้องหลังการดำเนินการนี้

## ตัวอย่าง Zap

- **การโทรเสร็จสิ้นไปยัง CRM** บันทึกกิจกรรมสำหรับการโทรที่เสร็จสิ้นแต่ละครั้ง พร้อมสถานะ เหตุผลที่สิ้นสุด และบทสนทนา
- **การโทรที่ได้รับการประเมินเพื่อติดตามผล** กรองตามผลลัพธ์หรือคะแนนของการโทร แล้วส่งต่อการโทรไปยังเวิร์กโฟลว์ติดตามผลที่เหมาะสม
- **ลูกค้าเป้าหมายใหม่ไปยังแคมเปญ** เพิ่มลูกค้าเป้าหมายไปยังแคมเปญฉบับร่างด้วย เพิ่มผู้ติดต่อไปยังแคมเปญ จากนั้นเรียกใช้ เริ่มแคมเปญ เมื่อมีผู้อนุมัติรายการ

บทสนทนาการโทร ข้อมูลสรุป และไฟล์บันทึกเสียงอาจมีข้อมูลส่วนบุคคลหรือข้อมูลสุขภาพ ส่งข้อมูลเหล่านี้เฉพาะไปยังแอปที่องค์กรของคุณได้รับอนุญาตให้ใช้กับข้อมูลดังกล่าว ภายใต้ BAA ในกรณีที่เกี่ยวข้องกับข้อมูลสุขภาพ และเก็บไว้เฉพาะฟิลด์ที่จำเป็น

## การแก้ไขปัญหา

**ขั้นตอนล้มเหลวพร้อมข้อผิดพลาดการอนุญาต** เชื่อมต่อการเชื่อมต่อ ThunderPhone ใน Zapier อีกครั้ง แล้วอนุมัติอีกครั้ง การเชื่อมต่อจะหยุดทำงานเมื่อบุคคลที่เชื่อมต่อเพิกถอนการเชื่อมต่อใน ThunderPhone ภายใต้ **องค์กร → คีย์ → แอปที่ได้รับอนุญาต** เมื่อบุคคลนั้นออกจากองค์กร หรือเมื่อไม่มีการรีเฟรชโทเค็นสำเร็จเป็นเวลา 30 วัน ดู [เชื่อมต่อด้วย OAuth](/th/guides/oauth)

**การเปิดหรือปิด Zap ล้มเหลว หรือการดำเนินการถูกปฏิเสธ** บุคคลที่เชื่อมต่อต้องมีบทบาทผู้ดูแลระบบหรือเจ้าของในองค์กร เชื่อมต่อใหม่ด้วยบัญชีที่มีบทบาทดังกล่าว Trigger Zap ที่เปิดอยู่แล้วจะยังคงได้รับเหตุการณ์การโทรหลังจากเปลี่ยนบทบาทหรือเพิกถอนการเชื่อมต่อ ปิด Zap เพื่อหยุดเหตุการณ์เหล่านั้น

**ต้องการยกเลิกการเชื่อมต่อแอป** ปิด ThunderPhone Zap ของคุณก่อนเพิกถอนการเชื่อมต่อ เนื่องจากการปิด Zap จะลบปลายทางของ Zap และต้องใช้การเชื่อมต่อที่ทำงานอยู่ หากคุณเพิกถอนก่อน ให้ลบปลายทาง **Zapier: …** ที่ค้างอยู่ด้วย `DELETE /v1/developer/webhook-endpoints/{id}` โดยใช้คีย์ API ของผู้ดูแลระบบ ดู [ปลายทาง Webhook](/th/webhooks/endpoints)

**Zap ควรใช้องค์กรอื่น** การเชื่อมต่อแต่ละรายการครอบคลุมหนึ่งองค์กร ปิด Zap ก่อน เพื่อให้ปลายทาง webhook ถูกลบออกจากองค์กรปัจจุบัน จากนั้นเชื่อมต่อบัญชี ThunderPhone ใหม่ใน Zapier เลือกองค์กรอื่นเมื่อคุณอนุมัติ แล้วเลือกการเชื่อมต่อนั้นในแต่ละขั้นตอนของ ThunderPhone เอเจนต์ หมายเลข และแคมเปญจะแตกต่างกันระหว่างองค์กร ดังนั้นให้เลือก **เอเจนต์**, **หมายเลขต้นทาง** และ **แคมเปญ** อีกครั้งในทุกขั้นตอนที่มีรายการเหล่านี้ จากนั้นเปิด Zap อีกครั้ง

**Trigger หยุดทำงาน** Zap แต่ละรายการที่มี Trigger ของ ThunderPhone จะเป็นเจ้าของปลายทาง webhook หนึ่งรายการในองค์กรของคุณ ซึ่งมีชื่อ **Zapier: การโทรเสร็จสิ้น** หรือ **Zapier: การโทรที่ได้รับการประเมิน** ปลายทางนี้จะถูกสร้างเมื่อเปิด Zap และถูกลบเมื่อปิด Zap ปล่อยไว้ตามเดิม หากมีการแก้ไขหรือลบใน ThunderPhone ให้ปิด Zap แล้วเปิดอีกครั้งเพื่อสร้างรายการใหม่
ด้วยคีย์ API ของผู้ดูแลระบบ
[`GET /v1/developer/webhook-deliveries`](/api-reference/webhook-deliveries)
จะแสดงความพยายามในการส่งล่าสุด

<Note>
  ต้องการให้เอเจนต์ใช้การดำเนินการของ Zapier ระหว่างการโทรแทนที่จะใช้หลังการโทรหรือไม่
  เชื่อมต่อปลายทาง Zapier MCP ภายใต้ **การเชื่อมต่อ → MCP** ดู
  [เซิร์ฟเวอร์ MCP](/th/guides/mcp-servers) หากต้องการส่งเหตุการณ์การโทรเดียวกันไปยัง
  เซิร์ฟเวอร์ของคุณเอง ดู [ปลายทาง Webhook](/th/webhooks/endpoints)
</Note>