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

Verimor เป็นผู้ให้บริการโทรคมนาคมของตุรกี ผลิตภัณฑ์ Bulut Santralim เป็นคลาวด์ PBX: พนักงานทำงานกับสายภายใน และการโทรจะถูกกำหนดเส้นทางผ่านสายภายในเหล่านั้น

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

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

  1. เปิดใช้งานบริการ Bulut Santralim กับ Verimor และสร้างสายภายในสำหรับพนักงานของคุณ
  2. เปิด Online İşlem Merkezi → Bulut Santralim → Santral Ayarlarım และคัดลอก คีย์ API ซึ่งมีลักษณะดังนี้:
K12345678-1234-5678-4321-123456789012
  1. จดสายภายในของพนักงาน คุณจะต้องระบุในตั้งค่าการเข้าถึง

คีย์ API ถูกใช้ร่วมกันทั่วทั้ง PBX และใช้ทั้งสำหรับการโทรและการรับเหตุการณ์ หากคุณสร้างใหม่ในแดชบอร์ด Verimor ตรวจสอบให้แน่ใจว่าบันทึกแบบฟอร์มการเชื่อมต่ออีกครั้ง มิฉะนั้น ทั้งการโทรและเหตุการณ์การสนทนาจะหยุดทำงาน

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

ในแท็บโทรศัพท์ เลือก Verimor และป้อน:

  • คีย์ API — คีย์จากส่วน Santral Ayarlarım
  • หมายเลขขาออก — หมายเลขภายนอกที่ลูกค้าจะเห็น ในรูปแบบ 908505320000 ฟิลด์นี้ไม่บังคับ หากปล่อยว่าง จะใช้หมายเลขที่กำหนดให้กับสายภายในของพนักงาน


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

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

คุณไม่จำเป็นต้องกำหนดค่า URL การแจ้งเตือนด้วยตนเอง Mavibot ตั้งค่าโดยอัตโนมัติใน PBX ของคุณเมื่อบันทึกคีย์ API

พนักงาน

ในการตั้งค่าพนักงาน กรอก สายภายใน (dahili) ของพนักงาน — โดยปกติ 3–4 หลัก เช่น 1001

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

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

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

PBX จะโทรหา สายภายในของพนักงาน ก่อน หลังจากที่พนักงานรับสายเท่านั้น จึงจะโทรหาลูกค้า

ลำดับนี้ตั้งใจ: ลูกค้าจะไม่ได้ยินความเงียบในสาย เพราะพนักงานเชื่อมต่อแล้วเมื่อโทรศัพท์ของลูกค้าเริ่มดัง

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

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

verimor_employee_call(client_phone, employee_extension, caller_id)

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

  • client_phone — หมายเลขโทรศัพท์ของลูกค้า จำเป็น ใช้รูปแบบตุรกี 908505320000 หรือ 00493027590915 สำหรับการโทรระหว่างประเทศ
  • employee_extension — สายภายในของพนักงานที่โทรศัพท์จะดัง จำเป็น
  • caller_id — หมายเลขที่ลูกค้าจะเห็น ไม่บังคับ หากละเว้น จะใช้หมายเลขขาออกจากตั้งค่าการเชื่อมต่อ

ฟังก์ชันส่งคืน call_uuid — ตัวระบุการโทร ซึ่งถูกบันทึกในตัวแปร verimor_call_uuid ด้วย

โอนสาย

verimor_transfer_call(employee_extension, call_uuid)

โอนการโทรปัจจุบันไปยังสายภายในอื่น

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

  • employee_extension — สายภายในที่จะโอนการโทรไป จำเป็น
  • call_uuid — ตัวระบุการโทร ไม่บังคับ หากละเว้น จะใช้การโทรล่าสุดของลูกค้า

วางสาย

verimor_hangup_call(call_uuid)

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

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

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

verimor_get_record_link(call_uuid)

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

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

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

การเรียกกลับระหว่างการโทร

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

verimor_call_event answer

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

เหตุการณ์ เมื่อถูกเรียกใช้
ringing การโทรกำลังดัง
answer การโทรได้รับการตอบรับ
hangup การโทรสิ้นสุดลง
user_hangup พนักงานวางสาย

การโทรระหว่างพนักงานจะไม่ปรากฏในการสนทนา

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

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

ตัวแปร ค่า
verimor_call_uuid ตัวระบุการโทร
verimor_call_direction ทิศทาง: inbound — ลูกค้าโทรหาคุณ, outbound — คุณโทรหาลูกค้า
verimor_call_extension สายภายในของพนักงานที่จัดการการโทร
verimor_call_duration ระยะเวลาการโทรเป็นวินาที
verimor_call_answered 1 — การโทรได้รับการตอบรับ, 0 — ไม่ได้รับการตอบรับ
verimor_hangup_cause รหัสที่ระบุสาเหตุที่การโทรสิ้นสุด
verimor_has_record 1 — มีการบันทึก, 0 — ไม่มีการบันทึก
verimor_record_link ลิงก์ไปยังการบันทึกการโทรหลังเรียก verimor_get_record_link()

รหัสสาเหตุการวางสาย

ค่าที่พบบ่อยที่สุดของ verimor_hangup_cause คือ:

รหัส ความหมาย
NORMAL_CLEARING การโทรเสร็จสมบูรณ์และสิ้นสุดตามปกติ
USER_BUSY ไม่ว่าง
NO_ANSWER ไม่มีการตอบรับ
ORIGINATOR_CANCEL ผู้โทรวางสายก่อนการโทรได้รับการตอบรับ
CALL_REJECTED การโทรถูกปฏิเสธ
UNALLOCATED_NUMBER หมายเลขไม่ถูกต้อง
NO_USER_RESPONSE ผู้ใช้บริการไม่พร้อมใช้งาน
NOT_ALLOWED_BY_IYS ไม่มีสิทธิ์ใน İYS ทะเบียนความยินยอมของตุรกีสำหรับการโทรเชิงพาณิชย์

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

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

⏳ ลิงก์การบันทึกยังคงใช้ได้เป็นเวลา 60 นาที นับจากเวลาที่ขอ หลังจากนั้นจะหยุดทำงาน Verimor ยังอนุญาตให้ขอ ลิงก์การบันทึกไม่เกินห้าครั้งต่อนาที ต่อคีย์ API

ความหมาย:

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

การบันทึกการโทรถูกควบคุมโดยกฎหมาย ในตุรกี อยู่ภายใต้ข้อกำหนด KVKK: ลูกค้าต้องได้รับแจ้งเกี่ยวกับการบันทึก และการจัดเก็บข้อมูลส่วนบุคคลต้องมีพื้นฐานทางกฎหมาย เจ้าของบัญชี Verimor มีหน้าที่รับผิดชอบในการปฏิบัติตามข้อกำหนดที่เกี่ยวข้อง

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

ข้อผิดพลาด สาเหตุ / วิธีแก้ไข
Gecersiz anahtar คีย์ API ไม่ถูกต้อง รับคีย์ปัจจุบันจากส่วน Santral Ayarlarım
extension 1005 not found สายภายในไม่มีอยู่ใน PBX ของคุณ ตรวจสอบให้แน่ใจว่าการตั้งค่าพนักงานมี dahili ที่มีอยู่
"ไม่ได้ระบุสายภายใน Verimor" การตั้งค่าพนักงานว่างเปล่าหรือมีหมายเลขโทรศัพท์มือถือแทนสายภายใน
การโทรทำงาน แต่ไม่มีการเรียกกลับปรากฏในการสนทนา ไม่ได้กำหนดค่า URL การแจ้งเตือน บันทึกแบบฟอร์มการเชื่อมต่ออีกครั้ง
การโทรหยุดทำงานหลังเปลี่ยนคีย์ API คีย์ถูกสร้างใหม่ในแดชบอร์ด Verimor ป้อนคีย์ใหม่ในแบบฟอร์มการเชื่อมต่อและบันทึก
ลิงก์การบันทึกไม่เปิด ลิงก์หมดอายุ ขอลิงก์ใหม่ด้วย verimor_get_record_link() หรือเปิดการบันทึกในแดชบอร์ด Verimor
ไม่ส่งคืนลิงก์การบันทึก ถึงขีดจำกัดห้าครั้งต่อนาที หรือการโทรไม่มีการบันทึก ตรวจสอบ verimor_has_record