Microsoft Teams الرٹس اور رپورٹس

AutoPSEO، Microsoft Teams میں Workflows ویب ہُک کے ذریعے پیغامات بھیجتا ہے۔ Teams آپ کو ایک URL دیتا ہے جو کسی ایک چینل میں پوسٹ کرتا ہے، اور آپ اسی URL کو AutoPSEO میں Teams چینل کے طور پر شامل کر دیتے ہیں۔ اس کے بعد الرٹس، شیڈول شدہ رپورٹس، ٹیسٹ پیغامات اور ایک بار کی رپورٹ کے خلاصے Adaptive Cards کی شکل میں آتے ہیں، جن کے عنوان کا رنگ شدت کے مطابق ہوتا ہے اور ساتھ رپورٹ پر واپس لے جانے والا بٹن بھی ہوتا ہے۔ اس کے لیے Slack ورک اسپیس کی ضرورت نہیں، اور Teams میں AutoPSEO کی کوئی ایپ انسٹال کرنا بھی نہیں پڑتی۔

Teams سے ویب ہُک URL حاصل کریں

Microsoft کی incoming webhook گائیڈ کے مطابق یہ URL Workflows ایپ سے بنتا ہے:

1. Teams میں اس چینل پر جائیں جہاں کارڈز آنے چاہئیں اور اس کے برابر میں More options (...) منتخب کریں۔
2. Workflows منتخب کریں اور ویب ہُک ٹیمپلیٹ چنیں۔ Microsoft اسے فی الحال Send webhook alerts to a channel کہتا ہے؛ سیٹنگز صفحے پر AutoPSEO کی ہدایت میں اب بھی پرانا نام Post to a channel when a webhook request is received درج ہے۔
3. ٹیمپلیٹ نے جو ٹیم اور چینل خود بھر دیے ہیں انہیں جانچ لیں، پھر Save پر کلک کریں۔
4. ورک فلو جو ویب ہُک لنک دکھائے اسے کاپی کر لیں۔

پرانے Incoming Webhook کنیکٹر کا URL (جو webhook.office.com پر ہوتا ہے) اب بھی قبول کیا جاتا ہے۔ Microsoft، Microsoft 365 Connectors ختم کر رہا ہے اور نئے کنیکٹرز بنانے پر پابندی لگا دے گا، اس لیے جو کچھ ابھی نیا سیٹ اپ کر رہے ہیں اس کے لیے Workflows استعمال کریں۔

AutoPSEO میں چینل شامل کریں

1. Slack, Teams & Webhooks کے Microsoft Teams سیکشن میں New Teams channel پر کلک کریں۔ فارم میں منزل کے طور پر Microsoft Teams پہلے سے منتخب ہوتا ہے۔
2. ایسا Name درج کریں جسے آپ آسانی سے پہچان سکیں اور URL پیسٹ کریں۔ Teams اندراج کے لیے AutoPSEO صرف Workflows اور کنیکٹر کے پتے قبول کرتا ہے (ہوسٹس جیسے logic.azure.com، powerautomate.com، azure-api.net اور webhook.office.com)، باقی ہوسٹس مسترد کر دیے جاتے ہیں۔
3. Add channel پر کلک کریں، پھر اسی قطار میں Send test دبائیں۔ چینل میں اس اندراج کے نام والا کارڈ نظر آنا چاہیے۔
4. شیڈول شدہ رپورٹ یا الرٹ بنائیں اور یہی چینل منتخب کریں۔

ایک رول صرف ایک چینل کو بھیجتا ہے۔ اگر ایک ہی الرٹ Slack اور Teams دونوں میں چاہیے تو رول دو بار بنائیں، ہر ایک کے لیے ایک۔

کارڈ کی ترتیب

ہر پیغام ایک Adaptive Card بن جاتا ہے (ورژن 1.4، پوری چوڑائی)، جو message لفافے میں لپٹا ہوتا ہے اور اس کے ساتھ application/vnd.microsoft.card.adaptive اٹیچمنٹ ہوتی ہے، جیسا کہ Microsoft کی اپنی مثالوں میں ہے۔

• عنوان بڑے اور گہرے (بولڈ) حروف میں۔ الرٹس میں critical اور high کے لیے کارڈ کا Attention رنگ، medium کے لیے Warning اور low کے لیے ڈیفالٹ رنگ استعمال ہوتا ہے؛ رپورٹس اور ٹیسٹ Accent رنگ استعمال کرتے ہیں۔
• خلاصہ: وہی جملہ جو Slack پیغام میں ہوتا ہے، تاریخوں کی مدت کے ساتھ۔
• حقائق: زیادہ سے زیادہ 12 لیبل والی قدریں، مثلاً کلکس اور ان میں تبدیلی، یا الرٹ کی موجودہ قدر اور اس کی بنیادی سطح (baseline) کا موازنہ۔
• جدول: رپورٹس اور رپورٹ کے خلاصوں کے لیے، زیادہ سے زیادہ دس قطاریں، یکساں چوڑائی والے فونٹ میں۔
• فوٹر: پراپرٹی، اس بات کی یاد دہانی کہ Search Console کا ڈیٹا تقریباً ایک دن کی تاخیر سے آتا ہے اور صرف مکمل ہو چکے دن شمار ہوتے ہیں، اور بھیجنے والا۔
• Open report: AutoPSEO میں متعلقہ رپورٹ تک لے جانے والا بٹن۔

کارڈ کیوں نہیں پہنچا

Send test ناکامی کی اطلاع فوراً دیتا ہے؛ شیڈول شدہ پیغامات کے لیے Delivery history میں Teams کا دیا ہوا جواب محفوظ رہتا ہے۔

ناکام ہونے والی شیڈول شدہ رپورٹ اسی مدت میں دوبارہ نہیں بھیجی جاتی: وجہ دور کریں اور Send now استعمال کریں۔

ویب ہُک کب استعمال کریں

Teams اور آؤٹ باؤنڈ ویب ہُکس ایک ہی رولز کو سنبھال سکتے ہیں، لیکن ان کے قارئین مختلف ہوتے ہیں۔ Teams چینل لوگوں کے لیے ہے: فارمیٹ شدہ کارڈ، اور کچھ بنانے کی ضرورت نہیں۔ ویب ہُک سافٹ ویئر کے لیے ہے: Zapier، Make، n8n یا آپ کی اپنی سروس کے لیے دستخط شدہ JSON کی صورت میں خام ایونٹ۔ Teams کو AutoPSEO کے ایونٹ JSON کی بجائے کارڈ درکار ہوتا ہے، اس لیے Teams کا URL ہمیشہ Microsoft Teams کے تحت ہی شامل ہونا چاہیے۔

Teams صارفین کو کیا کچھ ملتا ہے، اس کا جائزہ Microsoft Teams صفحے پر موجود ہے۔