Telinfy MCP server

官方

以编程方式发送短信、WhatsApp和RCS消息，并符合DLT规范。管理联系人、安排活动以及跟踪投递报告。

GitHub试用此 MCP赞助

你可以用 Telinfy MCP 做什么？

  • 安全认证 — 让您的助手通过 login_to_telinfy 使用您的 Telinfy 用户名和密码登录，以建立会话。

  • 发送符合 DLT 规范的短信 — 使用 send_sms 发送交易类或营销类消息，包含发件人名称和模板 ID，例如：“向 +919876543210 发送验证码。”

  • 安排动态活动 — 利用 scheduleDynamicCampaign 通过包含变量替换（如姓名、订单 ID）的 Excel 文件发送个性化群发短信。

  • 管理联系人分组 — 使用 create_phonebook 创建通讯录，通过 get_phonebook_groups 列出分组，并使用 get_group_contacts 和 edit_contact 查看或编辑联系人。

  • 发送 WhatsApp 活动 — 使用 send_whatsapp_campaign 配合预先创建的模板向客户发送消息，然后通过 fetch_whatsapp_smart_report 跟踪效果。

  • 获取投递报告 — 使用 fetch_sms_campaign_report、fetch_rcs_report 或 getMessageReport 按日期筛选检索短信、WhatsApp 或 RCS 活动报告。

文档

Telinfy MCP 集成指南

如何连接 AI 助手并使用 Telinfy MCP 服务器

Telinfy MCP 服务器提供对 Telinfy 的 SMS、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 服务器提供全面的消息和营销活动管理工具：

SMS 操作

  1. send_sms - 发送符合 DLT 规范的 SMS 消息
  2. schedule_sms - 安排 SMS 营销活动以供将来发送
  3. scheduleDynamicCampaign - 使用 Excel 文件和模板变量安排动态 SMS 营销活动
  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（服务器发送事件）协议：

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 工具建立安全会话。

示例用例

发送 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（分布式账本技术）合规性，包含模板 ID 和发件人名称，确保在印度符合监管要求。

动态营销活动

使用 Excel 文件和变量替换来安排个性化 SMS 营销活动，非常适合批量个性化消息发送。

多渠道消息传递

  • SMS - 促销和事务性路由
  • 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"
  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 文件大规模发送个性化消息：

  • 上传包含 Mobile、Name、OrderID、Amount 列的 Excel 文件
  • 映射变量：{{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 服务器连接到您的 AI 助手
  • 使用您的 Telinfy 凭据进行身份验证
  • 验证您拥有有效的发件人名称和 DLT 模板
  • 检查您的账户余额和信用额度
  • 在批量营销活动之前先测试单条 SMS
  • 创建有序的电话簿分组
  • 设置定时营销活动以获得最佳发送时机
  • 定期监控报告

有关详细的 API 规范和参数参考，请参阅 Telinfy API 文档或联系您的客户经理。