Telinfy MCP server

คู่มือการเชื่อมต่อ Telinfy MCP

วิธีเชื่อมต่อและใช้งานเซิร์ฟเวอร์ Telinfy MCP กับผู้ช่วย AI

เซิร์ฟเวอร์ Telinfy MCP มอบการเข้าถึงความสามารถด้านการส่งข้อความ SMS, WhatsApp และ RCS ของ Telinfy แบบเป็นโปรแกรม ช่วยให้ผู้ช่วย AI สามารถส่งข้อความ จัดการรายชื่อผู้ติดต่อ กำหนดเวลาแคมเปญ และเรียกดูรายงานแทนคุณได้

---

MCP คืออะไร?

Model Context Protocol (MCP) คือมาตรฐานเปิดที่ช่วยให้แอปพลิเคชัน AI เชื่อมต่อกับแหล่งข้อมูลและเครื่องมือที่เข้ากันได้กับ MCP ได้อย่างปลอดภัย ลองนึกภาพ MCP เป็นเหมือนพอร์ต USB-C สำหรับแอปพลิเคชัน AI ซึ่งเป็นวิธีมาตรฐานในการเชื่อมต่อแอป AI เข้ากับบริการต่างๆ

---

เซิร์ฟเวอร์ Telinfy MCP

เซิร์ฟเวอร์ Telinfy MCP เป็นบริการที่ปลอดภัยและผ่านการตรวจสอบสิทธิ์ ซึ่งให้การเข้าถึงแพลตฟอร์มการส่งข้อความ Telinfy ของคุณ

URL เซิร์ฟเวอร์หลัก: https://mcp.telinfy.com/sse

จำเป็นต้องตรวจสอบสิทธิ์

ในการใช้เซิร์ฟเวอร์ Telinfy MCP คุณต้องมี:

• ชื่อผู้ใช้ Telinfy
• รหัสผ่าน Telinfy
• ข้อมูลรับรอง API (ดึงข้อมูลอัตโนมัติหลังจากเข้าสู่ระบบ)

---

เครื่องมือที่พร้อมใช้งาน

เซิร์ฟเวอร์ Telinfy MCP มีเครื่องมือจัดการข้อความและแคมเปญที่ครอบคลุม:

การดำเนินการ SMS

1. send_sms - ส่งข้อความ SMS ที่สอดคล้องกับ DLT
2. schedule_sms - กำหนดเวลาแคมเปญ SMS สำหรับการจัดส่งในอนาคต
3. scheduleDynamicCampaign - กำหนดเวลาแคมเปญ SMS แบบไดนามิกโดยใช้ไฟล์ Excel และตัวแปรเทมเพลต
4. get_sms_schedule - ดูแคมเปญ SMS ที่กำหนดเวลาทั้งหมด
5. fetch_sms_campaign_report - รับรายงานโดยละเอียดสำหรับแคมเปญ SMS

การดำเนินการ WhatsApp

1. send_whatsapp_campaign - ส่งข้อความ WhatsApp โดยใช้เทมเพลตที่สร้างไว้ล่วงหน้า
2. whatsapp_campaign - แสดงรายการแคมเปญ WhatsApp ทั้งหมด
3. fetch_whatsapp_smart_report - รับรายงานแคมเปญ WhatsApp พร้อมการกรองตามวันที่

การดำเนินการ RCS

1. fetch_rcs_report - เรียกดูรายงานข้อความ RCS พร้อมการกรองตามวันที่

การจัดการรายชื่อผู้ติดต่อ

1. create_phonebook - สร้างกลุ่มสมุดโทรศัพท์ใหม่พร้อมรายชื่อผู้ติดต่อ
2. get_phonebook_groups - แสดงรายการกลุ่มสมุดโทรศัพท์ทั้งหมด
3. get_group_contacts - ดูรายชื่อผู้ติดต่อภายในกลุ่มที่ระบุ
4. edit_contact - อัปเดตข้อมูลผู้ติดต่อ
5. toggle_contact_status - เปิด/ปิดใช้งานผู้ติดต่อในกลุ่ม
6. delete_contact_group - ลบกลุ่มสมุดโทรศัพท์

การรายงานข้อความ

1. getMessageReport - ดึงรายงานการจัดส่งข้อความและสถานะสำหรับข้อความที่ส่งแล้ว

การตรวจสอบสิทธิ์

1. login_to_telinfy - ตรวจสอบสิทธิ์และสร้างเซสชันกับแพลตฟอร์ม Telinfy

---

โปรโตคอลการสื่อสาร

เซิร์ฟเวอร์ Telinfy MCP ใช้โปรโตคอล SSE (Server-Sent Events):

SSE (Server-Sent Events) - /sse

• URL: https://mcp.telinfy.com/sse
• เวอร์ชันข้อกำหนด MCP อย่างเป็นทางการ
• รองรับโดย Claude, Windsurf, Cursor และไคลเอนต์ MCP อื่นๆ
• แนะนำสำหรับการเชื่อมต่อทั้งหมด

---

คำแนะนำในการตั้งค่า

สำหรับ Claude Desktop/Web:

1. ไปที่การตั้งค่า Claude ของคุณ
2. ไปที่ "Integrations" หรือ "Connections"
3. เพิ่มเซิร์ฟเวอร์ MCP ใหม่ด้วยรายละเอียดเหล่านี้:
   • ชื่อ: Telinfy
   • URL เซิร์ฟเวอร์: https://mcp.telinfy.com/sse
4. บันทึกการกำหนดค่า

สำหรับ Claude Code (Command Line):

claude mcp add -s user -t http telinfy https://mcp.telinfy.com/sse

สำหรับ Windsurf, Cursor หรือไคลเอนต์ MCP อื่นๆ:

เพิ่มการกำหนดค่านี้ลงในไฟล์การตั้งค่า MCP ของคุณ:

{ "mcpServers": { "telinfy": { "serverUrl": "https://mcp.telinfy.com/sse" } } }

---

การใช้ Telinfy MCP

การตั้งค่าเริ่มต้น

หลังจากเชื่อมต่อเซิร์ฟเวอร์ MCP แล้ว คุณจะต้องตรวจสอบสิทธิ์ด้วยข้อมูลรับรอง Telinfy ของคุณ:

Claude, please log me into Telinfy using my username and password.

ผู้ช่วย AI จะใช้เครื่องมือ login_to_telinfy เพื่อสร้างเซสชันที่ปลอดภัย

ตัวอย่างกรณีการใช้งาน

ส่งแคมเปญ SMS

Send an SMS to +919876543210 with the message "Your OTP is 123456" 
using sender name "NOTIFY" and template ID "1234567890"

กำหนดเวลาแคมเปญการตลาด

Schedule an SMS campaign named "Weekend Sale" to be sent tomorrow at 10 AM 
to these numbers: +919876543210, +919876543211 with the message 
"Flash Sale this weekend! 50% off. Visit now."

สร้างกลุ่มผู้ติดต่อ

Create a new phonebook group called "VIP Customers" with these contacts:
- John Doe, +919876543210
- Jane Smith, +919876543211

ส่งข้อความ WhatsApp

Send a WhatsApp campaign using my "order_confirmation" template 
to +919876543210 with customer name "John" and order number "ORD123"

รับรายงานแคมเปญ

Show me the SMS campaign report for campaign ID "12345"

ดึงสถานะการจัดส่งข้อความ

Get the delivery status for all messages sent today

---

คุณสมบัติหลัก

การปฏิบัติตาม DLT

แคมเปญ SMS ทั้งหมดรองรับการปฏิบัติตาม DLT (Distributed Ledger Technology) ด้วย ID เทมเพลตและชื่อผู้ส่ง เพื่อให้มั่นใจว่าสอดคล้องกับกฎระเบียบในอินเดีย

แคมเปญแบบไดนามิก

กำหนดเวลาแคมเปญ SMS ส่วนบุคคลโดยใช้ไฟล์ Excel พร้อมการแทนที่ตัวแปร เหมาะสำหรับการส่งข้อความส่วนบุคคลจำนวนมาก

การส่งข้อความหลายช่องทาง

• SMS - เส้นทางโปรโมชันและธุรกรรม
• WhatsApp - การส่งข้อความธุรกิจแบบใช้เทมเพลต
• RCS - Rich Communication Services

การรายงานที่ครอบคลุม

ติดตามการจัดส่งข้อความ ประสิทธิภาพของแคมเปญ และสร้างรายงานโดยละเอียดพร้อมการกรองตามวันที่

จัดระเบียบผู้ติดต่อเป็นกลุ่ม เปิด/ปิดใช้งานผู้ติดต่อ และรักษารายการสมุดโทรศัพท์ให้สะอาด

---

ความปลอดภัยและการตรวจสอบสิทธิ์

• การเรียก API ทั้งหมดได้รับการตรวจสอบสิทธิ์โดยใช้ข้อมูลรับรอง Telinfy ของคุณ
• การตรวจสอบสิทธิ์แบบใช้โทเค็นที่ปลอดภัยหลังจากการเข้าสู่ระบบครั้งแรก
• เซสชันจะถูกเก็บรักษาไว้ตลอดระยะเวลาการสนทนาของคุณ
• ผู้ช่วย AI จะไม่จัดเก็บข้อมูลรับรองใดๆ

---

การสนับสนุนและทรัพยากร

• แดชบอร์ด Telinfy: https://telinfy.com
• เอกสาร API: ติดต่อฝ่ายสนับสนุน Telinfy สำหรับเอกสาร API โดยละเอียด
• โปรโตคอล MCP: https://modelcontextprotocol.io
• การสนับสนุน: ติดต่อผู้จัดการบัญชี Telinfy ของคุณ

---

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

ปัญหาการตรวจสอบสิทธิ์

หากคุณพบปัญหาในการเข้าสู่ระบบ:

1. ตรวจสอบว่าชื่อผู้ใช้และรหัสผ่านของคุณถูกต้อง
2. ตรวจสอบว่าบัญชีของคุณเปิดใช้งานการเข้าถึง API หรือไม่
3. ติดต่อฝ่ายสนับสนุน Telinfy เพื่อให้แน่ใจว่าบัญชีของคุณมีการเข้าถึง MCP

ปัญหาการเชื่อมต่อ

หากเซิร์ฟเวอร์ MCP ไม่เชื่อมต่อ:

1. ตรวจสอบว่า URL เซิร์ฟเวอร์ถูกต้องตรงตามนี้: https://mcp.telinfy.com/sse
2. ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตของคุณ
3. ลองเชื่อมต่อเซิร์ฟเวอร์ MCP ใหม่ในการตั้งค่าไคลเอนต์ AI ของคุณ

ปัญหาการจัดส่งข้อความ

หากข้อความไม่ถูกส่ง:

1. ตรวจสอบให้แน่ใจว่าคุณมีเครดิตเพียงพอในบัญชี Telinfy ของคุณ
2. ตรวจสอบว่า ID เทมเพลต DLT ถูกลงทะเบียนอย่างถูกต้อง
3. ตรวจสอบว่าชื่อผู้ส่งได้รับการอนุมัติในบัญชี Telinfy ของคุณ
4. ยืนยันว่าหมายเลขโทรศัพท์อยู่ในรูปแบบที่ถูกต้อง

---

แนวทางปฏิบัติที่ดีที่สุด

1. เข้าสู่ระบบก่อนเสมอ - ตรวจสอบสิทธิ์เมื่อเริ่มต้นแต่ละเซสชัน
2. ใช้ ID เทมเพลตที่ถูกต้อง - ตรวจสอบให้แน่ใจว่าเทมเพลต DLT ตรงกับเนื้อหาข้อความของคุณ
3. ตรวจสอบรูปแบบโทรศัพท์ - ใช้หมายเลขอินเดีย 10 หลักหรือรูปแบบสากลพร้อมรหัสประเทศ
4. ตรวจสอบรายงานแคมเปญ - ตรวจสอบสถานะการจัดส่งอย่างสม่ำเสมอ
5. จัดการผู้ติดต่ออย่างมีประสิทธิภาพ - จัดระเบียบกลุ่มสมุดโทรศัพท์ให้เป็นระเบียบ
6. ทดสอบก่อนส่งจำนวนมาก - ส่งข้อความทดสอบก่อนแคมเปญขนาดใหญ่

---

ตัวอย่างขั้นตอนการทำงาน

นี่คือขั้นตอนการทำงานที่สมบูรณ์สำหรับการส่งแคมเปญ:

1. ตรวจสอบสิทธิ์

Log me into Telinfy with username "myuser" and password "mypass"  

2. สร้างกลุ่มผู้ติดต่อ

Create a phonebook group "Spring Sale 2024" with my customer list  

3. กำหนดเวลาแคมเปญ

Schedule an SMS campaign "Spring Sale Announcement" to the "Spring Sale 2024"  
group for tomorrow at 9 AM with message "Exclusive Spring Sale! 40% off all items.  
Shop now at example.com" using sender "RETAIL" and template "1234567890"  

4. ติดตามผลลัพธ์

Show me the delivery report for the Spring Sale campaign  

---

คุณสมบัติขั้นสูง

การแทนที่ตัวแปรแบบไดนามิก

ใช้ไฟล์ Excel เพื่อส่งข้อความส่วนบุคคลในปริมาณมาก:

• อัปโหลด Excel พร้อมคอลัมน์: Mobile, Name, OrderID, Amount
• จับคู่ตัวแปร: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• เทมเพลต: "สวัสดี {{1}} คำสั่งซื้อ {{2}} ของคุณจำนวน Rs.{{3}} ได้รับการยืนยันแล้ว"

SMS หลายเส้นทาง

• เส้นทาง 0: ข้อความโปรโมชัน
• เส้นทาง 1: ข้อความธุรกรรม (OTP, การแจ้งเตือน)

รองรับ Unicode

ส่งข้อความเป็นภาษาท้องถิ่นโดยเปิดใช้งานโหมด Unicode

---

รายการตรวจสอบการเริ่มต้นใช้งาน

• เชื่อมต่อเซิร์ฟเวอร์ Telinfy MCP กับผู้ช่วย AI ของคุณ
• ตรวจสอบสิทธิ์ด้วยข้อมูลรับรอง Telinfy ของคุณ
• ตรวจสอบว่าคุณมีชื่อผู้ส่งและเทมเพลต DLT ที่ใช้งานได้
• ตรวจสอบยอดเงินในบัญชีและเครดิตของคุณ
• ทดสอบด้วย SMS เดียวก่อนแคมเปญจำนวนมาก
• สร้างกลุ่มสมุดโทรศัพท์ที่เป็นระเบียบ
• ตั้งค่าแคมเปญตามกำหนดเวลาเพื่อเวลาที่เหมาะสมที่สุด
• ตรวจสอบรายงานอย่างสม่ำเสมอ

---

สำหรับข้อกำหนด API โดยละเอียดและการอ้างอิงพารามิเตอร์ โปรดดูเอกสาร Telinfy API หรือติดต่อผู้จัดการบัญชีของคุณ