Twilio เป็นผู้ให้บริการโทรคมนาคมระหว่างประเทศ ช่วยให้บอทสามารถโทรหาลูกค้าและเชื่อมต่อกับพนักงานของคุณได้ในกว่า 100 ประเทศที่ Twilio มีหมายเลขโทรศัพท์ให้บริการ รวมถึงเม็กซิโก บราซิล ตุรกี สเปน เยอรมนี ฝรั่งเศส สหรัฐอาหรับเอมิเรตส์ ไทย มาเลเซีย และอีกมากมาย

สิ่งที่คุณจะได้รับหลังจากเชื่อมต่อ Twilio:

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

ขั้นตอนที่ 1. สร้างบัญชีและซื้อหมายเลข

  1. ลงทะเบียนที่ twilio.com และทำการยืนยันตัวตนให้เสร็จสิ้น
  2. ใน Twilio Console เปิด Phone Numbers → Buy a number และเลือกหมายเลขในประเทศที่คุณต้องการ ตรวจสอบให้แน่ใจว่าเปิดใช้งาน Voice แล้ว — หมายเลขบางหมายเลขรองรับเฉพาะ SMS และไม่สามารถใช้โทรออกได้

ขั้นตอนที่ 2. คัดลอกข้อมูลรับรองการเข้าถึงของคุณ

บนหน้าหลักของ Twilio Console ภายใต้ Account Info คุณจะพบค่าสองค่า:

รายการ ลักษณะที่ปรากฏ
Account SID ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Auth Token ซ่อนอยู่; คลิก Show เพื่อแสดง

⚠️ คัดลอก Auth Token ตามที่ปรากฏทุกตัวอักษร โดยไม่มีช่องว่างเพิ่มเติมก่อนหรือหลัง เราใช้มันเพื่อตรวจสอบความถูกต้องของทุกคำขอจาก Twilio อักขระพิเศษที่มองไม่เห็นเพียงตัวเดียวอาจทำให้การโทรทำงานได้ แต่เหตุการณ์การโทรไม่ปรากฏในการสนทนา

Auth Token ให้สิทธิ์เข้าถึงบัญชี Twilio และเงินในบัญชีของคุณอย่างเต็มรูปแบบ อย่าส่งผ่านแอปส่งข้อความหรือเผยแพร่ที่ใด


ขั้นตอนที่ 3. เชื่อมต่อ Twilio ในบัญชีของคุณ

เปิด Project → Integrations → Telephony → Twilio และกรอกสามช่อง:

ช่อง สิ่งที่ต้องกรอก
Account SID จากขั้นตอนที่ 2
Auth Token จากขั้นตอนที่ 2
Twilio Number หมายเลขที่คุณซื้อ ในรูปแบบสากล: +14155550100

ต้องกรอกหมายเลขในรูปแบบ E.164: +, รหัสประเทศ และหมายเลขโทรศัพท์ โดยไม่มีช่องว่าง วงเล็บ หรือยัติภังค์

หลังจากบันทึก callback URL จะปรากฏบนหน้า คัดลอกไว้ จากนั้นเปิดการตั้งค่าสำหรับหมายเลขที่คุณซื้อใน Twilio Console และภายใต้ Voice & Fax กำหนดค่า:

  • A call comes in → Webhook → วาง URL ที่คัดลอกและเลือก HTTP POST

หากไม่กำหนดค่านี้ การโทรออกจะทำงาน แต่การโทรเข้าและเหตุการณ์การโทรในการสนทนาจะไม่ทำงาน

หากต้องการยกเลิกการเชื่อมต่อ ให้ล้างช่อง Account SID และบันทึกการตั้งค่า


ขั้นตอนที่ 4. เพิ่มหมายเลขโทรศัพท์ของพนักงาน

Twilio โทรหาพนักงานผ่านหมายเลขโทรศัพท์ปกติ — ไม่มีสายภายในที่นี่

เปิดแท็บ Team เลือกพนักงาน และกรอกช่อง Twilio Phone Number ด้วยหมายเลขโทรศัพท์เต็มในรูปแบบเดียวกัน:

+905551112233

หากไม่มีหมายเลขนี้ ปุ่มโทรในบัตรลูกค้าจะไม่ทำงานสำหรับพนักงานคนนั้น


การโทรจากบัตรลูกค้า

ปุ่มโทรจะปรากฏถัดจากหมายเลขโทรศัพท์ของลูกค้าในบัตรสนทนา การคลิกจะเริ่มลำดับต่อไปนี้:

  1. Twilio โทรหาพนักงาน — พนักงานเห็นหมายเลข Twilio ของคุณเป็นหมายเลขผู้โทร
  2. พนักงานรับสาย
  3. จากนั้น Twilio โทรหาลูกค้าและเชื่อมต่อทั้งสองฝ่าย

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


การโทรจากสถานการณ์บอท

มีสี่เมธอดในเครื่องคิดเลข

twilio_employee_call(client_phone, employee_phone, caller_id)

เชื่อมต่อพนักงานกับลูกค้า ทำงานเหมือนกับปุ่มโทรในบัตรลูกค้า: โทรหาพนักงานก่อน จากนั้นจึงโทรหาลูกค้า

twilio_employee_call(client_phone, "+905551112233")

อาร์กิวเมนต์ที่สามเป็นตัวเลือก ระบุหมายเลขโทรศัพท์ที่ลูกค้าจะเห็นเป็นหมายเลขผู้โทร โดยค่าเริ่มต้นจะใช้หมายเลข Twilio ของคุณ

twilio_group_call(client_phone, employee_phones, caller_id)

โทรหาลูกค้า และเมื่อลูกค้ารับสาย จะโทรหาพนักงานทั้งหมดในรายการที่ระบุพร้อมกัน การโทรจะเชื่อมต่อกับพนักงานคนแรกที่รับสาย

twilio_group_call(client.phone, "+905551112233,+905554445566,+905557778899")

⚠️ ลำดับกลับกันที่นี่ ต่างจากเมธอดก่อนหน้า ลูกค้ารับสายก่อนและอาจได้ยินความเงียบสองสามวินาทีในขณะที่ Twilio โทรหาพนักงาน นี่คือข้อจำกัดของ Twilio: การโทรกลุ่มพร้อมกันและเชื่อมต่อคนแรกที่รับสายทำได้เพียงวิธีนี้ หากสำคัญที่ลูกค้าไม่ต้องรอ ให้ใช้ twilio_employee_call

twilio_play_message(client_phone, text, voice, language)

โทรหาลูกค้าและอ่านข้อความที่ระบุโดยใช้เสียงสังเคราะห์ มีประโยชน์สำหรับการแจ้งเตือนนัดหมาย การยืนยันคำสั่งซื้อ และการแจ้งการจัดส่ง

twilio_play_message(client.phone, "Hello! This is a reminder about your appointment tomorrow at 3:00 PM.", "alice", "en-EN")

เสียง alice เป็นเสียงสากลและรองรับภาษาหลัก รวมถึง tr-TR, es-ES, es-MX, pt-BR, de-DE, fr-FR, en-US, ru-RU และ ar-XA

ระบุภาษาให้ชัดเจนเสมอ — มิฉะนั้น Twilio อาจอ่านข้อความด้วยการออกเสียงภาษาอังกฤษ

อย่ารวมรหัสผ่าน รหัสยืนยัน หรือข้อมูลที่ละเอียดอ่อนอื่น ๆ ในข้อความ: การโทรอาจถูกตอบโดยวอยซ์เมล

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

twilio_get_record_link()

หากไม่ระบุอาร์กิวเมนต์ จะใช้การโทรล่าสุดของลูกค้า


ตัวแปรและเหตุการณ์

หลังจากการโทรแต่ละครั้ง บอทจะเก็บตัวแปรต่อไปนี้ในคำสั่งซื้อของลูกค้า:

ตัวแปร สิ่งที่เก็บ
twilio_call_id ตัวระบุการโทรของ Twilio
twilio_call_disposition ผลการโทร: completed, busy, no-answer, failed, canceled
twilio_call_duration ระยะเวลาการโทรเป็นวินาที
twilio_record_link ลิงก์ไปยังการบันทึก
twilio_record_id ตัวระบุการบันทึกของ Twilio

เหตุการณ์ในรูปแบบ twilio_call_event <status> จะถูกส่งไปยังการสนทนา คุณสามารถใช้เป็นเงื่อนไขในสถานการณ์ของคุณ:

เหตุการณ์ เมื่อถูกส่ง
twilio_call_event initiated การโทรถูกสร้างขึ้น
twilio_call_event ringing โทรศัพท์กำลังดัง
twilio_call_event answered การโทรถูกตอบรับ
twilio_call_event completed การโทรสิ้นสุดลง
twilio_call_event busy / no-answer / failed / canceled การโทรไม่สำเร็จ
twilio_call_event recording การบันทึกการโทรพร้อมแล้ว

⚠️ รอเหตุการณ์ recording ก่อนใช้ลิงก์บันทึก ไม่ใช่เหตุการณ์ completed Twilio ประมวลผลไฟล์บันทึกหลังจากการโทรสิ้นสุดแล้ว ในเวลาที่ได้รับเหตุการณ์ completed ตัวแปร twilio_record_link ยังว่างอยู่ สถานการณ์ที่ส่งการบันทึกไปยังผู้จัดการหรือ CRM จึงต้องถูกเรียกใช้โดยเหตุการณ์ recording

สถานการณ์ทั่วไป "ไม่สามารถติดต่อลูกค้าได้ — ส่งข้อความหาเขา" ทำงานดังนี้: เงื่อนไขสำหรับ twilio_call_event no-answer หรือ busy → ส่งข้อความถึงลูกค้า


การบันทึกการโทร

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

⚠️ URL twilio_record_link ชี้ไปที่ Twilio โดยตรงและได้รับการป้องกันด้วยข้อมูลรับรองบัญชีของคุณ คุณไม่สามารถเปิดในเบราว์เซอร์หรือส่งให้ลูกค้าได้ — จะแสดงข้อผิดพลาดการเข้าถึง หากต้องการดาวน์โหลดการบันทึก เปิด Twilio Console และไปที่ Monitor → Logs → Calls จากนั้นค้นหาการโทรโดยใช้ twilio_call_id

⚖️ การบันทึกการโทรถูกควบคุมโดยกฎหมาย ในหลายประเทศ — รวมถึงเยอรมนี ฝรั่งเศส สเปน และหลายรัฐในสหรัฐฯ — อาจต้องได้รับความยินยอมจากทั้งสองฝ่าย และในบางกรณีต้องเล่นประกาศด้วยเสียงตอนเริ่มการโทร ในฐานะเจ้าของบัญชี Twilio คุณรับผิดชอบในการปฏิบัติตามข้อกำหนดที่เกี่ยวข้อง หากกฎเหล่านี้ใช้กับคุณ ให้เริ่มการโทรด้วยประกาศการบันทึกหรือปิดการบันทึกในการตั้งค่าหมายเลข Twilio ของคุณ


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

การโทรไม่ถูกสร้างและส่งคืนข้อผิดพลาดการรับรองความถูกต้อง

Account SID หรือ Auth Token ไม่ถูกต้อง คัดลอกอีกครั้งจาก Twilio Console สาเหตุที่พบบ่อยที่สุดคือช่องว่างเพิ่มเติมหรือคัดลอก Test Token แทน Auth Token หลักโดยไม่ได้ตั้งใจ

การโทรทำงาน แต่ไม่มีเหตุการณ์หรือการบันทึกในการสนทนา

callback URL ไม่ได้ถูกกำหนดค่าในการตั้งค่าหมายเลข Twilio (ดู ขั้นตอนที่ 3) หรือกำหนดค่าด้วย HTTP method ที่ผิด ต้องเป็น HTTP POST

อีกสาเหตุที่พบบ่อยคือ Auth Token ถูกเปลี่ยนใน Twilio แต่ยังคงใช้โทเค็นเก่าในบัญชีของคุณ ในกรณีนี้ ลายเซ็นคำขอไม่ตรงกัน ดังนั้น callback ทั้งหมดจะถูกปฏิเสธ

ข้อผิดพลาด 21606 หรือ "From number not valid"

หมายเลขที่กรอกในช่อง Twilio Number ไม่ได้ซื้อภายใต้บัญชี Twilio ของคุณหรือไม่รองรับการโทรด้วยเสียง

เปิด Phone Numbers → Manage → Active numbers และตรวจสอบว่าหมายเลขอยู่ในรายการและมีความสามารถ Voice

ข้อผิดพลาด 21215 — Geo Permissions

โดยค่าเริ่มต้น Twilio บล็อกการโทรไปยังหลายประเทศเพื่อป้องกันการฉ้อโกง

เปิด Voice → Settings → Geo Permissions และเปิดใช้งานปลายทางที่คุณต้องการ

ลูกค้าโทรเข้า แต่สร้างบัตรสนทนาสำหรับหมายเลขพนักงาน

callback ถูกกำหนดค่าด้วย URL ที่ผิด คัดลอก callback URL จากหน้าบูรณาการอีกครั้ง ตรวจสอบให้แน่ใจว่าคัดลอก URL ทั้งหมด รวมถึงทุกอย่างหลังเครื่องหมายคำถาม

บัญชีทดลอง: Twilio เล่นข้อความเสียงก่อนการโทร

นี่คือพฤติกรรมมาตรฐานสำหรับบัญชีทดลอง Twilio บัญชีทดลองยังสามารถโทรได้เฉพาะหมายเลขที่ยืนยันแล้วเท่านั้น

เพิ่มเงินในบัญชีและอัปเกรดเป็นบัญชี Twilio เต็มรูปแบบ