आपकी Telegram बातचीत सिर्फ़ AI चैट तक सीमित नहीं है। Telepath REST API इस संदर्भ को ऑटोमेशन टूल और अपने ऐप से जोड़ता है।

तैयार शुरुआत के लिए हमारा n8n कम्युनिटी नोड लें या Make जैसे टूल के लिए HTTP इंटीग्रेशन बनाएँ। API OAuth इस्तेमाल करता है: हर व्यक्ति अपना Telepath खाता जोड़कर पहुँच देता है।

क्या बना सकते हैं

  • बातचीत का सार: चुनी चैट के उपलब्ध संदेश पढ़ें, अपने AI से सार बनाएँ और सहेजें।
  • ग्राहक फ़ॉलो-अप: बातचीत ढूँढें, अनुरोध निकालें और नोट या टास्क बनाएँ।
  • जवाब असिस्टेंट: ड्राफ़्ट बनाएँ, जाँचें और अधिकृत Telegram कनेक्शन से भेजें।
  • चैनल वर्कफ़्लो: सामग्री तैयार करके आवश्यक अनुमतियों वाले जुड़े चैनल में प्रकाशित करें।

API उपलब्ध ट्रांसक्रिप्ट, समर्थित मीडिया, Notes और रिमाइंडर भी देता है। पहुँच खाते के कनेक्शन, सहेजे डेटा और अनुमतियों पर निर्भर है।

Telepath को n8n से जोड़ें

n8n-nodes-telepath पैकेज में चैट, संदेश, मीडिया, चैनल, Notes और रिमाइंडर ऑपरेशन तथा Telepath OAuth2 API credential है।

  1. अपने होस्ट किए n8n में Settings → Community Nodes खोलकर n8n-nodes-telepath इंस्टॉल करें।
  2. Telepath नोड जोड़कर Telepath OAuth2 API credential बनाएँ। OAuth dynamic client registration समर्थित नया n8n संस्करण लें।
  3. Connect my account चुनकर Telegram साइन-इन पूरा करें। credential रजिस्ट्रेशन और PKCE संभालता है और n8n का token refresh इस्तेमाल करता है।
  4. Telegram संग्रह कनेक्ट होना चाहिए: Chat Automation से निजी चैट साझा करने के लिए डिवाइस सेटअप गाइड देखें। साइन-इन और इतिहास उपलब्ध करना अलग चरण हैं।
  5. ऑटोमेशन जोड़ने से पहले डेटा जाँचने के लिए Chat → List Telegram chats, फिर Read chat messages चलाएँ।

n8n Cloud इस्तेमाल करते हैं? Cloud इंस्टॉलेशन सत्यापन और n8n नोड डायरेक्टरी में उपलब्धता पर निर्भर है। केवल npm रिलीज़ से पैकेज Cloud में नहीं आता। n8n कम्युनिटी नोड इंस्टॉलेशन नियम देखें; इस गाइड की शुरुआत self-hosted तरीके से है।

रिपॉज़िटरी में चैट सूची और सीमित संदेश विंडो को n8n Data Table में लेने के वर्कफ़्लो उदाहरण हैं। शेड्यूल चालू करने से पहले अपना credential और चुनी चैट जाँचें।

Make का क्या?

Make का HTTP ऐप अलग ऐप मॉड्यूल के बिना API कॉल कर सकता है। Telepath के लिए यही रास्ता देखें; यह गाइड Make के मूल Telepath ऐप का वर्णन नहीं करती।

पहले प्रमाणीकरण सेट करें। Telepath को Authorization Code with S256 PKCE, रजिस्टर्ड callback URL और token refresh चाहिए। Make OAuth 2.0 कनेक्शन बताता है, लेकिन सामान्य OAuth विकल्प से अनुकूलता सिद्ध नहीं होती। इस गाइड के लिए पूरा Make साइन-इन और refresh सत्यापित नहीं किया गया।

Make कनेक्शन PKCE मान बना या exchange न कर सके तो संगत OAuth मध्यस्थ या कस्टम इंटीग्रेशन चाहिए। उस पर बनाने से पहले हमसे संपर्क करें। वैध OAuth होने पर नीचे का base URL, आवश्यक JSON बॉडी और Bearer access token लें। क्रेडेंशियल प्लेटफ़ॉर्म कनेक्शन सेटिंग्स में रखें, प्रॉम्प्ट या संदेश में नहीं।

API प्रमाणीकरण और उदाहरण

हर एंडपॉइंट, पैरामीटर, जवाब और त्रुटि के लिए पूरा Telepath REST API संदर्भ देखें। OpenAPI 3.1 विनिर्देश भी डाउनलोड कर सकते हैं।

बेस URL: https://telepath.lemma.company/api/v1

कस्टम क्लाइंट Telepath OAuth मेटाडेटा से authorization, token और registration एंडपॉइंट पा सकते हैं। सटीक redirect URI रजिस्टर करें, S256 PKCE और read के लिए telegram.read, कार्रवाई के लिए telegram.write माँगें। REST में भी OAuth resource https://telepath.lemma.company/mcp है।

OAuth के बाद Authorization: Bearer <access_token> भेजें। Telegram बॉट टोकन, Telepath access token नहीं है। अस्थायी टोकन स्थायी workflow में कॉपी करने के बजाय OAuth refresh से समाप्ति संभालें।

उपलब्ध चैट सूचीबद्ध करें

यह read-only अनुरोध n8n credential जाँच वाला एंडपॉइंट इस्तेमाल करता है। नीचे shell variable आपका अपना वैध access token है।

curl 'https://telepath.lemma.company/api/v1/chats/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

एक चैट पढ़ें

CHAT_ID को अपने संग्रह से मिले ID से बदलें।

curl 'https://telepath.lemma.company/api/v1/chats/CHAT_ID/messages?limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

अधिकृत जवाब भेजें

वैध टोकन, chat ID और अनुमतियाँ देने पर यह अनुरोध असली संदेश भेजता है। पहले लक्ष्य और टेक्स्ट जाँचें।

curl 'https://telepath.lemma.company/api/v1/chats/CHAT_ID/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Thanks for your message. I will get back to you shortly."}'

निजी Telegram Business चैट में reply अनुमति और पिछले 24 घंटे में उसी चैट का आने वाला संदेश चाहिए। चैनल पोस्टिंग के लिए अलग ऑपरेशन और अनुमतियाँ हैं।

छोटे शेड्यूल किए वर्कफ़्लो से शुरू करें

  1. शुरुआत में हर पाँच मिनट का शेड्यूल चलाएँ।
  2. चुनी चैट की सीमित संदेश विंडो पढ़ें।
  3. आने वाले संदेश फ़िल्टर करें और स्थायी संग्रह में chat ID + message ID से डुप्लिकेट हटाएँ।
  4. अपने चुने AI प्रदाता से सार या ड्राफ़्ट बनाएँ।
  5. भेजने से पहले जवाब जाँचें और दोहराव रोकने के लिए परिणाम दर्ज करें।

यह polling है, incoming-message webhook नहीं। अभी Telepath इस API से हर नए संदेश का outgoing event नहीं देता। सीमित read तेज़ गतिविधि या डाउनटाइम में संदेश छोड़ सकते हैं। समय-समय का snapshot पूर्ण संग्रह की गारंटी नहीं है।

REST gateway में प्रति खाता प्रति मिनट 120 अनुरोध हैं, credentials और workflow में साझा। Telegram और प्लान सीमाएँ भी लागू हैं। 429 और Retry-After मानें। send timeout या अनिश्चित त्रुटि हो तो retry से पहले चैट जाँचें: संदेश पहुँच चुका हो सकता है।

ऑटोमेशन से पहले इतिहास उपलब्ध करें

OAuth workflow को Telepath खाते की पहुँच देता है; सारी Telegram बातचीत अपने-आप इंपोर्ट नहीं करता। Chat Automation अनुमत निजी चैट के नए संदेश जुटाता है। पुराने इतिहास के लिए Telepath बॉट को /import भेजें और एक्सपोर्ट निर्देश मानें। ग्रुप और चैनल का अलग सेटअप व अनुमतियाँ हैं।

एक चैट और read-only workflow से शुरू करें। अपेक्षित संदेश दिखने पर अगला चरण जोड़ें। n8n और कस्टम Make इंटीग्रेशन में मदद चाहिए तो बताएँ क्या ऑटोमेट करना चाहते हैं।