इस पेज में बताया गया है कि एसिंक्रोनस मैसेज को वेबहुक कैसे सेट अप करके बाहरी ट्रिगर का इस्तेमाल करके चैट स्पेस. उदाहरण के लिए, आपके पास ऑन-कॉल कर्मियों को सूचित करने के लिए मॉनिटरिंग ऐप्लिकेशन कॉन्फ़िगर करें सर्वर बंद होने पर चैट करें. सिंक्रोनस मैसेज भेजने के लिए चैट ऐप्लिकेशन के साथ, देखें मैसेज भेजें.
इस तरह के आर्किटेक्चर के साथ डिज़ाइन के आधार पर, उपयोगकर्ता वेबहुक या कनेक्ट किए गए बाहरी डोमेन से इंटरैक्ट नहीं कर सकते क्योंकि संचार एकतरफ़ा है. वेबहुक में बातचीत नहीं की जा सकती. वे उपयोगकर्ताओं का जवाब नहीं दे सकते या उनके मैसेज नहीं पा सकते या Chat ऐप्लिकेशन के इंटरैक्शन वाले इवेंट. मैसेज का जवाब देने के लिए, कोई Chat ऐप्लिकेशन बनाना इस्तेमाल कर सकते हैं.
हालांकि, वेबहुक, तकनीकी रूप से चैट ऐप्लिकेशन—वेबहुक, स्टैंडर्ड टेक्नोलॉजी का इस्तेमाल करके ऐप्लिकेशन को कनेक्ट करते हैं एचटीटीपी अनुरोध—इस पेज का मतलब है कि यह आसान बनाना. हर वेबहुक सिर्फ़ इसी चैट स्पेस में काम करता है यह रजिस्टर किया गया है. इनकमिंग वेबहुक, डायरेक्ट मैसेज में काम करते हैं. हालांकि, ये तभी काम करते हैं, सभी उपयोगकर्ताओं के पास Chat की सुविधा वाले ऐप्लिकेशन चालू कर दिए गए हैं. Google Workspace Marketplace में वेबहुक पब्लिश नहीं किए जा सकते.
नीचे दिया गया डायग्राम, वेबहुक के आर्किटेक्चर को दिखाता है. चैट करें
पिछले डायग्राम में, Chat ऐप्लिकेशन में ये चीज़ें शामिल हैं जानकारी का फ़्लो:
- Chat ऐप्लिकेशन का लॉजिक, इससे जानकारी लेता है तीसरे पक्ष की बाहरी सेवाएं, जैसे कि प्रोजेक्ट मैनेजमेंट सिस्टम या टिकट बेचने वाले टूल पर ध्यान दें.
- Chat ऐप्लिकेशन का लॉजिक, क्लाउड में होस्ट किया जाता है या ऑन-प्रिमाइसेस सिस्टम, जो वेबहुक यूआरएल का इस्तेमाल करके खास चैट स्पेस.
- उपयोगकर्ता, Chat ऐप्लिकेशन में मौजूद मैसेज यहां पा सकते हैं: वह खास चैट स्पेस है, लेकिन उससे इंटरैक्ट नहीं कर पाएगा चैट ऐप्लिकेशन.
ज़रूरी शर्तें
Python
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat. आपके Google Workspace संगठन को उपयोगकर्ताओं को इनकमिंग वेबहुक जोड़ना और उनका इस्तेमाल करना.
- Python 3.6 या इससे नया वर्शन
- पीआईपी पैकेज मैनेजमेंट टूल
httplib2
लाइब्रेरी. लाइब्रेरी इंस्टॉल करने के लिए, अपने कमांड-लाइन इंटरफ़ेस में यहां दिया गया कमांड चलाएं:pip install httplib2
Google Chat पर मौजूद स्पेस. Google Chat API का इस्तेमाल करके मैसेज बॉक्स बनाने के लिए, यह देखें कोई स्पेस बनाएं. Chat में Google खाता बनाने के लिए, तो सहायता केंद्र के दस्तावेज़.
Node.js
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat. आपके Google Workspace संगठन को उपयोगकर्ताओं को इनकमिंग वेबहुक जोड़ना और उनका इस्तेमाल करना.
- Node.js 14 या उसके बाद का वर्शन
- npm पैकेज मैनेजमेंट टूल
- Google Chat पर मौजूद स्पेस. Google Chat API का इस्तेमाल करके मैसेज बॉक्स बनाने के लिए, यह देखें कोई स्पेस बनाएं. Chat में Google खाता बनाने के लिए, तो सहायता केंद्र के दस्तावेज़.
Java
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat. आपके Google Workspace संगठन को उपयोगकर्ताओं को इनकमिंग वेबहुक जोड़ना और उनका इस्तेमाल करना.
- Java 11 या उसके बाद का वर्शन
- Maven पैकेज मैनेजमेंट टूल
- Google Chat पर मौजूद स्पेस. Google Chat API का इस्तेमाल करके मैसेज बॉक्स बनाने के लिए, यह देखें कोई स्पेस बनाएं. Chat में Google खाता बनाने के लिए, तो सहायता केंद्र के दस्तावेज़.
Apps Script
- कारोबार या एंटरप्राइज़ Google Workspace खाता, जिसके पास इसका ऐक्सेस है Google Chat. आपके Google Workspace संगठन को उपयोगकर्ताओं को इनकमिंग वेबहुक जोड़ना और उनका इस्तेमाल करना.
- स्टैंडअलोन Apps Script प्रोजेक्ट बनाना, और बेहतर चैट सेवा चालू करें.
- Google Chat पर मौजूद स्पेस. Google Chat API का इस्तेमाल करके मैसेज बॉक्स बनाने के लिए, यह देखें कोई स्पेस बनाएं. Chat में Google खाता बनाने के लिए, तो सहायता केंद्र के दस्तावेज़.
वेबहुक बनाएं
वेबहुक बनाने के लिए, उसे चैट स्पेस में रजिस्टर करें चुनें, और फिर एक ऐसी स्क्रिप्ट लिखें जो मैसेज भेजे.
इनकमिंग वेबहुक को रजिस्टर करें
- किसी ब्राउज़र में, खोलें चैट. Chat के मोबाइल ऐप्लिकेशन से वेबहुक को कॉन्फ़िगर नहीं किया जा सकता.
- उस स्पेस पर जाएं जहां आपको वेबहुक जोड़ना है.
- स्पेस के नाम के बगल में मौजूद, अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है अन्य ऐरो को बड़ा करें और फिर ऐप्लिकेशन और इंटिग्रेशन के लिए तय किया गया है.
वेबहुक जोड़ें पर क्लिक करें.
नाम फ़ील्ड में,
Quickstart Webhook
डालें.अवतार यूआरएल फ़ील्ड में, डालें
https://developers.google.com/chat/images/chat-product-icon.png
.सेव करें पर क्लिक करें.
वेबहुक यूआरएल को कॉपी करने के लिए,
ज़्यादा और फिर क्लिक करें लिंक कॉपी करें.
वेबहुक स्क्रिप्ट लिखें
उदाहरण के तौर पर दी गई वेबहुक स्क्रिप्ट, उस स्पेस में एक मैसेज भेजती है जिसमें वेबहुक है
वेबहुक यूआरएल पर POST
अनुरोध भेजकर रजिस्टर किया जाएगा. कॉन्टेंट बनाने
Chat API, इस उदाहरण के साथ जवाब देता है:
Message
.
वेबहुक स्क्रिप्ट बनाने का तरीका जानने के लिए, कोई भाषा चुनें:
Python
अपनी वर्किंग डायरेक्ट्री में,
quickstart.py
नाम की फ़ाइल बनाएं.quickstart.py
में, यह कोड चिपकाएं:url
वैरिएबल की वैल्यू को उस वेबहुक यूआरएल से बदलें जो आपने वेबहुक रजिस्टर करते समय कॉपी कर लिया था.
Node.js
अपनी वर्किंग डायरेक्ट्री में,
index.js
नाम की फ़ाइल बनाएं.index.js
में, यह कोड चिपकाएं:url
वैरिएबल की वैल्यू को उस वेबहुक यूआरएल से बदलें जो आपने वेबहुक रजिस्टर करते समय कॉपी कर लिया था.
Java
अपनी वर्किंग डायरेक्ट्री में,
pom.xml
नाम की फ़ाइल बनाएं.pom.xml
में, इन्हें कॉपी करके चिपकाएं:अपनी वर्किंग डायरेक्ट्री में, यह डायरेक्ट्री स्ट्रक्चर बनाएं
src/main/java
.src/main/java
डायरेक्ट्री में,App.java
नाम की फ़ाइल बनाएं.App.java
में, यह कोड चिपकाएं:URL
वैरिएबल की वैल्यू को उस वेबहुक यूआरएल से बदलें वेबहुक रजिस्टर करते समय कॉपी किया गया.
Apps Script
ब्राउज़र में, इस लिंक पर जाएं Apps Script.
नया प्रोजेक्ट पर क्लिक करें
यह कोड चिपकाएं:
url
वैरिएबल की वैल्यू को उस वेबहुक यूआरएल से बदलें वेबहुक रजिस्टर करते समय कॉपी किया गया.
वेबहुक स्क्रिप्ट चलाएं
किसी सीएलआई में, स्क्रिप्ट चलाएं:
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
Apps Script
- चलाएं पर क्लिक करें.
कोड चलाने पर, वेबहुक उस स्पेस को एक मैसेज भेजता है जिसमें ने इसे रजिस्टर कर लिया है.
मैसेज थ्रेड शुरू करें या उसका जवाब दें
बताएं
spaces.messages.thread.threadKey
मैसेज के अनुरोध के मुख्य हिस्से में होता है. इस बात पर निर्भर करते हुए कि आप शुरू कर रहे हैं या किसी थ्रेड का जवाब देते समय,threadKey
के लिए ये वैल्यू इस्तेमाल करें:अगर थ्रेड शुरू कर रहे हैं, तो
threadKey
को किसी आर्बिट्रेरी स्ट्रिंग पर सेट करें, लेकिन थ्रेड का जवाब पोस्ट करने के लिए, इस वैल्यू को नोट कर लें.किसी थ्रेड का जवाब देते समय, वह
threadKey
बताएं जिसे थ्रेड शुरू किया गया. उदाहरण के लिए, उस थ्रेड का जवाब पोस्ट करने के लिए जहां शुरुआती मैसेजMY-THREAD
का इस्तेमाल किया गया,MY-THREAD
सेट करें.
अगर बताया गया
threadKey
नहीं मिलता है, तो थ्रेड के काम करने का तरीका तय करें:थ्रेड का जवाब दें या नई थ्रेड शुरू करें. जोड़ें
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
पैरामीटर के लिए यूआरएल पर क्लिक करें. इस यूआरएल पैरामीटर को पास करने की वजह से Chat दिए गएthreadKey
का इस्तेमाल करके मौजूदा थ्रेड को खोजें. अगर एक मिलता है, तो मैसेज उस थ्रेड के जवाब के तौर पर पोस्ट हो जाता है. अगर कोई नहीं है मिल गया है, तो मैसेज उससे जुड़ा नया थ्रेड शुरू करता हैthreadKey
.किसी थ्रेड का जवाब दें या कुछ न करें. जोड़ें
messageReplyOption=REPLY_MESSAGE_OR_FAIL
पैरामीटर को वेबहुक यूआरएल में जोड़ा गया. इस यूआरएल पैरामीटर को पास करने की वजह से Chat दिए गएthreadKey
का इस्तेमाल करके मौजूदा थ्रेड को खोजें. अगर एक मिलता है, तो मैसेज उस थ्रेड के जवाब के तौर पर पोस्ट हो जाता है. अगर कोई नहीं है मिला है, तो संदेश नहीं भेजा जाता है.
ज़्यादा जानने के लिए,
messageReplyOption
देखें.
नीचे दिया गया कोड सैंपल, किसी मैसेज थ्रेड को शुरू करता है या उस पर जवाब देता है: