Telinfy MCP server

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

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

Telinfy MCP सर्वर Telinfy की SMS, WhatsApp, और RCS संदेश क्षमताओं तक प्रोग्रामेटिक पहुंच प्रदान करता है, जिससे AI सहायक आपकी ओर से संदेश भेज सकते हैं, संपर्क प्रबंधित कर सकते हैं, अभियान शेड्यूल कर सकते हैं, और रिपोर्ट प्राप्त कर सकते हैं।

---

MCP क्या है?

The 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 संचालन

6. send_whatsapp_campaign - पहले से बनाए गए टेम्पलेट्स का उपयोग करके WhatsApp संदेश भेजें
7. whatsapp_campaign - सभी WhatsApp अभियान सूचीबद्ध करें
8. fetch_whatsapp_smart_report - दिनांक फ़िल्टरिंग के साथ WhatsApp अभियान रिपोर्ट प्राप्त करें

RCS संचालन

9. fetch_rcs_report - दिनांक फ़िल्टरिंग के साथ RCS संदेश रिपोर्ट प्राप्त करें

संपर्क प्रबंधन

10. create_phonebook - संपर्कों के साथ नए फोनबुक समूह बनाएं
11. get_phonebook_groups - सभी फोनबुक समूह सूचीबद्ध करें
12. get_group_contacts - किसी विशिष्ट समूह के भीतर संपर्क देखें
13. edit_contact - संपर्क जानकारी अपडेट करें
14. toggle_contact_status - किसी समूह में संपर्क सक्षम/अक्षम करें
15. delete_contact_group - फोनबुक समूह हटाएं

संदेश रिपोर्टिंग

16. getMessageReport - भेजे गए संदेशों के लिए संदेश वितरण रिपोर्ट और स्थिति प्राप्त करें

प्रमाणीकरण

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

डायनामिक अभियान

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

---

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

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

• कॉलम के साथ 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, अलर्ट)

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

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

---

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

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

---

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