वेबहुक मॉड्यूल
संवादों से घटनाएँ प्राप्त करना Hotline जैसा POST-प्रारूप में अनुरोध JSON आगे की प्रक्रिया के लिए एक बाहरी स्क्रिप्ट पर भेजें।
इंस्टॉलेशन बॉट में @hotlinetg_bot कनेक्शन पैरामीटर के माध्यम से @WEBHOOKS@ आप आउटगोइंग प्रोसेसिंग के लिए एक या अधिक पते सेट कर सकते हैं POST-बाहर से अनुरोध Hotline संवादों में घटनाओं के बारे में।
ध्यान दें: इस पृष्ठ में स्वचालित अनुवाद के साथ अंश हैं। यदि आपको यह जानकारी समझने में कठिनाई हो रही है, तो भाषा को अंग्रेजी या रूसी में बदलने का प्रयास करें और अपनी विश्वसनीय वेबसाइट अनुवाद प्रणाली का उपयोग करें।
पक्ष से आने वाले अनुरोध Hotline निर्दिष्ट ईवेंट प्रकारों के साथ निर्दिष्ट पतों में बाद की प्रक्रिया के लिए संबंधित विषय और/या उपयोगकर्ता के बारे में सभी बुनियादी जानकारी होती है, साथ ही फ़ील्ड भी api_key प्रेषक सत्यापन के लिए संबंधित कनेक्शन। यदि आवश्यक हो, तो आप हमारे प्रॉक्सी सर्वर के आईपी पते का उपयोग करके अपनी ओर से अतिरिक्त प्रेषक सत्यापन कॉन्फ़िगर कर सकते हैं।
उदाहरण JSON पैरामीटर कॉन्फ़िगर करने के लिए @WEBHOOKS@:
{
"https://someapiserver.com/webhooks/test-hook1": [
"dialog_created",
"dialog_reopened",
"dialog_closed",
"message_received",
"message_sent",
"message_intercepted"
],
"https://someapiserver.com/webhooks/test-hook2": [
"/mark", "/info",
"/invoice", "/client"
]
}आप हॉटलाइन से दो प्रकार के अनुरोध प्राप्त कर सकते हैं:
सिस्टम ईवेंट - संवादों के खुलने, बंद होने या पुनः खुलने, ऑपरेटरों द्वारा या समानांतर सत्रों से आने वाले या जाने वाले संदेशों की प्राप्ति के बारे में। ये घटनाएँ एनालिटिक्स सिस्टम के लिए या आपके डेटाबेस में अतिरिक्त संदेश संग्रहण (एआई सहायकों सहित) के लिए सुविधाजनक हैं।
कस्टम कमांड - प्रतीक से शुरू होने वाले ऑपरेटरों द्वारा निर्दिष्ट कमांड के उपयोग पर रिपोर्ट / (स्लैश)। मानक सिस्टम कमांड के रूप में मॉनिटर किया जा सकता है (उदाहरण के लिए /mark या /close), साथ ही कोई भी कस्टम कमांड, उदाहरण के लिए /invoice (चालान तैयार करना), /client (ग्राहक के बारे में जानकारी प्राप्त करें user_id в Telegram)। दूसरे प्रकार के इवेंट एक प्रतिक्रिया लौटा सकते हैं, जो विषय में संबंधित संवाद के साथ प्रदर्शित होगी। ये इवेंट कस्टम कमांड लागू करने के लिए सुविधाजनक हैं जो हॉटलाइन की कार्यक्षमता का महत्वपूर्ण रूप से विस्तार कर सकते हैं या ऑपरेटर के काम को तेज़ कर सकते हैं।
सिस्टम ईवेंट - संवादों के खुलने, बंद होने या पुनः खुलने, ऑपरेटरों द्वारा या समानांतर सत्रों से आने वाले या जाने वाले संदेशों की प्राप्ति के बारे में। ये घटनाएँ एनालिटिक्स सिस्टम के लिए या आपके डेटाबेस में अतिरिक्त संदेश संग्रहण (एआई सहायकों सहित) के लिए सुविधाजनक हैं।
कस्टम कमांड - प्रतीक से शुरू होने वाले ऑपरेटरों द्वारा निर्दिष्ट कमांड के उपयोग पर रिपोर्ट / (स्लैश)। मानक सिस्टम कमांड के रूप में मॉनिटर किया जा सकता है (उदाहरण के लिए /mark या /close), साथ ही कोई भी कस्टम कमांड, उदाहरण के लिए /invoice (चालान तैयार करना), /client (ग्राहक के बारे में जानकारी प्राप्त करें user_id в Telegram)। दूसरे प्रकार के इवेंट एक प्रतिक्रिया लौटा सकते हैं, जो विषय में संबंधित संवाद के साथ प्रदर्शित होगी। ये इवेंट कस्टम कमांड लागू करने के लिए सुविधाजनक हैं जो हॉटलाइन की कार्यक्षमता का महत्वपूर्ण रूप से विस्तार कर सकते हैं या ऑपरेटर के काम को तेज़ कर सकते हैं।
वेबहुक केवल सिस्टम के सशुल्क उपयोगकर्ताओं के लिए उपलब्ध हैं।
सशुल्क सदस्यता खरीदने या फ़ंक्शन का परीक्षण करने के लिए कई दिनों के लिए परीक्षण कनेक्ट करने के लिए, कृपया संपर्क करें @hotlinetg_support
प्रकार 1: सिस्टम ईवेंट
सिस्टम ईवेंट मानों के एक निश्चित समूह से परिभाषित होते हैं। सिस्टम ईवेंट संबंधित संवाद विषय पर कोई परिणाम लौटाए बिना भेजे जाते हैं।
वर्तमान में निम्नलिखित प्रकार के कार्यक्रम उपलब्ध हैं: संवाद_निर्मित, संवाद_पुनः खोला गया, संवाद_बंद, message_प्राप्त, message_भेजा, message_अवरोधित.
संवादों में सिस्टम ईवेंट का उपयोग करने के उदाहरण:
- संवाद शुरू होने के बाद उपयोगकर्ता को अतिरिक्त संदेश भेजना (उदाहरण के लिए, समय समाप्त होने के बाद)
- ऑपरेटरों द्वारा उल्लंघन के लिए कीवर्ड या संदेशों के अर्थ द्वारा आने वाले और जाने वाले संदेशों की अतिरिक्त निगरानी
- आने वाले अनुरोधों पर ऑपरेटर की प्रतिक्रिया समय का नियंत्रण
- किसी बाहरी प्रणाली में संवादों और/या ऑपरेटरों पर विश्लेषण के लिए डेटा एकत्र करना
- एआई मॉड्यूल को प्रशिक्षित करने के लिए बाहरी सिस्टम में संदेशों को रिकॉर्ड करना
किसी संवाद को पुनः खोलने के लिए आउटगोइंग अनुरोध का उदाहरण:
{
"event_type": "dialog_reopened",
"timestamp": "2025-10-09 00:24:55",
"instance_id": "13209946874612345",
"data": {
"chat_id": -1002146012345,
"thread_id": 5602541568,
"topic_id": 5343,
"topic_link": "https://t.me/c/2146012345/5343",
"user_id": 5339212345,
"frontend_chat_id": 5339212345,
"frontend_topic_id": null,
"frontend_topic_link": null,
"frontend_user_id": 6406751371,
"chat_type": "private",
"title": "Some User Name",
"department": "default"
},
"api_key": "pQTngMZLh0NmAh"
}भेजे गए संदेश के लिए आउटगोइंग अनुरोध का उदाहरण:
{
"event_type": "message_sent",
"timestamp": "2025-10-09 00:21:57",
"instance_id": "132099468746812345",
"data": {
"backend_chat_id": -1002146012345,
"backend_thread_id": 5602541568,
"backend_message_id": 6171918336,
"sender_user_id": 5339212345,
"frontend_user_id": 640675123,
"frontend_message_id": 3260022784,
"text": "test message",
"content_type": "messageText",
"department": "default",
"backend_reply_message_id": 0
},
"api_key": "pQTngMZLh0NmAh"
}प्रकार 2: कस्टम कमांड
कोई भी कमांड जो प्रतीक से शुरू होता है / (स्लैश) को इसके बारे में घटनाओं और संबंधित संवाद के बारे में जानकारी प्राप्त करने के लिए एक मान के रूप में निर्दिष्ट किया जा सकता है।
आप मौजूदा मानक सिस्टम कमांड (/info, /mark, /close आदि), साथ ही कस्टम वाले, उन कार्यों के तर्क के लिए जिनकी आपकी स्क्रिप्ट जिम्मेदार होगी और यदि आवश्यक हो, तो परिणाम को फॉर्म में विषय पर वापस कर दें JSON या एक पाठ संदेश (प्रारूप में मार्कअप की अनुमति है) Markdown v2).
कस्टम कमांड के साथ वेबहुक का उपयोग करने के उदाहरण:
- मानक आदेश का विस्तार /info उपयोगकर्ता के बारे में अतिरिक्त जानकारी
- एक आदेश के माध्यम से ऑपरेटरों द्वारा संवाद स्थितियों में परिवर्तन लॉग करना /mark
- कमांड द्वारा अनुरोधों को बंद करने की घटनाओं का लॉगिंग /close
- उदाहरण के लिए, अपने स्वयं के आदेश जोड़ना /invoice, /client या कोई अन्य जिसे उस विषय के बारे में जानकारी की आवश्यकता होती है जिस पर बातचीत हो रही है और उपयोगकर्ता या चैट डेटा।
कमांड कॉल अनुरोध का उदाहरण /mark deal सौदा संचालक:
{
"event_type": "/mark",
"timestamp": "2025-10-08 20:41:20",
"instance_id": "132099468746812345",
"data": {
"command_data": "deal",
"chat_id": -1002146012345,
"topic_id": 5,
"topic_link": "https://t.me/c/2146012345/5",
"message_id": 5850,
"reply_message_id": null,
"sender_user_id": 123456,
"user_id": 7890123,
"frontend_chat_id": 7890123,
"frontend_thread_id": null
},
"api_key": "pQTngMZLh0NmAh"
}किसी विषय में कमांड का परिणाम प्रदर्शित करने के लिए, आपके सर्वर की प्रतिक्रिया सादे पाठ में या फॉर्म में होनी चाहिए JSON, जिसका नाम वाला एक नोड है message या error (अन्य नोड्स को नजरअंदाज कर दिया जाएगा).
आपके सर्वर से प्राप्त सफल प्रतिक्रिया का एक उदाहरण इस प्रारूप में है JSON एक संदेश के साथ जो संवाद के साथ विषय में दिखाया जाएगा:
{
"message": "Deal created: http://internal.domain.com/crm/deals/76238",
"status": "ok"
}प्रारूप में त्रुटि पाठ के साथ आपके सर्वर की प्रतिक्रिया का एक उदाहरण JSON, जो संवाद के साथ विषय में दिखाया जाएगा:
{
"error": "User 12345678 not found in our database"
}वेबहुक से संबंधित प्रश्नों के लिए, या सशुल्क सदस्यता या परीक्षण सक्रिय करने के लिए, कृपया सहायता से संपर्क करें। @hotlinetg_support.