Telinfy MCP server

आधिकारिक

प्रोग्रामेटिक रूप से DLT अनुपालन के साथ SMS, WhatsApp और RCS संदेश भेजें। संपर्क प्रबंधित करें, अभियान शेड्यूल करें और डिलीवरी रिपोर्ट ट्रैक करें।

GitHub

दस्तावेज़

Telinfy MCP एकीकरण गाइड

AI सहायकों के साथ Telinfy MCP सर्वर को कैसे कनेक्ट और उपयोग करें

Telinfy MCP सर्वर Telinfy की SMS, 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 सर्वर व्यापक मैसेजिंग और अभियान प्रबंधन उपकरण प्रदान करता है:

SMS संचालन

  1. send_sms - DLT अनुपालन के साथ SMS संदेश भेजें
  2. schedule_sms - भविष्य में डिलीवरी के लिए SMS अभियान शेड्यूल करें
  3. scheduleDynamicCampaign - एक्सेल फ़ाइलों और टेम्पलेट चर का उपयोग करके गतिशील 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 डेस्कटॉप/वेब के लिए:

  1. अपनी Claude सेटिंग्स पर जाएं
  2. "एकीकरण" या "कनेक्शन" पर नेविगेट करें
  3. इन विवरणों के साथ एक नया MCP सर्वर जोड़ें:
    • नाम: Telinfy
    • सर्वर URL: https://mcp.telinfy.com/sse
  4. कॉन्फ़िगरेशन सहेजें

Claude कोड (कमांड लाइन) के लिए:

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 अभियान टेम्पलेट IDs और प्रेषक नामों के साथ DLT (वितरित खाता प्रौद्योगिकी) अनुपालन का समर्थन करते हैं, जो भारत में नियामक अनुपालन सुनिश्चित करता है।

गतिशील अभियान

चर प्रतिस्थापन के साथ एक्सेल फ़ाइलों का उपयोग करके वैयक्तिकृत 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 टेम्पलेट IDs सही ढंग से पंजीकृत हैं
  3. जांचें कि प्रेषक नाम आपके Telinfy खाते में स्वीकृत हैं
  4. पुष्टि करें कि फ़ोन नंबर सही प्रारूप में हैं

सर्वोत्तम अभ्यास

  1. हमेशा पहले लॉगिन करें - प्रत्येक सत्र की शुरुआत में प्रमाणीकृत करें
  2. सही टेम्पलेट IDs का उपयोग करें - सुनिश्चित करें कि 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

उन्नत सुविधाएं

गतिशील चर प्रतिस्थापन

बड़े पैमाने पर वैयक्तिकृत संदेश भेजने के लिए एक्सेल फ़ाइलों का उपयोग करें:

  • कॉलम के साथ एक्सेल अपलोड करें: मोबाइल, नाम, ऑर्डरID, राशि
  • चर मैप करें: {{1}} = नाम, {{2}} = ऑर्डरID, {{3}} = राशि
  • टेम्पलेट: "नमस्ते {{1}}, आपका ऑर्डर {{2}} रु.{{3}} का पुष्टि हो गया है"

मल्टी-रूट SMS

  • रूट 0: प्रचार संदेश
  • रूट 1: लेन-देन संदेश (OTP, अलर्ट)

यूनिकोड समर्थन

यूनिकोड मोड सक्षम करके क्षेत्रीय भाषाओं में संदेश भेजें।

आरंभ करने की चेकलिस्ट

  • Telinfy MCP सर्वर को अपने AI सहायक से कनेक्ट करें
  • अपने Telinfy क्रेडेंशियल्स के साथ प्रमाणीकृत करें
  • सत्यापित करें कि आपके पास सक्रिय प्रेषक नाम और DLT टेम्पलेट हैं
  • अपना खाता शेष और क्रेडिट जांचें
  • बल्क अभियानों से पहले एकल SMS के साथ परीक्षण करें
  • व्यवस्थित फ़ोनबुक समूह बनाएं
  • इष्टतम समय के लिए शेड्यूल किए गए अभियान सेट करें
  • नियमित रूप से रिपोर्ट की निगरानी करें

विस्तृत API विनिर्देशों और पैरामीटर संदर्भों के लिए, Telinfy API दस्तावेज़ीकरण देखें या अपने खाता प्रबंधक से संपर्क करें।