Telinfy MCP server

公式

DLT準拠でSMS、WhatsApp、RCSメッセージをプログラムから送信できます。連絡先の管理、キャンペーンのスケジュール設定、配信レポートの追跡が可能です。

GitHub

ドキュメント

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 (Server-Sent Events) プロトコルを使用します。

SSE (Server-Sent Events) - /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 キャンペーンは、テンプレート ID と送信者名による DLT (分散台帳技術) 準拠をサポートし、インドにおける規制遵守を保証します。

動的キャンペーン

変数置換を使用した Excel ファイルでパーソナライズされた SMS キャンペーンをスケジュールします。一括パーソナライズメッセージングに最適です。

マルチチャネルメッセージング

  • SMS - プロモーションおよびトランザクションルート
  • WhatsApp - テンプレートベースのビジネスメッセージング
  • RCS - リッチコミュニケーションサービス

包括的なレポート

メッセージ配信、キャンペーンパフォーマンスを追跡し、日付フィルタリングを使用して詳細なレポートを生成します。

連絡先をグループに整理し、連絡先を有効/無効にし、クリーンな電話帳リストを維持します。

セキュリティと認証

  • すべての API 呼び出しは、Telinfy 認証情報を使用して認証されます
  • 初回ログイン後の安全なトークンベースの認証
  • セッションは会話の間維持されます
  • AI アシスタントによって認証情報が保存されることはありません

サポートとリソース

  • Telinfy ダッシュボード: https://telinfy.com
  • API ドキュメント: 詳細な API ドキュメントについては Telinfy サポートにお問い合わせください
  • MCP プロトコル: https://modelcontextprotocol.io
  • サポート: Telinfy アカウントマネージャーにお問い合わせください

トラブルシューティング

認証の問題

ログインの問題が発生した場合:

  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}}, your order {{2}} of Rs.{{3}} is confirmed"

マルチルート SMS

  • ルート 0: プロモーションメッセージ
  • ルート 1: トランザクションメッセージ (OTP、アラート)

Unicode サポート

Unicode モードを有効にすることで、地域言語でメッセージを送信します。

開始チェックリスト

  • Telinfy MCP サーバーを AI アシスタントに接続する
  • Telinfy 認証情報で認証する
  • アクティブな送信者名と DLT テンプレートがあることを確認する
  • アカウント残高とクレジットを確認する
  • 一括キャンペーンの前に単一の SMS でテストする
  • 整理された電話帳グループを作成する
  • 最適なタイミングのためにスケジュールされたキャンペーンを設定する
  • レポートを定期的に監視する

詳細な API 仕様とパラメータリファレンスについては、Telinfy API ドキュメントを参照するか、アカウントマネージャーにお問い合わせください。