दस्तावेज़ीकरण
Microsoft Teams अलर्ट और रिपोर्ट
Teams चैनल में Workflows webhook बनाएँ, उसे AutoPSEO में जोड़ें, और गंभीरता के अनुसार रंगे Adaptive Cards के रूप में अलर्ट और शेड्यूल की गई रिपोर्ट पाएँ।
AutoPSEO, Workflows webhook के ज़रिए Microsoft Teams में संदेश भेजता है। Teams आपको एक URL देता है जो किसी एक चैनल में पोस्ट करता है, और आप उस URL को AutoPSEO में Teams चैनल के रूप में जोड़ते हैं। इसके बाद अलर्ट, शेड्यूल की गई रिपोर्ट, टेस्ट संदेश और एक बार की रिपोर्ट के सारांश Adaptive Cards के रूप में आते हैं, जिनका शीर्षक गंभीरता के अनुसार रंगा होता है और जिनमें रिपोर्ट तक वापस ले जाने वाला बटन होता है। इसके लिए आपको Slack वर्कस्पेस की ज़रूरत नहीं है, और Teams में AutoPSEO का कोई ऐप इंस्टॉल नहीं करना पड़ता।
Teams से webhook URL प्राप्त करें
Microsoft की incoming webhook गाइड Workflows ऐप से URL बनाने का तरीका बताती है:
- Teams में उस चैनल पर जाएँ जहाँ कार्ड आने चाहिए और उसके पास More options (...) चुनें।
- Workflows चुनें और कोई webhook टेम्पलेट चुनें। Microsoft फ़िलहाल इसे Send webhook alerts to a channel कहता है; AutoPSEO की सेटिंग पेज पर दिया गया संकेत अब भी पुराना नाम इस्तेमाल करता है, Post to a channel when a webhook request is received।
- जाँच लें कि टेम्पलेट ने कौन-सी टीम और कौन-सा चैनल भरा है, फिर Save पर क्लिक करें।
- वर्कफ़्लो जो webhook लिंक दिखाता है, उसे कॉपी करें।
पुराने Incoming Webhook कनेक्टर का URL (webhook.office.com पर) अब भी स्वीकार किया जाता है। Microsoft, Microsoft 365 Connectors को बंद कर रहा है और नए कनेक्टर बनाने से रोक देगा, इसलिए अभी जो भी सेट अप करें, उसके लिए Workflows का उपयोग करें।
AutoPSEO में चैनल जोड़ें
- Slack, Teams & Webhooks के Microsoft Teams सेक्शन में New Teams channel पर क्लिक करें। फ़ॉर्म गंतव्य के रूप में Microsoft Teams के साथ खुलता है।
- कोई ऐसा Name दें जिसे आप पहचान सकें और URL पेस्ट करें। Teams एंट्री के लिए AutoPSEO Workflows और कनेक्टर पते (जैसे
logic.azure.com,powerautomate.com,azure-api.netऔरwebhook.office.comजैसे होस्ट) स्वीकार करता है और बाकी होस्ट अस्वीकार कर देता है। - Add channel पर क्लिक करें, फिर उसकी पंक्ति में Send test दबाएँ। चैनल में एंट्री के नाम वाले शीर्षक का एक कार्ड दिखना चाहिए।
- शेड्यूल की गई रिपोर्ट या अलर्ट बनाएँ और यही चैनल चुनें।
एक नियम केवल एक चैनल पर भेजता है। यदि एक ही अलर्ट Slack और Teams दोनों में चाहिए, तो नियम दो बार बनाएँ, हर एक के लिए एक।
कार्ड का लेआउट
हर संदेश एक Adaptive Card (संस्करण 1.4, पूरी चौड़ाई) बन जाता है, जो message envelope में लिपटा होता है और उसमें application/vnd.microsoft.card.adaptive अटैचमेंट होता है, जैसा Microsoft के अपने उदाहरणों में है।
- शीर्षक बड़े बोल्ड अक्षरों में। अलर्ट में critical और high के लिए कार्ड का Attention रंग, medium के लिए Warning और low के लिए डिफ़ॉल्ट रंग लगता है; रिपोर्ट और टेस्ट Accent रंग इस्तेमाल करते हैं।
- सारांश: वही वाक्य जो Slack संदेश में होता है, तारीख की अवधि के साथ।
- तथ्य: 12 तक लेबल वाले मान, जैसे क्लिक और उनमें बदलाव, या किसी अलर्ट का मौजूदा मान और उसकी आधार रेखा।
- तालिका: रिपोर्ट और रिपोर्ट सारांश के लिए, स्थिर-चौड़ाई वाले फ़ॉन्ट में दस पंक्तियों तक।
- फ़ुटर: प्रॉपर्टी, यह याद दिलाने वाली बात कि Search Console का डेटा लगभग एक दिन पीछे रहता है और केवल पूरे हो चुके दिन गिने जाते हैं, और भेजने वाला।
- Open report: AutoPSEO में संबंधित रिपोर्ट तक ले जाने वाला बटन।
कार्ड क्यों नहीं पहुँचा
Send test विफलता तुरंत बता देता है; शेड्यूल किए गए संदेशों के लिए Delivery history में Teams का दिया हुआ जवाब सुरक्षित रहता है।
| आप क्या देखते हैं | संभावित कारण | समाधान |
|---|---|---|
| सेव करते समय "That does not look like a Teams Workflows or Incoming Webhook URL" | URL किसी Workflows या कनेक्टर होस्ट पर नहीं है | वर्कफ़्लो से लिंक दोबारा कॉपी करें |
| Send test पर HTTP 400 | असल में यह Teams webhook नहीं है: Slack URL, Zapier hook या ऐसा वर्कफ़्लो जिसे बदलकर किसी दूसरी बॉडी की अपेक्षा पर सेट किया गया है | टेम्पलेट से नया वर्कफ़्लो बनाएँ और उसका URL जोड़ें |
| 10 सेकंड बाद टाइमआउट | Teams ने समय पर जवाब नहीं दिया | कुछ देर बाद फिर कोशिश करें |
| रीडायरेक्ट फ़ॉलो नहीं किए जाते | URL कहीं और फ़ॉरवर्ड करता है | इसके बजाय अंतिम URL जोड़ें |
| किसी सहकर्मी के जाने के बाद कार्ड आना बंद हो गए | Microsoft हर वर्कफ़्लो को उसके मालिकों से जोड़ता है, और बिना मालिक का वर्कफ़्लो रुक सकता है | वर्कफ़्लो में सह-मालिक जोड़ें, या उसे दोबारा बनाएँ |
विफल हुई शेड्यूल रिपोर्ट उसी अवधि में दोबारा नहीं भेजी जाती: कारण ठीक करें और Send now का उपयोग करें।
webhook कब इस्तेमाल करें
Teams और आउटबाउंड webhooks एक ही नियमों को आगे भेज सकते हैं, लेकिन उनके पाठक अलग हैं। Teams चैनल लोगों के लिए है: फ़ॉर्मैट किया हुआ कार्ड, और कुछ बनाने की ज़रूरत नहीं। webhook सॉफ़्टवेयर के लिए है: Zapier, Make, n8n या आपकी अपनी सेवा के लिए हस्ताक्षरित JSON के रूप में कच्चा इवेंट। Teams को AutoPSEO के इवेंट JSON के बजाय कार्ड चाहिए, इसलिए Teams URL हमेशा Microsoft Teams के अंतर्गत ही जोड़ा जाना चाहिए।
Teams उपयोगकर्ताओं को क्या मिलता है, इसका अवलोकन Microsoft Teams पेज पर है।