Telinfy MCP server

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

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

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

---

MCP คืออะไร?

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

---

Telinfy MCP Server

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

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

ต้องมีการยืนยันตัวตน

ในการใช้งาน Telinfy MCP server คุณจำเป็นต้องมี:

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

---

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

Telinfy MCP server มีเครื่องมือจัดการข้อความและแคมเปญอย่างครบครัน:

การดำเนินการ 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

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

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

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

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

10. create_phonebook - สร้างกลุ่มสมุดโทรศัพท์ใหม่พร้อมรายชื่อผู้ติดต่อ
11. get_phonebook_groups - แสดงรายการกลุ่มสมุดโทรศัพท์ทั้งหมด
12. get_group_contacts - ดูรายชื่อผู้ติดต่อภายในกลุ่มที่ระบุ
13. edit_contact - อัปเดตข้อมูลผู้ติดต่อ
14. toggle_contact_status - เปิด/ปิดใช้งานผู้ติดต่อในกลุ่ม
15. delete_contact_group - ลบกลุ่มสมุดโทรศัพท์

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

16. getMessageReport - ดึงรายงานการส่งข้อความและสถานะของข้อความที่ส่งไป

การยืนยันตัวตน

17. login_to_telinfy - ยืนยันตัวตนและสร้างเซสชันกับแพลตฟอร์ม Telinfy

---

โปรโตคอลการเชื่อมต่อ

Telinfy MCP server ใช้โปรโตคอล 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 server ใหม่ด้วยรายละเอียดเหล่านี้:
   • ชื่อ: 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 server แล้ว คุณจะต้องยืนยันตัวตนด้วยข้อมูลประจำตัว 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 ของคุณ
• การยืนยันตัวตนแบบ token ที่ปลอดภัยหลังเข้าสู่ระบบครั้งแรก
• เซสชันจะคงอยู่ตลอดระยะเวลาการสนทนาของคุณ
• ผู้ช่วย AI จะไม่จัดเก็บข้อมูลประจำตัวใดๆ

---

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

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

---

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

ปัญหาการยืนยันตัวตน

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

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

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

หาก MCP server ไม่เชื่อมต่อ:

1. ตรวจสอบว่า URL เซิร์ฟเวอร์ถูกต้อง: https://mcp.telinfy.com/sse
2. ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตของคุณ
3. ลองเชื่อมต่อ MCP server ใหม่ในการตั้งค่าไคลเอนต์ 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
• เทมเพลต: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

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

• Route 0: ข้อความส่งเสริมการขาย
• Route 1: ข้อความธุรกรรม (OTP, การแจ้งเตือน)

การรองรับ Unicode

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

---

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

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

---

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