Telinfy MCP server

Hướng dẫn tích hợp Telinfy MCP

Cách kết nối và sử dụng Telinfy MCP server với các trợ lý AI

Telinfy MCP server cung cấp quyền truy cập theo chương trình vào các khả năng nhắn tin SMS, WhatsApp và RCS của Telinfy, cho phép các trợ lý AI gửi tin nhắn, quản lý danh bạ, lên lịch chiến dịch và truy xuất báo cáo thay cho bạn.

---

MCP là gì?

Giao thức Model Context (MCP) là một tiêu chuẩn mở cho phép các ứng dụng AI kết nối an toàn với các nguồn dữ liệu và công cụ tương thích MCP. Hãy nghĩ về MCP như một cổng USB-C cho các ứng dụng AI - một cách chuẩn hóa để kết nối các ứng dụng AI với các dịch vụ khác nhau.

---

Telinfy MCP Server

Telinfy MCP server là một dịch vụ an toàn, có xác thực, cung cấp quyền truy cập vào nền tảng nhắn tin Telinfy của bạn.

URL máy chủ cơ sở: https://mcp.telinfy.com/sse

Yêu cầu xác thực

Để sử dụng Telinfy MCP server, bạn cần:

• Tên người dùng Telinfy
• Mật khẩu Telinfy
• Thông tin xác thực API (tự động lấy sau khi đăng nhập)

---

Các công cụ có sẵn

Telinfy MCP server cung cấp các công cụ quản lý chiến dịch và nhắn tin toàn diện:

Thao tác SMS

1. send_sms - Gửi tin nhắn SMS tuân thủ DLT
2. schedule_sms - Lên lịch chiến dịch SMS để gửi trong tương lai
3. scheduleDynamicCampaign - Lên lịch chiến dịch SMS động sử dụng tệp Excel và biến mẫu
4. get_sms_schedule - Xem tất cả các chiến dịch SMS đã lên lịch
5. fetch_sms_campaign_report - Lấy báo cáo chi tiết cho các chiến dịch SMS

Thao tác WhatsApp

6. send_whatsapp_campaign - Gửi tin nhắn WhatsApp sử dụng các mẫu đã tạo trước
7. whatsapp_campaign - Liệt kê tất cả các chiến dịch WhatsApp
8. fetch_whatsapp_smart_report - Lấy báo cáo chiến dịch WhatsApp có lọc theo ngày

Thao tác RCS

9. fetch_rcs_report - Truy xuất báo cáo tin nhắn RCS có lọc theo ngày

Quản lý danh bạ

10. create_phonebook - Tạo nhóm danh bạ mới với danh bạ
11. get_phonebook_groups - Liệt kê tất cả các nhóm danh bạ
12. get_group_contacts - Xem danh bạ trong một nhóm cụ thể
13. edit_contact - Cập nhật thông tin danh bạ
14. toggle_contact_status - Kích hoạt/vô hiệu hóa danh bạ trong một nhóm
15. delete_contact_group - Xóa các nhóm danh bạ

Báo cáo tin nhắn

16. getMessageReport - Lấy báo cáo gửi tin nhắn và trạng thái của các tin nhắn đã gửi

Xác thực

17. login_to_telinfy - Xác thực và thiết lập phiên làm việc với nền tảng Telinfy

---

Giao thức kết nối

Telinfy MCP server sử dụng giao thức SSE (Server-Sent Events):

SSE (Server-Sent Events) - /sse

• URL: https://mcp.telinfy.com/sse
• Phiên bản đặc tả MCP chính thức
• Được hỗ trợ bởi Claude, Windsurf, Cursor và các MCP client khác
• Được khuyến nghị cho tất cả các tích hợp

---

Hướng dẫn thiết lập

Cho Claude Desktop/Web:

1. Vào phần cài đặt Claude của bạn
2. Điều hướng đến "Tích hợp" hoặc "Kết nối"
3. Thêm một MCP server mới với các thông tin sau:
   • Tên: Telinfy
     • URL máy chủ: https://mcp.telinfy.com/sse
4. Lưu cấu hình

Cho Claude Code (Dòng lệnh):

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

Cho Windsurf, Cursor hoặc các MCP client khác:

Thêm cấu hình này vào tệp cài đặt MCP của bạn:

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

---

Sử dụng Telinfy MCP

Thiết lập ban đầu

Sau khi kết nối MCP server, bạn cần xác thực bằng thông tin đăng nhập Telinfy của mình:

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

Trợ lý AI sẽ sử dụng công cụ login_to_telinfy để thiết lập phiên làm việc an toàn.

Các trường hợp sử dụng ví dụ

Gửi chiến dịch SMS

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

Lên lịch chiến dịch tiếp thị

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."

Tạo nhóm danh bạ

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

Gửi tin nhắn WhatsApp

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

Lấy báo cáo chiến dịch

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

Lấy trạng thái gửi tin nhắn

Get the delivery status for all messages sent today

---

Các tính năng chính

Tuân thủ DLT

Tất cả các chiến dịch SMS đều hỗ trợ tuân thủ DLT (Distributed Ledger Technology) với ID mẫu và tên người gửi, đảm bảo tuân thủ quy định tại Ấn Độ.

Chiến dịch động

Lên lịch chiến dịch SMS được cá nhân hóa sử dụng tệp Excel với thay thế biến, hoàn hảo cho việc nhắn tin cá nhân hóa hàng loạt.

Nhắn tin đa kênh

• SMS - Các tuyến quảng cáo và giao dịch
• WhatsApp - Nhắn tin kinh doanh dựa trên mẫu
• RCS - Dịch vụ truyền thông phong phú

Báo cáo toàn diện

Theo dõi việc gửi tin nhắn, hiệu suất chiến dịch và tạo báo cáo chi tiết với bộ lọc theo ngày.

Quản lý danh bạ

Tổ chức danh bạ thành các nhóm, kích hoạt/vô hiệu hóa danh bạ và duy trì danh sách danh bạ sạch sẽ.

---

Bảo mật & Xác thực

• Tất cả các lệnh gọi API đều được xác thực bằng thông tin đăng nhập Telinfy của bạn
• Xác thực dựa trên mã thông báo an toàn sau khi đăng nhập ban đầu
• Phiên làm việc được duy trì trong suốt cuộc trò chuyện của bạn
• Không có thông tin đăng nhập nào được lưu trữ bởi trợ lý AI

---

Hỗ trợ & Tài nguyên

• Bảng điều khiển Telinfy: https://telinfy.com
• Tài liệu API: Liên hệ bộ phận hỗ trợ Telinfy để có tài liệu API chi tiết
• Giao thức MCP: https://modelcontextprotocol.io
• Hỗ trợ: Liên hệ người quản lý tài khoản Telinfy của bạn

---

Xử lý sự cố

Sự cố xác thực

Nếu bạn gặp vấn đề đăng nhập:

1. Kiểm tra tên người dùng và mật khẩu của bạn có chính xác không
2. Kiểm tra xem tài khoản của bạn có được bật quyền truy cập API không
3. Liên hệ bộ phận hỗ trợ Telinfy để đảm bảo tài khoản của bạn có quyền truy cập MCP

Sự cố kết nối

Nếu MCP server không kết nối được:

1. Kiểm tra URL máy chủ chính xác là: https://mcp.telinfy.com/sse
2. Kiểm tra kết nối internet của bạn
3. Thử kết nối lại MCP server trong cài đặt AI client của bạn

Sự cố gửi tin nhắn

Nếu tin nhắn không được gửi:

1. Đảm bảo bạn có đủ tín dụng trong tài khoản Telinfy
2. Kiểm tra ID mẫu DLT đã được đăng ký chính xác chưa
3. Kiểm tra tên người gửi đã được phê duyệt trong tài khoản Telinfy của bạn chưa
4. Xác nhận số điện thoại ở đúng định dạng

---

Các phương pháp tốt nhất

1. Luôn đăng nhập trước - Xác thực khi bắt đầu mỗi phiên làm việc
2. Sử dụng ID mẫu chính xác - Đảm bảo mẫu DLT khớp với nội dung tin nhắn của bạn
3. Kiểm tra định dạng số điện thoại - Sử dụng số Ấn Độ 10 chữ số hoặc định dạng quốc tế có mã quốc gia
4. Kiểm tra báo cáo chiến dịch - Theo dõi trạng thái gửi thường xuyên
5. Quản lý danh bạ hiệu quả - Giữ các nhóm danh bạ được tổ chức gọn gàng
6. Kiểm tra trước khi gửi hàng loạt - Gửi tin nhắn thử trước các chiến dịch lớn

---

Quy trình làm việc ví dụ

Đây là quy trình làm việc hoàn chỉnh để gửi một chiến dịch:

1. Xác thực

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

2. Tạo nhóm danh bạ

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

3. Lên lịch chiến dịch

   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. Theo dõi kết quả

   Show me the delivery report for the Spring Sale campaign
   

---

Các tính năng nâng cao

Thay thế biến động

Sử dụng tệp Excel để gửi tin nhắn được cá nhân hóa ở quy mô lớn:

• Tải lên Excel với các cột: Mobile, Name, OrderID, Amount
• Ánh xạ biến: {{1}} = Name, {{2}} = OrderID, {{3}} = Amount
• Mẫu: "Hi {{1}}, your order {{2}} of Rs.{{3}} is confirmed"

SMS đa tuyến

• Tuyến 0: Tin nhắn quảng cáo
• Tuyến 1: Tin nhắn giao dịch (OTP, cảnh báo)

Hỗ trợ Unicode

Gửi tin nhắn bằng ngôn ngữ địa phương bằng cách bật chế độ Unicode.

---

Danh sách kiểm tra bắt đầu

• Kết nối Telinfy MCP server với trợ lý AI của bạn
• Xác thực bằng thông tin đăng nhập Telinfy của bạn
• Kiểm tra bạn có tên người gửi và mẫu DLT đang hoạt động không
• Kiểm tra số dư và tín dụng tài khoản của bạn
• Thử nghiệm với một SMS đơn lẻ trước các chiến dịch hàng loạt
• Tạo các nhóm danh bạ được tổ chức gọn gàng
• Thiết lập các chiến dịch đã lên lịch để có thời điểm tối ưu
• Theo dõi báo cáo thường xuyên

---

Để có đặc tả API chi tiết và tham chiếu tham số, hãy tham khảo tài liệu API Telinfy hoặc liên hệ người quản lý tài khoản của bạn.