Telinfy MCP server

chính thức

Gửi tin nhắn SMS, WhatsApp và RCS theo chương trình, tuân thủ DLT. Quản lý danh bạ, lập lịch chiến dịch và theo dõi báo cáo gửi tin.

GitHub

Tài liệu

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

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

Máy chủ Telinfy MCP 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 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 mặt bạn.

MCP là gì?

Model Context Protocol (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 đến 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 dành cho ứng dụng AI - một cách chuẩn hóa để kết nối ứng dụng AI với các dịch vụ khác nhau.

Máy chủ Telinfy MCP

Máy chủ Telinfy MCP 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 máy chủ Telinfy MCP, 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 được truy xuất sau khi đăng nhập)

Công cụ Khả dụng

Máy chủ Telinfy MCP 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ả chiến dịch SMS đã lên lịch
  5. fetch_sms_campaign_report - Nhận báo cáo chi tiết cho chiến dịch SMS

Thao tác WhatsApp

  1. send_whatsapp_campaign - Gửi tin nhắn WhatsApp sử dụng mẫu đã tạo sẵn
  2. whatsapp_campaign - Liệt kê tất cả chiến dịch WhatsApp
  3. fetch_whatsapp_smart_report - Nhận báo cáo chiến dịch WhatsApp với bộ lọc ngày

Thao tác RCS

  1. fetch_rcs_report - Truy xuất báo cáo tin nhắn RCS với bộ lọc ngày

Quản lý Danh bạ

  1. create_phonebook - Tạo nhóm danh bạ mới với các liên hệ
  2. get_phonebook_groups - Liệt kê tất cả nhóm danh bạ
  3. get_group_contacts - Xem liên hệ trong một nhóm cụ thể
  4. edit_contact - Cập nhật thông tin liên hệ
  5. toggle_contact_status - Bật/tắt liên hệ trong một nhóm
  6. delete_contact_group - Xóa nhóm danh bạ

Báo cáo Tin nhắn

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

Xác thực

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

Máy chủ Telinfy MCP 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 máy khách MCP khác
  • Khuyến nghị cho mọi tích hợp

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

Cho Claude Desktop/Web:

  1. Đi tới 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áy chủ MCP mới với các chi tiết 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 máy khách MCP 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 máy chủ MCP, bạn sẽ 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.

Ví dụ về Trường hợp Sử dụng

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 Liên hệ

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"

Nhận 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

Tính năng Chính

Tuân thủ DLT

Tất cả chiến dịch SMS đều hỗ trợ tuân thủ DLT (Công nghệ Sổ cái Phân tán) 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 các chiến dịch SMS được cá nhân hóa bằng tệp Excel với thay thế biến, hoàn hảo cho nhắn tin hàng loạt được cá nhân hóa.

Nhắn tin Đa kênh

  • SMS - Tuyến quảng cáo và giao dịch
  • WhatsApp - Nhắn tin doanh nghiệp dựa trên mẫu
  • RCS - Dịch vụ Giao tiếp 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 ngày.

Sắp xếp liên hệ thành các nhóm, bật/tắt liên hệ 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 thời gian trò chuyện của bạn
  • Không có thông tin xác thực 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

Khắc phục sự cố

Sự cố Xác thực

Nếu bạn gặp sự cố đăng nhập:

  1. Xác minh tên người dùng và mật khẩu của bạn là chính xác
  2. Kiểm tra xem tài khoản của bạn đã được bật quyền truy cập API chưa
  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 máy chủ MCP không kết nối được:

  1. Xác minh 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 máy chủ MCP trong cài đặt máy khách AI của bạn

Sự cố Gửi Tin nhắn

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

  1. Đảm bảo bạn có đủ tín dụng trong tài khoản Telinfy
  2. Xác minh ID mẫu DLT đã được đăng ký chính xác
  3. Kiểm tra xem 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

Thực hành Tốt nhất

  1. Luôn đăng nhập trước - Xác thực khi bắt đầu mỗi phiên
  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. Xác minh định dạng số điện thoại - Sử dụng số Ấn Độ 10 chữ số hoặc định dạng quốc tế với 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ý liên hệ hiệu quả - Giữ các nhóm danh bạ được tổ chức
  6. Kiểm tra trước khi gửi hàng loạt - Gửi tin nhắn thử nghiệm trước các chiến dịch lớn

Ví dụ về Quy trình Làm việc

Đâ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"
  1. Tạo Nhóm Liên hệ
Create a phonebook group "Spring Sale 2024" with my customer list
  1. 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"
  1. Theo dõi Kết quả
Show me the delivery report for the Spring Sale campaign

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 trên 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: "Chào {{1}}, đơn hàng {{2}} của bạn trị giá {{3}} Rs. đã được xác nhận"

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ữ khu vực bằng cách bật chế độ Unicode.

Danh sách Kiểm tra Bắt đầu

  • Kết nối máy chủ Telinfy MCP 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
  • Xác minh bạn có tên người gửi và mẫu DLT đang hoạt động
  • Kiểm tra số dư tài khoản và tín dụng của bạn
  • Kiểm tra với một SMS đơn trước khi thực hiện chiến dịch hàng loạt
  • Tạo các nhóm danh bạ có tổ chức
  • Thiết lập các chiến dịch đã lên lịch để có thời gian tối ưu
  • Theo dõi báo cáo thường xuyên

Để biết thông số kỹ thuậ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.