वेबहुक आपका एक URL है जिस पर हम POST करते हैं जब किसी जुड़े खाते पर कुछ होता है — कोई संदेश आता है, कोई संपर्क जुड़ता है, किसी खाते को ध्यान चाहिए। यह बार-बार पूछने की जगह लेता है, और सीमा वाली API में यह शैली की पसंद नहीं बल्कि चलने और न चलने का फ़र्क़ है।
हस्ताक्षर जाँचिए। हर बार।
आपका एंडपॉइंट खुले इंटरनेट पर है, और जो भी उस तक पहुँच सके वह वहाँ जो चाहे भेज सकता है। हर डिलीवरी एक हस्ताक्षर लाती है, जो उस गुप्त कुंजी से बनता है जो सिर्फ़ आपके और हमारे पास है; बॉडी पढ़ने से पहले उसे जाँचिए, और स्थिर समय में मिलाइए, न कि ऐसी स्ट्रिंग तुलना से जो पहले फ़र्क़ पर ही लौट आती है।
एक ही घटना दो बार आने की उम्मीद रखिए
डिलीवरी कम-से-कम एक बार होती है। अगर आपका एंडपॉइंट धीमा है, 500 लौटाता है, या सिर्फ़ वैसा लगता है, तो वही घटना दोबारा आती है। यह बताने लायक खराबी नहीं; यही अनुबंध है। हैंडलर को इडेम्पोटेंट बना दीजिए और समस्या गायब।
200 जल्दी लौटाइए और काम बाद में कीजिए। जो हैंडलर जवाब देने से पहले दस सेकंड दूसरी API बुलाता है, वह ऐसा हैंडलर है जिसे काम करते-करते ही दोबारा बुला लिया जाएगा।
अक्सर पूछे जाने वाले सवाल
मेरे सहायक के पास सर्वर नहीं है। क्या वह वेबहुक पा सकता है?
हाँ, AI इनबॉक्स के ज़रिए: एक वेबहुक जिसे हम कहीं भेजने के बजाय आपके AI के लिए रख लेते हैं। वह आपके जुड़े हुए खातों की हर घटना को 30 दिन तक रखता है, और कोई सहायक, या MakeHybrid पर टिक वाला रूम का एजेंट, पूछे जाने पर उसे पढ़ता है।
क्या कोई वेबहुक प्रोजेक्ट रूम में AI एजेंट को शुरू कर सकता है?
सीधे नहीं, क्योंकि रूम संदेशों का जवाब देते हैं। आपका वेबहुक हैंडलर बाहरी AI एजेंट के रूप में किसी रूम से जुड़ सकता है और घटना वहाँ पोस्ट कर सकता है, और जिस एजेंट को उस पर काम करना है उसे @mention कर सकता है।