หากต้องการใช้บริการโทรศัพท์ TotalVoice ใน Mavibot คุณต้องได้รับ Access Token จากแดชบอร์ด TotalVoice และป้อนลงในการตั้งค่าการผสานรวม TotalVoice เป็นบริการโทรศัพท์ของบราซิลซึ่งปัจจุบันเป็นส่วนหนึ่งของกลุ่ม Zenvia

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

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

  1. สร้างบัญชี Zenvia Voice และเติมเงินเข้าสู่ยอดคงเหลือของคุณ

  1. เข้าสู่ระบบแดชบอร์ด ที่มุมซ้ายล่างของหน้าจอหลัก ถัดจาก Access Token คลิกไอคอนคัดลอก

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

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

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

  • Access Token — คีย์จากแดชบอร์ด TotalVoice
  • Client-facing number — หมายเลขที่ลูกค้าจะเห็น ในรูปแบบ +551140028922 ฟิลด์นี้ไม่บังคับ หากปล่อยว่างไว้ จะใช้หมายเลขเริ่มต้นจากบัญชี TotalVoice ของคุณ


หลังจากบันทึก notification URL จะปรากฏบนหน้าหน้าต่างการเชื่อมต่อ คุณต้องเพิ่มลงในแดชบอร์ด TotalVoice — ดูหัวข้อถัดไป

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

การตั้งค่าการแจ้งเตือน

แตกต่างจากการผสานรวมโทรศัพท์อื่นๆ ต้องกำหนดค่า notification URL ด้วยตนเอง เนื่องจาก TotalVoice ไม่มีวิธีให้ Mavibot ดำเนินการโดยอัตโนมัติ

  1. คัดลอก URL ที่แสดงบนหน้าหน้าต่างการเชื่อมต่อ

  1. ในแดชบอร์ด TotalVoice เปิด Desenvolvedores → Configurações da API
  2. วาง URL เดียวกัน ลงในฟิลด์เว็บฮุคทั้งสาม:
    • Status Tempo Real — การเปลี่ยนแปลงสถานะการโทรระหว่างการโทร
    • Chamada - Fim — การสิ้นสุดการโทร
    • DID - Fim de Chamada — การสิ้นสุดการโทรเข้าหมายเลขของคุณ

⏳ การแจ้งเตือนอาจใช้เวลาถึง 20 นาทีจึงจะเริ่มเข้ามาหลังจากบันทึกการตั้งค่า นี่คือข้อจำกัดของ TotalVoice หากไม่มีเหตุการณ์ปรากฏในการสนทนาทันทีหลังการตั้งค่า เพียงรอ

หากคุณสร้าง Access Token ใหม่ notification URL จะเปลี่ยนไป บันทึกโทเค็นใหม่ใน Mavibot และ อัปเดต URL ในแดชบอร์ด TotalVoice มิฉะนั้นเหตุการณ์การโทรจะหยุดเข้ามา

พนักงาน

ในการตั้งค่าพนักงาน ป้อนหมายเลข TotalVoice ของพนักงาน


คุณสามารถใช้ internal extension (ramal โดยปกติ 3–4 หลัก) หรือ หมายเลขโทรศัพท์มือถือปกติ ในรูปแบบ +5511987654321 นี่คือหนึ่งในการผสานรวมไม่กี่รายการที่รูปแบบยืดหยุ่น: หากพนักงานไม่ได้ใช้ส่วนขยาย PBX ภายใน ให้ป้อนหมายเลขโทรศัพท์มือถือของพวกเขา

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

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

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

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

การโทรจากพนักงานไปยังลูกค้า

totalvoice_employee_call(client_phone, employee_number, bina, gravar_audio)

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

  • client_phone — หมายเลขโทรศัพท์ของลูกค้าในรูปแบบ +5511987654321 จำเป็น
  • employee_number — หมายเลขของพนักงาน: ส่วนขยายภายในหรือหมายเลขโทรศัพท์มือถือ จำเป็น
  • bina — หมายเลขที่ลูกค้าจะเห็น ไม่บังคับ หากละเว้น จะใช้หมายเลขจากการตั้งค่าการเชื่อมต่อ
  • gravar_audio — ว่าจะบันทึกการโทรหรือไม่ ไม่บังคับ การบันทึกเปิดใช้งานโดยค่าเริ่มต้น

โอนสาย

totalvoice_transfer_call(number, call_id, leg)

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

  • number — หมายเลขที่ควรโอนสายไป จำเป็น
  • call_id — ตัวระบุการโทร ไม่บังคับ หากละเว้น จะใช้การโทรล่าสุดของลูกค้า
  • leg — ฝั่งใดของการโทรที่จะโอน: destino (ลูกค้า ค่าเริ่มต้น) หรือ origem (พนักงาน)

วางสาย

totalvoice_hangup_call(call_id)

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

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

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

totalvoice_get_record_link(call_id)

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

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

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

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

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

totalvoice_call_event atendida

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

เหตุการณ์ เมื่อถูกเรียกใช้
chamando การโทรกำลังดัง
preparando สายกำลังเตรียมการเชื่อมต่อ
atendida การโทรได้รับการตอบรับ
sem_resposta ไม่มีการตอบรับ
ocupado สายไม่ว่าง
cancelada การโทรถูกยกเลิก
congestionado เครือข่ายผู้ให้บริการแออัด
falha การโทรไม่สำเร็จ
nao_existe หมายเลขไม่มีอยู่

ชื่อสถานะได้รับเป็นภาษาโปรตุเกส เนื่องจากเป็นชื่อสถานะที่ TotalVoice ใช้

สถานการณ์ทั่วไป "ไม่มีการตอบรับ → ส่งข้อความในแอปส่งข้อความ" สามารถสร้างได้โดยการตรวจสอบตัวแปร totalvoice_call_answered

การแจ้งเตือนสถานะการโทรจะถูกส่งไม่เกินหนึ่งครั้งทุก 2 วินาทีต่อการโทร สำหรับการโทรที่สั้นมาก สถานะกลางบางสถานะอาจไม่มาถึงทันเวลา เหตุการณ์สิ้นสุดการโทรจะถูกส่งเสมอ

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

ตัวแปร ค่า
totalvoice_call_id ตัวระบุการโทร
totalvoice_call_status สถานะการโทรตามที่ TotalVoice กำหนด
totalvoice_call_answered 1 — การโทรได้รับการตอบรับ 0 — ไม่ได้รับการตอบรับ
totalvoice_call_duration ระยะเวลาการโทรเป็นวินาที
totalvoice_call_price ค่าใช้จ่ายการโทรเป็นเรียลบราซิล
totalvoice_hangup_reason เหตุผลที่การโทรสิ้นสุด
totalvoice_record_link ลิงก์ไปยังการบันทึกการโทร

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

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

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

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

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

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

ข้อผิดพลาด สาเหตุ / วิธีแก้ไข
การโทรไม่ถูกสร้างและข้อความแสดงข้อผิดพลาดเป็นภาษาโปรตุเกส TotalVoice ส่งคืนเหตุผลเป็นข้อความ สาเหตุที่พบบ่อยที่สุดคือยอดคงเหลือไม่เพียงพอหรือรูปแบบหมายเลขโทรศัพท์ไม่ถูกต้อง
การโทรทำงาน แต่ไม่มี callbacks ปรากฏในการสนทนา notification URL ยังไม่ได้เพิ่มในแดชบอร์ด TotalVoice ยังไม่ได้เพิ่มในเว็บฮุคทั้งสาม หรือยังไม่ผ่าน 20 นาทีหลังการกำหนดค่า
ทุกอย่างทำงานก่อนหน้านี้ แต่เหตุการณ์หยุดกะทันหัน Access Token ถูกสร้างใหม่ ซึ่งเปลี่ยน notification URL บันทึกโทเค็นใหม่ใน Mavibot และอัปเดต URL ในแดชบอร์ด TotalVoice
"TotalVoice number is not specified" หมายเลข TotalVoice ของพนักงานหายไปจากการตั้งค่าของพวกเขา
สถานะ nao_existe หมายเลขของลูกค้าไม่มีอยู่ ตรวจสอบรูปแบบ หมายเลขโทรศัพท์มือถือของบราซิลใช้ +55 + DDD + 9 หลัก
สถานะ congestionado มีปัญหากับเครือข่ายของผู้ให้บริการและไม่เกี่ยวข้องกับหมายเลขของลูกค้า หากปัญหายังคงอยู่ โปรดติดต่อฝ่ายสนับสนุน TotalVoice
ไม่มีลิงก์บันทึก การโทรถูกสร้างโดยปิดการบันทึก หรือการโทรไม่ได้รับการตอบรับ