Aircall

หากต้องการใช้โทรศัพท์ Aircall ใน Mavibot คุณต้องสร้างคู่คีย์ API ในบัญชี Aircall ของคุณและป้อนลงในการตั้งค่าการผสานรวม

Aircall เป็นระบบโทรศัพท์บนคลาวด์สำหรับทีมขายและทีมสนับสนุน ให้บริการหมายเลขโทรศัพท์ในกว่า 100 ประเทศ ออกแบบมาสำหรับบริษัทที่พนักงานใช้แอป Aircall อยู่แล้ว: บอทจะโทรออก ในนามของพนักงาน แทนที่จะใช้หมายเลขบอทแยกต่างหาก

บอทสามารถเชื่อมต่อพนักงานกับลูกค้า ดึงบันทึกการโทร และส่งเหตุการณ์การโทรไปยังบทสนทนาได้

การรับข้อมูลที่จำเป็น

1. ลงทะเบียนที่ aircall.io ซื้อหมายเลขโทรศัพท์ในประเทศที่ต้องการ และสร้างผู้ใช้ Aircall สำหรับพนักงานของคุณ
2. เปิด แดชบอร์ด → การตั้งค่า → การผสานรวมและ API → คีย์ API และสร้างคู่คีย์:
   • API ID
   • API Token
3. ค้นหา Number ID สำหรับหมายเลขที่จะใช้โทรออก และ User ID สำหรับพนักงานของคุณ ID เหล่านี้จะแสดงในแถบที่อยู่เมื่อคุณเปิดหน้าที่เกี่ยวข้องในแดชบอร์ด Aircall

API Token จะแสดงเพียงครั้งเดียวเมื่อสร้าง หากคุณทำหาย ให้สร้างคู่คีย์ API ใหม่และเพิกถอนคีย์เก่า

การเชื่อมต่อ

ในการตั้งค่าโทรศัพท์ เลือก Aircall และป้อน:

• API ID — ตัวระบุคีย์ API
• API Token — โทเค็น API ลับ
• Number ID — ID ตัวเลขของสาย Aircall ที่จะใช้สำหรับการโทรออก

การผสานรวมเชื่อมต่อแล้ว

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

พนักงาน

ในการตั้งค่าพนักงาน กรอกช่อง Aircall User ID ด้วย ID ตัวเลขของบัญชี Aircall ของพนักงาน

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

การโทรจากการ์ดลูกค้า

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

Aircall จะเริ่มการโทร ในแอป Aircall ของพนักงาน ก่อน — บนเดสก์ท็อปหรือมือถือ เมื่อพนักงานรับสาย Aircall จะโทรหาลูกค้าและเชื่อมต่อทั้งสองฝ่าย

การโทรจะไม่สำเร็จหากพนักงาน ออฟไลน์ กำลังสนทนาอื่นอยู่ หรือไม่ได้รับมอบหมายให้ใช้หมายเลขที่เลือก ใน Aircall นี่คือข้อจำกัดของ Aircall: การโทรสามารถทำได้ผ่านผู้ใช้ที่พร้อมใช้งานเท่านั้น

ฟังก์ชันเครื่องคิดเลข

การโทรจากพนักงานถึงลูกค้า

aircall_employee_call(client_phone, employee_user_id, number_id)

พารามิเตอร์:

• client_phone — หมายเลขโทรศัพท์ของลูกค้าในรูปแบบสากล E.164 จำเป็น
• employee_user_id — Aircall User ID ของพนักงานที่จะรับสายในแอป Aircall จำเป็น
• number_id — ID ของหมายเลข Aircall ที่ใช้โทรออก ไม่บังคับ หากละเว้น จะใช้หมายเลขที่กำหนดค่าในการตั้งค่าการผสานรวม

รับลิงก์บันทึกการโทร

aircall_get_record_link(call_id)

ขอรับลิงก์ ใหม่ ไปยังบันทึกการโทร

พารามิเตอร์:

• call_id — ID การโทรของ Aircall ไม่บังคับ หากละเว้น จะใช้การโทรล่าสุดของลูกค้า

Callbacks ระหว่างการโทร

เมื่อการโทรดำเนินไป callbacks จะถูกส่งไปยังบทสนทนาในรูปแบบต่อไปนี้:

aircall_call_event call.answered

เหตุการณ์ที่เป็นไปได้:

เหตุการณ์	เมื่อใดที่ถูกเรียกใช้
call.created	การโทรถูกสร้างขึ้น
call.ringing_on_agent	พนักงานกำลังรับสาย
call.answered	การโทรถูกตอบรับ
call.hungup	ฝ่ายใดฝ่ายหนึ่งวางสาย
call.ended	การโทรสิ้นสุดลงอย่างสมบูรณ์
call.voicemail_left	ลูกค้าฝากข้อความเสียง

สถานการณ์ทั่วไป "ไม่รับสาย → ส่งข้อความในแชท" สามารถเรียกใช้ได้ด้วย call.ended และตรวจสอบตัวแปร aircall_missed_reason

ตัวแปรลูกค้าหลังการโทร

หลังการโทร ตัวแปรต่อไปนี้พร้อมใช้งานสำหรับลูกค้า:

ตัวแปร	ค่า
aircall_call_id	ID การโทรของ Aircall
aircall_call_direction	ทิศทางการโทร: inbound หรือ outbound
aircall_call_status	สถานะการโทร: initial, answered, หรือ done
aircall_call_duration	ระยะเวลาการโทรเป็นวินาที
aircall_missed_reason	เหตุผลที่การโทรไม่สำเร็จ
aircall_record_link	ลิงก์ไปยังบันทึกการโทร

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

ต้องเปิดใช้งานการบันทึกการโทรในการตั้งค่า Aircall ของคุณ บันทึกจะถูกเก็บไว้ในบัญชี Aircall ของคุณ

⏳ ลิงก์บันทึกการโทรของ Aircall พร้อมใช้งานในช่วงเวลาจำกัด — โดยทั่วไปเพียงไม่กี่ชั่วโมงหลังการโทร หลังจากนั้นลิงก์จะใช้งานไม่ได้ นี่คือวิธีการทำงานของ Aircall และไม่ใช่ข้อจำกัดของ Mavibot

ความหมาย:

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

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

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

ข้อผิดพลาด	สาเหตุ / วิธีแก้ไข
ข้อผิดพลาดการอนุญาตเมื่อโทรออก	คู่ API ID / API Token ไม่ถูกต้อง โทเค็นจะแสดงเพียงครั้งเดียวเมื่อสร้าง หากทำหาย ให้สร้างคู่ใหม่ภายใต้ API Keys และเพิกถอนคู่เก่า
การโทรไม่ถูกสร้างหรือพนักงานไม่รับสาย	พนักงานออฟไลน์ในแอป Aircall กำลังสนทนาอื่นอยู่ หรือไม่ได้รับมอบหมายให้ใช้หมายเลขที่เลือกในการตั้งค่า Aircall
"Aircall User ID ไม่ได้ระบุ"	ช่อง Aircall User ID ในการตั้งค่าพนักงานว่างเปล่า หรือป้อนหมายเลขโทรศัพท์แทน ID ตัวเลขของผู้ใช้
การโทรทำงาน แต่ไม่มี callbacks ในบทสนทนา	Webhook ไม่ได้ลงทะเบียน บันทึกการตั้งค่าการผสานรวม Aircall อีกครั้งเพื่อลงทะเบียน
ลิงก์บันทึกไม่เปิด	ลิงก์หมดอายุ ขอรับลิงก์ใหม่โดยใช้ aircall_get_record_link() หรือเปิดบันทึกโดยตรงในแดชบอร์ด Aircall