Voipstudio MCP

ทางการ

เซิร์ฟเวอร์ VoIPstudio MCP ช่วยให้ผู้ช่วย AI ที่เข้ากันได้สามารถเข้าถึงข้อมูลบัญชี VoIPstudio ที่ได้รับอนุญาตอย่างปลอดภัย รวมถึงการบันทึกเสียง รายละเอียดการโทร สายที่กำลังดำเนินอยู่ และข้อความเสียง เพื่อสอบถามกิจกรรมการโทร วิเคราะห์รูปแบบ ระบุปัญหาประสิทธิภาพของเอเยนต์ และสร้างรายงาน QA หรือการดำเนินงานเป็นภาษาอังกฤษธรรมดา

คุณทำอะไรได้บ้างด้วย Voipstudio MCP?

  • Pull call recordings with filters — ขอรับการบันทึกเสียงตามวันที่ ตัวแทน หรือคะแนน CX ผ่าน get_recordings รวมถึงบทถอดความและบทสรุปเมื่อเปิดใช้งาน CX Addon
  • Analyze call detail records — ใช้เพื่อรับสถิติปริมาณการโทร การวิเคราะห์ต้นทุน การกระจายระยะเวลา และสรุปกิจกรรมของตัวแทน
  • Monitor live calls in real time — ตรวจสอบสายที่กำลังดำเนินอยู่และตัวแทนที่รับสายอยู่
  • Retrieve voicemail messages — ดึงข้อความเสียงพร้อมตัวกรอง เช่น ผู้โทร วันที่ หรือสถานะการฟัง
  • Get direct audio download links — รับลิงก์ดาวน์โหลด MP3 ที่มีระยะเวลาจำกัดสำหรับการบันทึกเสียงเฉพาะรายการ

เอกสาร

AI - ปัญญาประดิษฐ์ - เซิร์ฟเวอร์ MCP ของ VoIPstudio

เซิร์ฟเวอร์ VoIPstudio MCP (Model Context Protocol) ช่วยให้ Claude AI เข้าถึงข้อมูลบัญชี VoIPstudio ของคุณได้โดยตรงและปลอดภัย รวมถึงการบันทึกเสียง CDR สายที่กำลังดำเนินอยู่ และข้อความเสียง เมื่อเชื่อมต่อแล้ว Claude สามารถสอบถามข้อมูลสาย วิเคราะห์รูปแบบ แสดงปัญหาด้านประสิทธิภาพของตัวแทน และสร้างรายงาน QA เป็นภาษาอังกฤษธรรมดา โดยไม่ต้องมีการพัฒนาที่กำหนดเอง

เพิ่ม CX Addon และการบันทึกเสียงแต่ละรายการจะมาพร้อมกับข้อมูลเสริมที่เตรียมไว้แล้ว เช่น บทถอดความ บทสรุป ความรู้สึก รายการการดำเนินการ และคะแนน CX ซึ่งช่วยลดงานด้าน AI ที่ Claude ต้องทำลงได้อย่างมาก และช่วยให้การใช้โทเคนของคุณลดลงและต้นทุนคาดเดาได้มากขึ้น

การรับคีย์ API

เซิร์ฟเวอร์ MCP ตรวจสอบสิทธิ์โดยใช้โทเคน API ของ VoIPstudio คีย์แต่ละรายการจะจำกัดขอบเขตเฉพาะผู้ใช้คนใดคนหนึ่ง ดังนั้น Claude จะสามารถเข้าถึงข้อมูลที่ผู้ใช้คนนั้นเข้าถึงได้เท่านั้น

วิธีสร้างคีย์:

  1. ในแดชบอร์ดผู้ดูแลระบบ เปิดผู้ใช้ที่คุณต้องการสร้างโทเคนให้
  2. ไปที่ส่วน API Keys
  3. ใส่ชื่อสำหรับคีย์ — ตัวอย่างเช่น Claude MCP
  4. คลิก Add
  5. คลิก ไอคอนรูปตา เพื่อแสดงคีย์ API / user_token คัดลอกค่านี้
  6. หากต้องการดูรายละเอียดเพิ่มเติมหรือลบคีย์ คลิก ไอคอนรูปเฟือง และเลือก Show Details

หมายเหตุ: คีย์ API จะยังคงใช้งานได้ตราบเท่าที่มีการใช้อย่างน้อยหนึ่งครั้งทุก 7 วัน (ค่าหมดเวลาที่ตั้งไว้) ตั้งค่าหมดเวลาที่ยาวขึ้น (หรือไม่จำกัด) หากจำเป็นก่อนคลิก Add

ดู เอกสาร REST API

การเชื่อมต่อกับ Claude

VoIPstudio ยังไม่ปรากฏในไดเรกทอรีตัวเชื่อมต่อของ Claude.ai คุณต้องเพิ่มด้วยตนเองเป็นเซิร์ฟเวอร์ MCP ที่กำหนดเอง

URL ของเซิร์ฟเวอร์ MCP

[!info] URL ของเซิร์ฟเวอร์ MCP https://mcp.voipstudio.workers.dev/sse

ขั้นตอน (Claude.ai)

  1. ใน Claude.ai ไปที่ Settings → Integrations (หรือแผงตัวเชื่อมต่อ ขึ้นอยู่กับแผนของคุณ)
  2. เลือก Add custom MCP server (หรือสิ่งที่เทียบเท่า)
  3. ใส่ URL ของเซิร์ฟเวอร์ MCP ด้านบน
  4. เมื่อได้รับแจ้งให้ตรวจสอบสิทธิ์ ให้ใส่คีย์ API ของ VoIPstudio ของคุณ
  5. บันทึกและอนุญาตการเชื่อมต่อ

ตอนนี้ Claude สามารถเรียกใช้เครื่องมือ VoIPstudio ในการสนทนาใดก็ได้ ครั้งแรกที่เรียกใช้เครื่องมือในเซสชัน Claude จะขอให้คุณยืนยันการแชร์ข้อมูล คลิก Always allow เพื่อข้ามข้อความนี้ในเซสชันถัดไป

Anthropic API (สำหรับนักพัฒนา)

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

การเชื่อมต่อกับแพลตฟอร์ม AI อื่น ๆ

แพลตฟอร์ม AI ส่วนใหญ่ที่รองรับ MCP ภายนอกสามารถเชื่อมต่อกับเซิร์ฟเวอร์ MCP ของ VoIPstudio ได้โดยใช้ URL และคีย์ API เดียวกัน ขั้นตอนการกำหนดค่าที่แน่นอนจะแตกต่างกันไปตามแพลตฟอร์ม มองหาตัวเลือกที่ระบุว่า external MCP server, custom MCP หรือ remote MCP ในส่วนการผสานรวมหรือการตั้งค่าของแพลตฟอร์มของคุณ

CX Addon

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

เมื่อมี CX Addon VoIPstudio จะจัดการการถอดความ การสรุป การวิเคราะห์ความรู้สึก การแยกรายการการดำเนินการ และการให้คะแนน CX บนโครงสร้างพื้นฐานของตัวเองด้วย ต้นทุนรายเดือนคงที่ ไม่มีค่าธรรมเนียมต่อสาย และไม่มีขีดจำกัดการถอดความ Claude จะได้รับข้อมูลเชิงลึกที่เสร็จสมบูรณ์ — พร้อมให้ใช้เหตุผลได้ทันที

ไม่มี CX Addonมี CX Addon
บทถอดความClaude ต้องดึงเสียงและถอดความ/แปล✓ มีให้ พร้อมระบุผู้พูด
บทสรุปClaude ต้องสร้าง✓ มีให้
ความรู้สึกClaude ต้องอนุมาน✓ มีให้
รายการการดำเนินการClaude ต้องแยกออก✓ มีให้
คะแนน CXไม่มี✓ 1–10 ทุกสาย
โทเคนโดยประมาณ/สาย10,000–15,000300–500
รูปแบบต้นทุนค่าใช้จ่าย AI ผันแปรสมัครสมาชิกรายเดือนคงที่

ฟิลด์ที่ปลดล็อกโดย CX Addon

ฟิลด์ประเภทคำอธิบาย
transcriptstringบทถอดความแบบคำต่อคำที่สมบูรณ์
transcript_speakersobjectส่วนบทถอดความที่ระบุผู้พูด
summarystringบทสรุปโดยย่อของผลลัพธ์การโทร
sentimentstringความรู้สึกของลูกค้า: positive, neutral, negative
cx_scorenumber (1–10)คะแนนประสบการณ์ลูกค้า
metadata.timelinearrayช่วงเวลาสำคัญและรายการการดำเนินการที่แยกจากการโทร

เอกสารอ้างอิงเครื่องมือ

ความเรียบง่ายของการผสานรวม MCP หมายความว่าไม่จำเป็นต้องเข้าใจ API ที่ซับซ้อน และสามารถใช้พรอมต์ง่าย ๆ เพื่อช่วยให้แพลตฟอร์ม AI เข้าใจข้อมูลที่ได้รับจาก Voipstudio และตอบกลับด้วยคำตอบที่เหมาะสม

อย่างไรก็ตาม ผู้ใช้ที่มีความเชี่ยวชาญด้านเทคนิคมากขึ้นอาจต้องการทราบสิ่งที่เกิดขึ้น "ภายใต้ฝาครอบ" ดังนั้นด้านล่างนี้คือเอกสารอ้างอิงสำหรับฟังก์ชันบางอย่างของเซิร์ฟเวอร์ MCP

get_recordings

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

พารามิเตอร์

พารามิเตอร์ประเภทค่าเริ่มต้นคำอธิบาย
filtersarray—ออบเจกต์ตัวกรอง — ดู การกรอง
limitnumber10ระเบียนต่อหน้า (สูงสุด 1000)
pagenumber1หมายเลขหน้า

ฟิลด์การตอบกลับ

ฟิลด์ประเภทคำอธิบาย
idnumberรหัสการบันทึกที่ไม่ซ้ำกัน
call_idnumberลิงก์ไปยัง CDR call_id
timestampstringเวลาเริ่มการบันทึก (UTC, YYYY-MM-DD HH:mm:ss)
callerstringหมายเลขผู้โทร
calledstringหมายเลขผู้ถูกเรียก
src_namestringชื่อตัวแทน (ต้นทาง)
dst_namestringชื่อปลายทาง
durationnumberระยะเวลาเป็นวินาที
typestringI \= สายเข้า, O \= สายออก
contextstringบริบทการโทร (เช่น LOCAL_USER, QUEUE)
transcriptstringnull
transcript_speakersobjectnull
summarystringnull
sentimentstringnull
cx_scorenumbernull
metadata.timelinearraynull

ตัวอย่าง – คะแนน CX ต่ำในสัปดาห์นี้

ถาม Claude: "แสดงการบันทึกทั้งหมดจากสัปดาห์นี้ที่คะแนน CX ต่ำกว่า 6 จัดกลุ่มตามตัวแทน พร้อมสรุปสิ่งที่ผิดพลาดในแต่ละสาย"

Claude เรียกใช้เครื่องมือด้วย:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs

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

พารามิเตอร์: เหมือนกับ get_recordings (filters, limit, page)

ฟิลด์การตอบกลับหลัก

ฟิลด์ประเภทคำอธิบาย
call_idnumberตัวระบุการโทรที่ไม่ซ้ำกัน
calldatestringการประทับเวลาเริ่มการโทร (UTC)
src_namestringชื่อตัวแทน / ผู้โทร
dst_namestringชื่อปลายทาง
billsecnumberวินาทีที่เรียกเก็บเงินได้
durationnumberวินาทีทั้งหมดรวมเสียงเรียกเข้า
dispositionstringCONNECTED, NO ANSWER, BUSY, FAILED
chargenumberต้นทุนการโทร
typestringI \= สายเข้า, O \= สายออก
src_uastringอุปกรณ์ต้นทาง / user-agent ของซอฟต์โฟน
labelsarrayแท็กที่กำหนดเองที่ใช้ใน VoIPstudio

get_live_calls

ส่งคืนภาพรวมแบบเรียลไทม์ของสายที่ใช้งานอยู่ทั้งหมดในบัญชีของคุณ ไม่ต้องใช้พารามิเตอร์

ตัวอย่าง: "มีสายที่กำลังดำเนินอยู่กี่สายตอนนี้ และตัวแทนคนใดกำลังรับสายอยู่"

get_voicemails

ดึงข้อความเสียง มีอินเทอร์เฟซ filters, limit และ page เดียวกับเครื่องมืออื่น ๆ

ฟิลด์ที่กรองได้หลัก: src, dst, calldate, duration, listened

get_recording_audio

ส่งคืน URL สำหรับดาวน์โหลดโดยตรงของไฟล์เสียง MP3 ของการบันทึกที่ระบุ

พารามิเตอร์: id (number) — ฟิลด์ id จากการตอบกลับของ get_recordings

[!info] ข้อมูล URL เสียงมีเวลาจำกัด ใช้ทันที อย่าแคชเป็นเวลานาน

การกรองและการแบ่งหน้า

เครื่องมือรายการทั้งหมดยอมรับอาร์เรย์ filters ที่ไม่บังคับ ออบเจกต์ตัวกรองแต่ละรายการมีสามคุณสมบัติ:

คุณสมบัติคำอธิบาย
propertyชื่อฟิลด์ที่จะกรอง (เช่น calldate, cx_score, src_name)
operatoreq, ne, lt, lte, gt, gte, in, like, notlike
valuestring, number หรือ array (สำหรับตัวดำเนินการ in)

ตัวอย่างทั่วไป

ช่วงวันที่

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

เกณฑ์คะแนน CX

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

ตัวแทนเฉพาะ

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

เฉพาะสายที่เชื่อมต่อแล้ว

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

สายเข้าที่ยาวเกิน 5 นาที

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

กรณีการใช้งาน

รายงาน QA

"ให้สรุป QA สำหรับตัวแทนแต่ละคนในเดือนนี้ — ค่าเฉลี่ยคะแนน CX หัวข้อข้อร้องเรียนทั่วไป และสามสายที่มีคะแนนต่ำที่สุดพร้อมบทสรุป"

สถิติปริมาณศูนย์บริการ

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

การวิเคราะห์แนวโน้มความรู้สึก

"ความรู้สึกของลูกค้าดีขึ้นหรือแย่ลงเมื่อเทียบกับเดือนที่แล้วหรือไม่ หัวข้อการโทรใดที่สัมพันธ์กับความรู้สึกเชิงลบ"

รายการติดตามผลสายที่ไม่ได้รับ

"แสดงรายการสายเข้าที่ไม่ได้รับทั้งหมดจาก 24 ชั่วโมงที่ผ่านมาพร้อมหมายเลขผู้โทร เพื่อให้ฉันจัดลำดับความสำคัญในการโทรกลับ"

การตรวจสอบต้นทุนและการเรียกเก็บเงิน

"ส่วนขยายใดบ้างที่โทรออกแพงที่สุดในไตรมาสนี้"

การตรวจสอบการดำเนินงานสด

"มีตัวแทนกี่คนที่กำลังรับสายอยู่ และมีสายใดที่ดำเนินมาเกิน 20 นาทีหรือไม่"

ประสิทธิภาพโทเคน

การโทรแต่ละครั้งที่ Claude วิเคราะห์โดยไม่มี CX Addon ต้องให้ Claude ประมวลผลเนื้อหาเสียงและสร้างการถอดความและการวิเคราะห์ของตัวเอง CX Addon โอนงานนี้ทั้งหมดไปยัง VoIPstudio:

สิ่งที่ VoIPstudio จัดการ (ต้นทุนรายเดือนคงที่ ไม่จำกัดจำนวนสาย):

  • การถอดความเสียง
  • การระบุผู้พูด
  • การสรุปการโทร
  • การจำแนกความรู้สึก
  • การแยกรายการการดำเนินการ
  • การให้คะแนน CX

สิ่งที่ Claude ได้รับ: ฟิลด์ข้อความที่มีโครงสร้างและสะอาด พร้อมสำหรับการให้เหตุผล การเปรียบเทียบ และการรายงาน

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