التوثيق

ربط Slack باستخدام Webhook وارد

أنشئ Webhook وارد في Slack لإحدى القنوات، وأضِفه إلى AutoPSEO، وأرسل رسالة اختبار، وعالج الأخطاء التي يعيدها Slack عند فشل النشر.

الحساب ← Slack وTeams وWebhooks ← Slack - مساحات العمل المتصلةيتطلب اشتراكًا أو نسخة تجريبيةمدة القراءة 3 دقيقة

ينشر AutoPSEO في Slack عبر Webhooks الواردة. يمنحك Slack عنوان URL يكتب في قناة واحدة، فتلصقه في AutoPSEO لتبدأ التقارير والتنبيهات بالوصول إلى تلك القناة. لا يثبّت AutoPSEO أي شيء في مساحة العمل لديك: فهو لا يستطيع قراءة الرسائل ولا عرض قنواتك ولا النشر في أي مكان لا يشير إليه الـ Webhook. أضِف إدخالًا واحدًا لكل قناة تريد أن تصلها الرسائل.

إنشاء الـ Webhook في Slack

يُصدر Slack الـ Webhooks الواردة عبر تطبيق Slack. اتبع دليل Slack للـ Webhooks الواردة:

أنشئ تطبيق Slack لمساحة العمل لديك، أو افتح تطبيقًا تستخدمه أصلًا للإشعارات. اختر اسمًا يتعرّف عليه فريقك، مثل تقارير SEO.
من إعدادات التطبيق، افتح Incoming Webhooks وفعّل Activate Incoming Webhooks.
انقر Add New Webhook to Workspace، ثم اختر القناة ووافق. إذا كانت القناة خاصة فعليك أن تكون عضوًا فيها أولًا.
انسخ عنوان URL الجديد من Webhook URLs for Your Workspace. يبدأ هذا العنوان بـ https://hooks.slack.com/services/.

كرّر الخطوتين 3 و4 لكل قناة إضافية؛ فالتطبيق الواحد يمكنه أن يضم عدة Webhooks. كما تظل عناوين URL المنشأة بواسطة Webhooks التكاملات المخصصة القديمة في Slack تعمل، مع أن Slack ينصح بنقلها إلى تطبيق.

يتعامل Slack مع عنوان URL على أنه سرّي: فكل من يملكه يستطيع النشر في القناة. الصقه في AutoPSEO، ولا تضعه في التذاكر أو صفحات الويكي أو لقطات الشاشة.

إضافته إلى AutoPSEO

في صفحة Slack, Teams & Webhooks، ابحث عن Slack - Connected workspaces وانقر Add to Slack. يُفتح نموذج New channel وقد اختير Slack فيه وجهةً مسبقًا.
Name: تسمية تظهر في قوائم AutoPSEO وسجل التسليم ورسالة الاختبار، مثل #seo-alerts.
Webhook URL: الصق عنوان URL الخاص بـ Slack. لا يقبل AutoPSEO في إدخال Slack إلا عناوين https على النطاق slack.com، وينبّهك فورًا إذا كان العنوان غير مطابق.
انقر Add channel، ثم Send test في الصف الجديد. ينبغي أن تظهر في Slack خلال ثوانٍ رسالة قصيرة تذكر اسم الإدخال، ويعرض AutoPSEO المدة التي استغرقها Slack للرد.

يُخزَّن عنوان URL مشفرًا (AES-GCM). وبعد ذلك تعرض القائمة المضيف وآخر الأحرف فقط، فاختر أسماء توضح أي قناة في Slack يغذّيها كل إدخال.

والخطوة التالية أن تمنحه ما ينشره: تقريرًا مجدولًا أو تنبيهًا. عندها يعرض جدول Slack - Subscriptions أسفل القائمة، لكل قناة في Slack، كل قاعدة تنشر فيها وجدولها وما إذا كانت نشطة أم متوقفة مؤقتًا.

عدة قنوات ومساحات عمل

ينتمي عنوان Webhook URL إلى قناة واحدة في مساحة عمل واحدة، ولا يتيح Slack للرسالة تجاوز القناة التي أُنشئ الـ Webhook من أجلها. وهذا يجعل السلوك متوقعًا:

قناة Slack واحدة، إدخال واحد. لفصل العملاء بين #client-a و#client-b، أنشئ Webhook لكل منهما وأضِفهما معًا.
تعمل مساحات العمل المتعددة بالطريقة نفسها، لأن كل Webhook يتبع مساحة العمل التي أنشأته فيها.
يمكن لإدخال واحد أن يحمل قواعد كثيرة. أرسل التقرير الأسبوعي وتنبيه انخفاض الزيارات إلى الإدخال نفسه، أو خصّص قناة أنشط للتنبيهات وحدها.

لماذا لم تصل الرسالة

يعرض Send test السبب مباشرة. أما بالنسبة للرسائل المجدولة، فافتح Delivery history الذي يحتفظ برد Slack على كل محاولة فاشلة.

ما يعرضه AutoPSEO	معناه	ما يجب فعله
Slack rejected the URL (no_service)	حُذف الـ Webhook أو عُطّل في Slack، أو أن عنوان 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، لذا افعل ذلك أيضًا إذا احتمل أن يكون آخرون قد اطلعوا على العنوان.