Telinfy MCP server

官方

以程式化方式發送簡訊、WhatsApp 和 RCS 訊息，並符合 DLT 規範。管理聯絡人、排程行銷活動，以及追蹤送達報告。

GitHub

文件

Telinfy MCP 整合指南

如何連接並使用 Telinfy MCP 伺服器與 AI 助理

Telinfy MCP 伺服器提供對 Telinfy 簡訊、WhatsApp 和 RCS 訊息功能的程式化存取，讓 AI 助理能代表您發送訊息、管理聯絡人、排程行銷活動及擷取報告。

什麼是 MCP？

模型上下文協定 (Model Context Protocol, MCP) 是一項開放標準，讓 AI 應用程式能安全地連接到相容 MCP 的資料來源和工具。您可以將 MCP 想像成 AI 應用程式的 USB-C 連接埠——一種將 AI 應用程式連接到不同服務的標準化方式。

Telinfy MCP 伺服器

Telinfy MCP 伺服器是一項安全、經過驗證的服務，提供對您 Telinfy 訊息平台的存取。

基礎伺服器 URL： https://mcp.telinfy.com/sse

需要驗證

要使用 Telinfy MCP 伺服器，您需要：

  • Telinfy 使用者名稱
  • Telinfy 密碼
  • API 憑證（登入後自動擷取）

可用工具

Telinfy MCP 伺服器提供全面的訊息和行銷活動管理工具：

簡訊操作

  1. send_sms - 發送符合 DLT 規範的簡訊
  2. schedule_sms - 排程簡訊行銷活動以便未來發送
  3. scheduleDynamicCampaign - 使用 Excel 檔案和範本變數排程動態簡訊行銷活動
  4. get_sms_schedule - 檢視所有已排程的簡訊行銷活動
  5. fetch_sms_campaign_report - 取得簡訊行銷活動的詳細報告

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（伺服器傳送事件）協定：

SSE（伺服器傳送事件）- /sse

  • URL： https://mcp.telinfy.com/sse
  • 官方 MCP 規範版本
  • 受 Claude、Windsurf、Cursor 及其他 MCP 用戶端支援
  • 建議用於所有整合

設定說明

適用於 Claude Desktop/Web：

  1. 前往您的 Claude 設定
  2. 導覽至「整合」或「連線」
  3. 使用以下詳細資料新增 MCP 伺服器：
    • 名稱： Telinfy
    • 伺服器 URL： https://mcp.telinfy.com/sse
  4. 儲存設定

適用於 Claude Code（命令列）：

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 工具來建立安全工作階段。

使用案例範例

發送簡訊行銷活動

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 合規性

所有簡訊行銷活動均支援 DLT（分散式帳本技術）合規性，包含範本 ID 和寄件者名稱，確保在印度的法規遵循。

動態行銷活動

使用 Excel 檔案搭配變數替換來排程個人化簡訊行銷活動，非常適合大量個人化訊息發送。

多渠道訊息

  • 簡訊 - 促銷和交易路由
  • WhatsApp - 基於範本的商業訊息
  • RCS - 豐富通訊服務

全面報告

追蹤訊息傳遞、行銷活動績效，並產生具備日期篩選功能的詳細報告。

將聯絡人組織成群組、啟用/停用聯絡人，並維護整潔的電話簿清單。

安全性與驗證

  • 所有 API 呼叫均使用您的 Telinfy 憑證進行驗證
  • 初始登入後採用安全的權杖型驗證
  • 工作階段在您的對話期間持續維持
  • AI 助理不會儲存任何憑證

支援與資源

疑難排解

驗證問題

如果您遇到登入問題：

  1. 確認您的使用者名稱和密碼正確無誤
  2. 檢查您的帳戶是否已啟用 API 存取權限
  3. 聯絡 Telinfy 支援以確保您的帳戶具有 MCP 存取權限

連線問題

如果 MCP 伺服器無法連線：

  1. 確認伺服器 URL 完全正確：https://mcp.telinfy.com/sse
  2. 檢查您的網際網路連線
  3. 嘗試在您的 AI 用戶端設定中重新連線 MCP 伺服器

訊息傳遞問題

如果訊息無法發送：

  1. 確保您的 Telinfy 帳戶中有足夠的點數
  2. 確認 DLT 範本 ID 已正確註冊
  3. 檢查寄件者名稱是否已在您的 Telinfy 帳戶中核准
  4. 確認電話號碼格式正確

最佳實務

  1. 務必先登入 - 在每個工作階段開始時進行驗證
  2. 使用正確的範本 ID - 確保 DLT 範本與您的訊息內容相符
  3. 驗證電話格式 - 使用 10 碼印度號碼或含國碼的國際格式
  4. 檢查行銷活動報告 - 定期監控傳遞狀態
  5. 有效管理聯絡人 - 保持電話簿群組有條理
  6. 大量發送前先測試 - 在大型行銷活動前發送測試訊息

工作流程範例

以下是發送行銷活動的完整工作流程：

  1. 驗證
Log me into Telinfy with username "myuser" and password "mypass"
  1. 建立聯絡人群組
Create a phonebook group "Spring Sale 2024" with my customer list
  1. 排程行銷活動
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. 監控結果
Show me the delivery report for the Spring Sale campaign

進階功能

動態變數替換

使用 Excel 檔案大規模發送個人化訊息：

  • 上傳包含以下欄位的 Excel：手機號碼、姓名、訂單 ID、金額
  • 對應變數：{{1}} = 姓名，{{2}} = 訂單 ID，{{3}} = 金額
  • 範本：「Hi {{1}}，您的訂單 {{2}} 金額 Rs.{{3}} 已確認」

多路由簡訊

  • 路由 0： 促銷訊息
  • 路由 1： 交易訊息（OTP、警示）

Unicode 支援

透過啟用 Unicode 模式，以地區語言發送訊息。

入門檢查清單

  • 將 Telinfy MCP 伺服器連接到您的 AI 助理
  • 使用您的 Telinfy 憑證進行驗證
  • 確認您有有效的寄件者名稱和 DLT 範本
  • 檢查您的帳戶餘額和點數
  • 在大量行銷活動前先以單一簡訊測試
  • 建立有條理的電話簿群組
  • 設定排程行銷活動以獲得最佳時機
  • 定期監控報告

如需詳細的 API 規格和參數參考，請參閱 Telinfy API 文件或聯絡您的客戶經理。