Telinfy MCP server

官方

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

GitHub

文档

Telinfy MCP 集成指南

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

Telinfy MCP 服务器提供对 Telinfy 短信、WhatsApp 和 RCS 消息功能的编程访问，允许 AI 助手代表您发送消息、管理联系人、安排营销活动并获取报告。

什么是 MCP？

模型上下文协议 (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：Mobile、Name、OrderID、Amount
  • 映射变量：{{1}} = Name、{{2}} = OrderID、{{3}} = Amount
  • 模板：“Hi {{1}}，您的订单 {{2}} 金额为 Rs.{{3}} 已确认”

多路由短信

  • 路由 0： 促销消息
  • 路由 1： 事务性消息（OTP、警报）

Unicode 支持

通过启用 Unicode 模式以区域语言发送消息。

入门清单

  • 将 Telinfy MCP 服务器连接到您的 AI 助手
  • 使用您的 Telinfy 凭证进行身份验证
  • 验证您是否有活动的发送者名称和 DLT 模板
  • 检查您的账户余额和点数
  • 在批量营销活动前用单条短信进行测试
  • 创建组织有序的电话簿分组
  • 设置定时营销活动以获得最佳时机
  • 定期监控报告

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