دستاویزات
Slack کو incoming webhook کے ذریعے جوڑنا
کسی چینل کے لیے Slack incoming webhook بنائیں، اسے AutoPSEO میں شامل کریں، ٹیسٹ پیغام بھیجیں، اور پوسٹ ناکام ہونے پر Slack کی طرف سے آنے والی غلطیاں دور کریں۔
AutoPSEO، Slack پر incoming webhooks کے ذریعے پوسٹ کرتا ہے۔ Slack آپ کو ایک URL دیتا ہے جو کسی ایک چینل میں لکھتا ہے، آپ وہ URL AutoPSEO میں پیسٹ کرتے ہیں، اور رپورٹس اور الرٹس وہاں آنا شروع ہو جاتے ہیں۔ AutoPSEO آپ کے ورک اسپیس میں خود کچھ انسٹال نہیں کرتا: وہ پیغامات پڑھ نہیں سکتا، آپ کے چینلز کی فہرست نہیں دیکھ سکتا اور ایسی کسی جگہ پوسٹ نہیں کر سکتا جس کی طرف webhook اشارہ نہ کرے۔ جتنے چینلز میں پیغامات چاہیے ہوں، ہر ایک کے لیے ایک الگ اندراج شامل کریں۔
Slack میں webhook بنائیں
Slack، incoming webhooks ایک Slack app کے ذریعے جاری کرتا ہے۔ Slack کی incoming webhook گائیڈ کے مطابق:
- اپنے ورک اسپیس کے لیے ایک Slack app بنائیں، یا نوٹیفکیشنز کے لیے پہلے سے استعمال ہونے والی app کھولیں۔ ایسا نام رکھیں جسے آپ کی ٹیم آسانی سے پہچان لے، جیسے SEO رپورٹس۔
- 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 میں پیسٹ کریں، اور ٹکٹس، wikis اور اسکرین شاٹس میں ظاہر نہ ہونے دیں۔
اسے 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) کے ساتھ محفوظ کیا جاتا ہے۔ اس کے بعد فہرست میں صرف اس کا host اور آخری حروف دکھائے جاتے ہیں، اس لیے ایسے نام رکھیں جن سے واضح ہو کہ ہر اندراج کس Slack چینل کو پیغامات بھیجتا ہے۔
اگلے مرحلے میں اسے پوسٹ کرنے کے لیے کچھ دیں: ایک شیڈول شدہ رپورٹ یا ایک الرٹ۔ فہرست کے نیچے موجود Slack - Subscriptions ٹیبل پھر ہر Slack چینل کے لیے وہاں پوسٹ کرنے والے تمام اصول، ان کا شیڈول، اور یہ دکھاتا ہے کہ وہ فعال ہیں یا موقوف۔
متعدد چینلز اور ورک اسپیسز
ایک webhook URL ایک ورک اسپیس کے ایک چینل کا ہوتا ہے، اور Slack کسی پیغام کو اس چینل سے ہٹ کر بھیجنے کی اجازت نہیں دیتا جس کے لیے وہ بنایا گیا تھا۔ اس سے نتائج قابلِ پیش گوئی رہتے ہیں:
- ایک Slack چینل، ایک اندراج۔ کلائنٹس کو
#client-aاور#client-bمیں تقسیم کرنا ہو تو ہر ایک کے لیے webhook بنائیں اور دونوں شامل کریں۔ - متعدد ورک اسپیسز بھی اسی طرح کام کرتے ہیں، کیونکہ ہر webhook اسی ورک اسپیس میں رہتا ہے جہاں آپ نے اسے بنایا۔
- ایک اندراج پر کئی اصول لگ سکتے ہیں۔ ہفتہ وار رپورٹ اور ٹریفک گرنے کا الرٹ ایک ہی اندراج پر بھیجیں، یا الرٹس کے لیے زیادہ مصروف چینل الگ رکھیں۔
پیغام کیوں نہیں پہنچا
Send test وجہ فوراً دکھا دیتا ہے۔ شیڈول شدہ پیغامات کے لیے Delivery history کھولیں، جو ہر ناکام کوشش پر Slack کا جواب محفوظ رکھتی ہے۔
| AutoPSEO کیا دکھاتا ہے | اس کا مطلب | کیا کریں |
|---|---|---|
| Slack نے URL مسترد کر دیا (no_service) | webhook Slack میں ہٹا دیا گیا یا غیر فعال کر دیا گیا ہے، یا URL غلط لکھا گیا ہے | نیا webhook بنائیں، اسے شامل کریں، پھر پرانا اندراج حذف کر دیں |
| Slack چینل اب موجود نہیں، یا آرکائیو ہو چکا ہے | Slack نے channel_not_found یا channel_is_archived کا جواب دیا | ایسے چینل کے لیے webhook بنائیں جو ابھی استعمال میں ہو |
| Slack ہماری درخواستوں کی شرح محدود کر رہا ہے | Slack نے HTTP 429 کا جواب دیا | تھوڑی دیر انتظار کریں، پھر Send now یا Test rule استعمال کریں |
| 10 سیکنڈ بعد وقت ختم ہو گیا | Slack نے مقررہ وقت میں جواب نہیں دیا | کچھ دیر بعد دوبارہ کوشش کریں |
| آپ کا ٹرائل ختم ہو چکا ہے | کوئی فعال پلان یا ٹرائل نہیں ہے | کوئی پلان منتخب کریں؛ شیڈول شدہ ڈلیوریز اس کے ساتھ دوبارہ شروع ہو جائیں گی |
ناکام ہونے والی شیڈول شدہ رپورٹ اسی مدت میں دوبارہ نہیں بھیجی جاتی، اس لیے وجہ دور ہونے کے بعد Send now استعمال کریں۔ جو الرٹ پوسٹ نہ ہو سکا، وہ اپنی اگلی جانچ پر دوبارہ پرکھا جاتا ہے (الرٹس کب چلتے ہیں)۔
Slack چینل ہٹانا
اندراج کی قطار پر Delete محفوظ شدہ URL ہٹا دیتا ہے، اور تصدیق کے بعد، جس میں تعداد بھی بتائی جاتی ہے، وہاں پوسٹ کرنے والے تمام اصول بھی ہٹا دیتا ہے۔ AutoPSEO، Slack میں کچھ نہیں بدلتا: webhook اس وقت تک کام کرتا رہتا ہے جب تک کوئی اسے Slack app میں ہٹا نہ دے، اس لیے اگر URL دوسروں کی نظر میں آ چکا ہو تو وہاں سے بھی اسے ہٹا دیں۔