दस्तावेज़ीकरण

Slack को incoming webhook से कनेक्ट करना

किसी चैनल के लिए Slack incoming webhook बनाएँ, उसे AutoPSEO में जोड़ें, टेस्ट मैसेज भेजें, और पोस्ट विफल होने पर Slack जो त्रुटियाँ लौटाता है उन्हें ठीक करें।

खाता → Slack, Teams और Webhooks → Slack - कनेक्टेड वर्कस्पेससदस्यता या ट्रायल आवश्यक4 मिनट में पढ़ें

AutoPSEO, Slack में incoming webhooks के ज़रिए पोस्ट करता है। Slack आपको एक URL देता है जो किसी एक चैनल में लिखता है, आप उस URL को AutoPSEO में पेस्ट करते हैं, और रिपोर्ट व अलर्ट वहाँ आने लगते हैं। AutoPSEO आपके वर्कस्पेस में कुछ भी इंस्टॉल नहीं करता: वह संदेश नहीं पढ़ सकता, आपके चैनलों की सूची नहीं देख सकता और webhook जहाँ इंगित नहीं करता वहाँ कुछ भी पोस्ट नहीं कर सकता। जिस भी चैनल में आप संदेश चाहते हैं, उसके लिए एक अलग एंट्री जोड़ें।

Slack में webhook बनाएँ

Slack incoming webhooks को एक Slack app के ज़रिए जारी करता है। Slack की incoming webhook गाइड के अनुसार:

अपने वर्कस्पेस के लिए एक Slack app बनाएँ, या कोई ऐसा app खोलें जिसे आप पहले से सूचनाओं के लिए इस्तेमाल करते हैं। ऐसा नाम चुनें जिसे आपकी टीम पहचान सके, जैसे SEO reports।
app की सेटिंग्स में Incoming Webhooks खोलें और Activate Incoming Webhooks चालू करें।
Add New Webhook to Workspace पर क्लिक करें, चैनल चुनें और अनुमति दें। निजी चैनल के लिए पहले आपका उसका सदस्य होना ज़रूरी है।
Webhook URLs for Your Workspace से नया URL कॉपी करें। यह https://hooks.slack.com/services/ से शुरू होता है।

हर अतिरिक्त चैनल के लिए चरण 3 और 4 दोहराएँ; एक app में कई webhooks हो सकते हैं। Slack के पुराने custom-integration webhooks से बना URL भी अब तक काम करता है, हालाँकि Slack उन्हें app पर ले जाने की सलाह देता है।

Slack इस URL को गोपनीय मानता है: जिसके पास भी यह है, वह चैनल में पोस्ट कर सकता है। इसे AutoPSEO में पेस्ट करें और टिकटों, विकी और स्क्रीनशॉट में न रखें।

AutoPSEO में जोड़ें

Slack, Teams & Webhooks पर Slack - Connected workspaces खोजें और Add to Slack पर क्लिक करें। New channel फ़ॉर्म खुलता है, जिसमें गंतव्य के रूप में Slack पहले से चुना होता है।
Name: AutoPSEO की सूचियों, डिलीवरी इतिहास और टेस्ट मैसेज के लिए एक लेबल, जैसे #seo-alerts।
Webhook URL: Slack का URL पेस्ट करें। Slack एंट्री के लिए AutoPSEO केवल slack.com पर मौजूद https पते स्वीकार करता है, और URL मेल न खाए तो तुरंत बता देता है।
Add channel पर क्लिक करें, फिर नई पंक्ति पर Send test दबाएँ। कुछ ही सेकंड में Slack में उस एंट्री का नाम बताने वाला एक छोटा संदेश दिखना चाहिए, और AutoPSEO बताता है कि Slack ने जवाब देने में कितना समय लिया।

URL एन्क्रिप्टेड (AES-GCM) रूप में सहेजा जाता है। इसके बाद सूची में केवल उसका होस्ट और आख़िरी कुछ अक्षर दिखते हैं, इसलिए ऐसे नाम चुनें जिनसे साफ़ पता चले कि हर एंट्री किस Slack चैनल को भेजती है।

अगला कदम: इसे पोस्ट करने के लिए कुछ दें, जैसे शेड्यूल की गई रिपोर्ट या अलर्ट। सूची के नीचे मौजूद Slack - Subscriptions तालिका फिर हर Slack चैनल के लिए दिखाती है कि वहाँ कौन-से नियम पोस्ट कर रहे हैं, उनका शेड्यूल क्या है और वे सक्रिय हैं या रुके हुए।

कई चैनल और वर्कस्पेस

एक webhook URL एक वर्कस्पेस के एक चैनल का होता है, और Slack किसी संदेश को उस चैनल से बदलने नहीं देता जिसके लिए URL बनाया गया था। इससे व्यवहार पूर्वानुमेय रहता है:

एक Slack चैनल, एक एंट्री। क्लाइंट्स को #client-a और #client-b में बाँटना हो तो हर एक के लिए webhook बनाएँ और दोनों जोड़ें।
कई वर्कस्पेस भी इसी तरह काम करते हैं, क्योंकि हर webhook उसी वर्कस्पेस में रहता है जिसमें आपने उसे बनाया था।
एक एंट्री कई नियम संभाल सकती है। साप्ताहिक रिपोर्ट और ट्रैफ़िक गिरावट का अलर्ट एक ही एंट्री को भेजें, या अलर्ट के लिए किसी अधिक व्यस्त चैनल को अलग रखें।

संदेश क्यों नहीं पहुँचा

Send test कारण तुरंत दिखा देता है। शेड्यूल किए गए संदेशों के लिए Delivery history खोलें, जिसमें हर विफल प्रयास पर Slack का जवाब सुरक्षित रहता है।

AutoPSEO क्या दिखाता है	इसका मतलब	क्या करें
Slack rejected the URL (no_service)	Slack में webhook हटा दिया गया या अक्षम कर दिया गया है, या URL में टाइपिंग की गलती है	नया webhook बनाएँ, उसे जोड़ें, फिर पुरानी एंट्री हटाएँ
The Slack channel no longer exists, or is archived	Slack ने `channel_not_found` या `channel_is_archived` लौटाया	ऐसे चैनल के लिए webhook बनाएँ जो अब भी उपयोग में है
Slack is rate limiting us	Slack ने HTTP 429 लौटाया	थोड़ी देर रुकें, फिर Send now या Test rule इस्तेमाल करें
Timed out after 10 seconds	Slack ने समय पर जवाब नहीं दिया	कुछ देर बाद फिर कोशिश करें
Your trial has ended	कोई सक्रिय प्लान या ट्रायल नहीं है	कोई प्लान चुनें; शेड्यूल की गई डिलीवरी उसके साथ फिर शुरू हो जाती हैं

विफल हुई शेड्यूल रिपोर्ट उसी अवधि में दोबारा नहीं भेजी जाती, इसलिए कारण ठीक होने पर Send now इस्तेमाल करें। जो अलर्ट पोस्ट नहीं हो सका, उसका मूल्यांकन अगली जाँच में फिर होता है (अलर्ट कब चलते हैं)।

Slack चैनल हटाना

एंट्री की पंक्ति पर Delete सहेजा गया URL हटा देता है, और पुष्टि के बाद, जिसमें संख्या बताई जाती है, वहाँ पोस्ट करने वाले हर नियम को भी हटा देता है। AutoPSEO, Slack में कुछ भी नहीं बदलता: webhook तब तक काम करता रहता है जब तक कोई उसे Slack app में हटा न दे, इसलिए यदि URL दूसरों ने देखा हो सकता है तो वह भी करें।