หากต้องการใช้โทรศัพท์ VoIPstudio ใน Mavibot คุณต้องสร้างคีย์ API ในบัญชี VoIPstudio ของคุณ ป้อนลงในการตั้งค่าการผสานรวม และกำหนดค่าการส่งเหตุการณ์ไปยัง URL ที่ Mavibot แสดงหลังจากเชื่อมต่อการผสานรวมแล้ว
VoIPstudio คือระบบคลาวด์ PBX ที่มีหมายเลขโทรศัพท์ในกว่า 70 ประเทศ ซึ่งแตกต่างจากผู้ให้บริการโทรคมนาคมแบบดั้งเดิม รองรับผู้ใช้ภายใน กลุ่มริง กรุ๊ปคิว และเมนู IVR ในขณะที่บอททำงานบนพื้นฐานของ PBX นี้
บอทสามารถโทรหาลูกค้าในนามของพนักงาน โอนและวางสาย บันทึกการสนทนา และส่งเหตุการณ์การโทรไปยังบทสนทนาได้
การรับข้อมูลที่จำเป็น
- ลงทะเบียนที่ voipstudio.com และซื้อหมายเลขโทรศัพท์ในประเทศที่ต้องการ
- สร้าง ผู้ใช้ ใน PBX — หนึ่งรายต่อพนักงานแต่ละคนที่จะรับสาย การโทรจะถูกส่งไปยังอุปกรณ์ทั้งหมดที่ลงทะเบียนกับผู้ใช้ ดังนั้นคุณไม่จำเป็นต้องระบุหมายเลขโทรศัพท์แยกต่างหากสำหรับพนักงานแต่ละคน
- ไปที่ การตั้งค่า → API สร้าง คีย์ API และคัดลอกไว้
การเชื่อมต่อการผสานรวม
ในการตั้งค่าโทรศัพท์ เลือก VoIPstudio และป้อน:
- คีย์ API — คีย์จากบัญชี VoIPstudio ของคุณ
การผสานรวมเชื่อมต่อแล้ว หากต้องการยกเลิกการเชื่อมต่อ ให้ล้างฟิลด์ คีย์ API และบันทึกการตั้งค่า
หลังจากบันทึก URL การแจ้งเตือน จะปรากฏบนหน้า คัดลอกไว้:
https://chatter.mavibot.ai/voipstudio_webhook/
อย่าเผยแพร่ URL นี้หรือแชร์กับใคร หากคุณยกเลิกการเชื่อมต่อและเชื่อมต่อการผสานรวมใหม่ คีย์จะยังคงเหมือนเดิม ดังนั้นคุณไม่จำเป็นต้องกำหนดค่าการแจ้งเตือนอีกครั้ง
จากนั้น ในบัญชี VoIPstudio ของคุณ ไปที่ การผสานรวม → Webhooks → เปิดใช้งาน → เพิ่ม Webhook วาง URL ที่คัดลอก และเลือกเหตุการณ์ต่อไปนี้:
- การเปลี่ยนแปลงสถานะการโทร — หรือเลือก สายเรียกเข้า สายเชื่อมต่อ สายสิ้นสุด และสายไม่ได้รับเป็นรายบุคคล
- บันทึกการโทรพร้อมแล้ว — หากคุณต้องการบันทึกการโทร
หากไม่มีการกำหนดค่านี้ การโทรออกจะยังทำงานได้ แต่เหตุการณ์การโทรจะไม่ปรากฏในบทสนทนา
พนักงาน
ในการตั้งค่าพนักงาน กรอกฟิลด์ VoIPstudio User ID — ตัวระบุตัวเลขของผู้ใช้ใน PBX ของคุณ เช่น 10002
ป้อน รหัสผู้ใช้ PBX ไม่ใช่หมายเลขโทรศัพท์ คุณสามารถค้นหารหัสได้ในรายการผู้ใช้ในบัญชี VoIPstudio ของคุณ หากไม่มีรหัสนี้ ปุ่มโทรในการ์ดลูกค้าจะไม่ทำงานสำหรับพนักงานคนนั้น
การโทรจากการ์ดลูกค้า
ปุ่มโทรจะปรากฏถัดจากหมายเลขโทรศัพท์ของลูกค้าในการ์ดบทสนทนา
VoIPstudio จะโทรหา พนักงาน ก่อนบนอุปกรณ์ที่ลงทะเบียนทั้งหมดพร้อมกัน เมื่อพนักงานรับสาย VoIPstudio จะโทรหา ลูกค้า และเชื่อมต่อทั้งสองฝ่าย
หากพนักงานไม่รับสาย ลูกค้าจะไม่ถูกโทร
ฟังก์ชันเครื่องคิดเลข
การโทรจากพนักงานถึงลูกค้า
voipstudio_employee_call(client_phone, employee_user_id, caller_id)
พารามิเตอร์:
- client_phone — หมายเลขโทรศัพท์ของลูกค้า จำเป็น
- employee_user_id — รหัสผู้ใช้ VoIPstudio ของพนักงานที่ควรรับสายแรก จำเป็น
-
caller_id — หมายเลขโทรศัพท์ที่แสดงแก่ลูกค้า ไม่บังคับ คุณสามารถส่ง
anonymousเพื่อซ่อนหมายเลขผู้โทร
โอนสาย
voipstudio_transfer_call(phone, call_id)
โอนสายที่กำลังดำเนินอยู่ไปยังหมายเลขโทรศัพท์อื่น
พารามิเตอร์:
- phone — หมายเลขโทรศัพท์ที่ควรโอนสายไป จำเป็นและ ต้องเป็นพารามิเตอร์แรก
-
call_id — ตัวระบุการโทร ไม่บังคับ หากละเว้น การโทรปัจจุบันของลูกค้าจะถูกนำมาจากตัวแปร
voipstudio_call_id
วางสาย
voipstudio_hangup_call(call_id)
วางสายที่กำลังดำเนินอยู่
พารามิเตอร์:
- call_id — ตัวระบุการโทร ไม่บังคับ หากละเว้น การโทรปัจจุบันของลูกค้าจะถูกใช้
รับลิงก์บันทึกการโทร
voipstudio_get_record_link(call_id)
ส่งคืนลิงก์ไปยังบันทึกการโทร โดยปกติลิงก์จะถูกบันทึกโดยอัตโนมัติเมื่อได้รับเหตุการณ์บันทึกพร้อมแล้ว ฟังก์ชันนี้มีประโยชน์หากไม่ได้รับเหตุการณ์นั้น
พารามิเตอร์:
- call_id — ตัวระบุการโทร ไม่บังคับ หากละเว้น การโทรปัจจุบันของลูกค้าจะถูกใช้
ฟังก์ชันค้นหาบันทึก 100 รายการล่าสุดในบัญชี สำหรับการโทรที่เก่ากว่าใน PBX ที่มีปริมาณการโทรสูง อาจไม่พบบันทึก ในกรณีนั้น ให้ดึงบันทึกโดยตรงจากบัญชี VoIPstudio ของคุณ
การเรียกกลับระหว่างการโทร
เมื่อการโทรดำเนินไป การเรียกกลับจะถูกส่งไปยังบทสนทนาในรูปแบบต่อไปนี้:
voipstudio_call_event call.hangup
ชื่อเหตุการณ์จะถูกส่งตามที่ได้รับจาก VoIPstudio เช่น call.ringing, call.connected, call.hangup และอื่นๆ เหตุการณ์ที่มีขึ้นอยู่กับเหตุการณ์ที่คุณเลือกเมื่อกำหนดค่าการแจ้งเตือน
หากไม่มีชื่อเหตุการณ์ สถานะการโทรจะถูกใช้แทน:
INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
การเรียกกลับแยกต่างหากจะถูกส่งเมื่อบันทึกพร้อมแล้ว:
voipstudio_call_event recording
รอการเรียกกลับ
recordingก่อนใช้ลิงก์บันทึก บันทึกจะถูกประมวลผลหลังจากการโทรสิ้นสุด ดังนั้นตัวแปรvoipstudio_record_linkยังว่างเปล่าเมื่อได้รับcall.hangup
หากพนักงานสองคนภายใน PBX ของคุณพูดคุยกัน การเรียกกลับจะไม่ถูกส่งไปยังบทสนทนาและไม่มีการสร้างการ์ดลูกค้า
ตัวแปรลูกค้าหลังการโทร
| ตัวแปร | ค่า |
|---|---|
| voipstudio_call_id | รหัสการโทรใน VoIPstudio |
| voipstudio_call_state | สถานะการโทร: INITIAL, RINGING, CONNECTED, ON_HOLD, HANGUP
|
| voipstudio_call_duration | ระยะเวลาการโทรเป็นวินาที |
| voipstudio_call_cause | สาเหตุที่การโทรสิ้นสุด |
| voipstudio_terminated_by | ผู้ที่วางสาย: caller หรือ callee
|
| voipstudio_record_link | ลิงก์ไปยังบันทึกการโทร |
| voipstudio_record_id | รหัสบันทึกใน VoIPstudio |
บันทึกการโทร
การบันทึกการโทรเปิดใช้งาน ในการตั้งค่า VoIPstudio และจัดการโดย PBX เอง หากคุณต้องการบันทึก ให้เปิดใช้งานการบันทึกการโทรในบัญชี VoIPstudio ของคุณและเลือกเหตุการณ์ บันทึกการโทรพร้อมแล้ว เมื่อกำหนดค่าการแจ้งเตือน
URL
voipstudio_record_linkได้รับการป้องกันด้วยคีย์การเข้าถึง ไม่สามารถเปิดโดยตรงในเบราว์เซอร์หรือแชร์กับลูกค้าได้ คุณสามารถดาวน์โหลดบันทึกจากบัญชี VoIPstudio ของคุณในส่วนประวัติการโทร
การบันทึกการโทรอยู่ภายใต้กฎหมายที่เกี่ยวข้อง ในเยอรมนี ฝรั่งเศส สเปน และรัฐส่วนใหญ่ของสหรัฐอเมริกา อาจต้องได้รับความยินยอมจากทั้งสองฝ่าย และในบางเขตอำนาจศาลอาจต้องมีการแจ้งด้วยเสียงเมื่อเริ่มการโทร เจ้าของบัญชี VoIPstudio มีหน้าที่รับผิดชอบในการปฏิบัติตามข้อกำหนดเหล่านี้
การแก้ไขปัญหา
| ข้อผิดพลาด | สาเหตุ |
|---|---|
| ข้อผิดพลาดการอนุญาตเมื่อสร้างการโทร |
คีย์ API ไม่ถูกต้องหรือหมดอายุ ตรวจสอบว่าคีย์ถูกสร้างภายใต้ การตั้งค่า → API แทนที่จะได้รับผ่านคำขอ login
|
| การโทรทำงาน แต่ไม่มีการเรียกกลับปรากฏในบทสนทนา | ไม่มีการสร้าง webhook ใน VoIPstudio สลับ เปิดใช้งาน ปิดอยู่ หรือป้อน URL ผิด คัดลอก URL ทั้งหมดจากหน้าการผสานรวม รวมถึงคีย์ที่ท้าย |
| ไม่สามารถสร้างการโทรหรืออุปกรณ์ของพนักงานไม่ดัง | ป้อนหมายเลขโทรศัพท์แทน VoIPstudio User ID หรือผู้ใช้ไม่มีอุปกรณ์ที่ลงทะเบียน |
ไม่ได้รับการเรียกกลับ recording
|
ไม่ได้เปิดใช้งานการบันทึกการโทรใน VoIPstudio หรือไม่ได้เลือกเหตุการณ์ บันทึกการโทรพร้อมแล้ว |
VoIPstudio คิดค่าบริการโดยตรงโดย VoIPstudio: มีค่าสมัครสมาชิกรายเดือนสำหรับผู้ใช้ PBX แต่ละราย บวกกับค่าโทร ซึ่งแตกต่างจากผู้ให้บริการที่คิดค่าบริการต่อนาทีโดยไม่มีค่าสมัครสมาชิกซ้ำ เมื่อประมาณการค่าใช้จ่าย ให้พิจารณาจำนวนผู้ใช้ที่กำหนดค่าไว้ ไม่ใช่แค่ปริมาณการโทร