تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

القنوات: سلاك وتيليجرام وTeams وWebhook

القنوات توصل فريقك كله، في المكان اللي هم أصلاً شغّالين فيه. تفضيلات البريد والجرس شي شخصي لكل مستخدم، أمّا القناة فهي وجهة مشتركة: قناة سلاك، أو محادثة تيليجرام، أو قناة Microsoft Teams، أو webhook خاص فيك. و‏uMarker تنشر نشاط المشروع هناك أول بأول، بلا ما يحتاج أحد يدخل uMarker عشان يشوفه.

القنوات تضيف على الإشعارات الشخصية ولا تلغيها؛ هي تبثّ نفس الأحداث لمكان يشوفه الفريق كله.

تربط مرّة، وتوجّه لكل مشروع

Section titled “تربط مرّة، وتوجّه لكل مشروع”

uMarker تقسم القناة لشيئين، ويستاهل تفهم القسمة قبل ما تبدأ:

الاتصال: على مستوى الحساب

الاعتماد نفسه: رابط سلاك، رمز بوت تيليجرام والمحادثة اللي اخترتها، نقطتك أنت. يُدخَل مرّة وحدة من صفحة التكاملات بالحساب، وتقدر تعيد استخدامه بأي مكان.

المسار: على مستوى المشروع

أي مشروع يرسل له، ووش الأحداث. يُضاف من تبويب التوزيع داخل المشروع. والاتصال الواحد يخدم أي عدد من المشاريع.

يعني الوكالة تلصق رابط سلاك مرّة وحدة وبعدها ترفقه بعشرة مشاريع عملاء، وكل واحد باختيار أحداث مختلف، بدل ما تعيد لصق نفس الاعتماد لكل مشروع. ويعني كمان إن فصل اعتماد مستخدَم يحذّرك بأسماء المشاريع اللي بتفقد توجيهها — مع حدّ واحد يهمّك لو عندك أكثر من مساحة.

الأنواع الأربعة، ووش تشمل كل باقة

Section titled “الأنواع الأربعة، ووش تشمل كل باقة”
النوع وش ترسل uMarker متاح من
Webhook موقّع عامّ حمولة JSON مُهيكلة وموقّعة المجاني (كل الباقات)
سلاك (incoming webhook) رسالة مقروءة ومعها رابط البداية (99 ⃁)
تيليجرام (بوتك، ينشر بمحادثة تختارها) نفس الرسالة المقروءة البداية (99 ⃁)
Microsoft Teams (webhook عبر Workflows) نفس الرسالة المقروءة احترافي (249 ⃁)

النوع اللي ما تشمله باقتك يظهر بصفحة التكاملات مقفولاً ومعه اسم الباقة اللي تفتحه، وما ينخفي أبداً. وفيه كمان سقف لعدد الاتصالات اللي يمسكها الحساب بنفس الوقت، والقنوات تتشارك هذا السقف مع متتبّعات المهام: واحد على المجاني، وثلاثة على البداية، وعشرة على احترافي، وخمسة وعشرين على الوكالات، محسوبة على مستوى الحساب للنوعين مع بعض. يعني GitHub مربوط ياخذ وحدة منها — وعلى المجاني عندك مكان لمتتبّع أو قناة، مو للاثنين.

المسار يشترك بأي من هذي السبعة:

الحدث متى ينطلق
new_feedback تُرسَل ملاحظة جديدة للمشروع
assigned يُسنَد التقرير لعضو
mentioned يُذكَر عضو بـ@ في تعليق
status_change تتغيّر حالة التقرير
priority تتغيّر أولوية التقرير
resolved يُحلّ التقرير، أو ينحلّ دبوس في نقاشه
issue_linked يُربط التقرير بـتذكرة متتبّع خارجية

ولكل مسار مفتاح تشغيل. أطفئه عشان توقف التسليم بدون ما تحذف التوجيه، وشغّله لمّا تبغى ترجّعه.

من صفحة التكاملات بالحساب، اضغط ربط على بطاقة الأداة. تنفتح لك لوحة موجَّهة، وشكلها واحد لكل الأدوات:

  1. خطوات الربط. خطوات مرقّمة، كل وحدة فيها رابط مباشر يفتح لك الصفحة الصحيحة بالخدمة الثانية، والحقول تعبّيها بنفس الخطوة اللي تطلبها. وما ينطلب منك إلا اللي تحتاجه تلك الخدمة: أي عنوان ثابت تعبّيه uMarker بنفسها، فما تركّب رابط API بيدك أبداً.

  2. الاختبار. اضغط أرسل رسالة اختبار. uMarker ترسل رسالة حقيقية، موسومة بوضوح إنها اختبار، للي قدامك على الشاشة بالضبط. تأكّد إنها وصلت.

  3. الحفظ. زرّ ربط يتفعّل بعد ما ينجح الاختبار. ولو غيّرت أي شي بعد الاختبار، اللوحة تنبّهك وتطلب تختبر مجدداً قبل الحفظ.

ولو الوجهة واقفة الحين وتبغى تحفظها برضو، فيه احفظ دون اختبار ناجح، واسمه يقول وش يسوّي. ورابط سلاك أو Teams أو الـwebhook لازم يبقى عنوان https عامّ (شوف أمان النقطة).

ولمّا ينرفض اختبار أو حفظ، اللوحة تقول لك السبب بلغتك: السبب، وسطر ما العمل:. ونصّ الخدمة نفسه مطويّ تحت التفاصيل كما أرسلتها الخدمة، وأي سرّ فيه ممسوح.

وبعد الحفظ، الاعتماد مشفّر عند التخزين وما يرجع يظهر لك. ومع الـwebhook العامّ تسكّ uMarker كمان سرّ توقيع من 40 محرف، تشوفه بعد الربط.

وهذا اللي تسوّيه بكل خدمة:

  1. أنشئ تطبيق Slack لمساحة عملك، واختر From scratch. رابط الخطوة يفتح لك صفحة التطبيق الجديد في سلاك.
  2. في التطبيق افتح Incoming Webhooks وفعّلها، ثم اضغط Add New Webhook واختر القناة.
  3. انسخ رابط الـwebhook اللي يعطيك إياه سلاك (يبدأ بـhttps://hooks.slack.com/…) والصقه في حقل الرابط.
  4. اضغط أرسل رسالة اختبار، وشوفها توصل القناة، وبعدها ربط.

uMarker تنشر رسالة Block Kit: العنوان، وتفاصيل التقرير كحقول، وأزرار تفتحه (شوف شكل الرسالة). ما فيه تركيب تطبيق ولا بوت ولا OAuth؛ رابط الـwebhook هو التكامل كله.

وهذا الرابط اعتماد حامل متنكّر: أي أحد يمسكه يقدر ينشر بقناتك. عشان كذا uMarker تشفّره عند التخزين وما ترجّعه لك أبداً.

كل قناة توصلها الرسالة بصيغة منصّتها نفسها، عشان المُفرِز يقدر يقرّر الأولوية ومين يمسك التقرير بلا ما يفتحه:

  • تيليجرام: عنوان عريض، وتحته التفاصيل، وزرّ فتح التقرير. وتيليجرام ما يقبل أزرار إلا لعنوان https عامّ، فلو منصّتك ما عندها واحد، الرابط ينكتب داخل النصّ بدل الزرّ.
  • سلاك: رسالة Block Kit — العنوان، والتفاصيل كحقول، وأزرار — ومعها نصّ عادي احتياطي لمعاينة الإشعار.
  • Microsoft Teams: بطاقة Adaptive Card فيها العنوان، والتفاصيل كقائمة حقائق، وزرّ فتح التقرير.
  • Webhook عامّ: نفس الحمولة الآلية زي قبل، ومعها النصّ المقروء في حقل message للتسهيل.

وكل رسالة تحمل وش صار ومين سوّاه، وعنوان التقرير، والمشروع والحالة والأولوية والمُسنَد إليه والمُبلِّغ والصفحة والجهاز والمتصفّح وعدد الدبابيس، والتسميات لو فيه. والحقل الفاضي ينشال، ما ينعرض فراغ. وبعدها الحدث نفسه:

الحدث وش تضيف الرسالة
status_change الحالة، من ← إلى
priority الأولوية، من ← إلى
mentioned التعليق مقتبساً، وكاتبه
assigned لمين انسند
issue_linked المتتبّع ومفتاح التذكرة، مع زرّ فتح التذكرة في المتتبّع (مثل «فتح MD-45 في Jira»)

والرسائل تنكتب بلغة حسابك، ومن اليمين لليسار للعربي، وأي شي كتبه إنسان يُهرَّب عشان ما يخرّب التنسيق. والنصّ الطويل ينقصّ عشان يناسب حدّ كل منصّة. وأرسل رسالة اختبار تستخدم نفس طريقة البناء مع تقرير نموذجي، فالاختبار يوريك بالضبط شكل الرسائل الحقيقية.

  1. افتح المشروع وروح لتبويب التوزيع.

  2. أرفِق الاتصال اللي سوّيته.

  3. أشّر على الأحداث اللي تبغى هذا المشروع يمرّرها عبره.

  4. احفظ. يبدأ ينشر مع أول حدث مطابق.

  5. اضغط اختبار على المسار عشان تتأكّد من التوصيل قبل ما تعتمد عليه. يرسل رسالة حقيقية، موسومة كاختبار، وبلا ما يحتاج تقرير موجود.

كرّرها لكل مشروع. ونفس الاتصال يقدر يحمل اختيار أحداث مختلف بكل مشروع: تقارير موقع عميل تروح لقناة ذاك العميل، والمنشن بس، وهكذا.

الـwebhook العامّ هو اللي توصّله بأنظمتك أنت، عشان كذا موقّع. uMarker ترسل جسم JSON ومعه توقيع على البايتات بالضبط اللي أرسلتها، مع طابع زمني، في الترويسة:

X-uMarker-Signature: t=<unix-ts>,v1=HMAC_SHA256(<t>.<raw-body>, secret)

ومستقبِلك يعيد حساب نفس HMAC-SHA256 بالسرّ المشترك ويقارن: التطابق يثبت المصدر والسلامة، وأي جسم معدَّل ما يطابق. لحقول الحمولة ومثال تحقّق جاهز للّصق، شوف Webhooks الصادرة.

لو تسرّب السرّ، دوّره. زرّ تدوير السرّ على الاتصال يستبدله بقيمة جديدة من 40 محرف. ويحتاج صلاحية integrations.rotatechannel، وهي كمان اللي تقرّر هل يُعرض لك السرّ: بصفحة التكاملات، الدور اللي يمسكها وحده يشوف سرّ التوقيع تحت إدارة. وبدونها يظهر لك الاتصال برابطه بلا سرّ.

uMarker تفحص كل رابط قناة تلصقه (سلاك وTeams والـwebhook العامّ) وقت ما تختبره أو تحفظه. لازم النقطة تستخدم https، ولازم مضيفها يحلّ لعناوين عامة فقط. وأي شي يحلّ لنطاق خاص أو محلّي أو link-local أو محجوز يُرفض:

يجب أن يكون العنوان رابط https عاماً — العناوين الداخلية أو الخاصة غير مسموحة.

وهذا حارس SSRF: يمنع توجيه القناة لـlocalhost أو لخدمة داخلية أو لنقطة ميتاداتا السحابة (169.254.169.254). وحتى المضيف اللي ما يحلّ أصلاً يُرفض: الفحص يفشل مُغلقاً. وكطبقة ثانية، التسليم يرفض يتبع إعادة التوجيه ويحلّ IPv4 بس، فرابط عامّ ما يقدر يسوّي 302 لعنوان داخلي ولا يمرّر سجلّ IPv6 غير مفحوص وقت الإرسال. شوف نظرة عامة على الأمان والخصوصية.

التسليم وإعادة المحاولة ووسم التعثّر

Section titled “التسليم وإعادة المحاولة ووسم التعثّر”

كل نشر يُرسَل لطابور، فما يعطّل أبداً الأكشن اللي أطلقه، وكل وجهة تُسلَّم لحالها: تعثّر قناة ما يأثّر على قناة ثانية ولا على بريدك ولا على بقيّة المستقبِلين.

التسليم بمهلة 10 ثوانٍ، واللي بعدها يعتمد على هل ردّت وجهتك ولّا لا.

  • ردّت بأي شي غير 2xx: يُعاد لين ثلاث محاولات، بتراجع 10 ثوانٍ ثم 30.
  • ما قدرنا نوصلها — فشل DNS أو اتصال مرفوض أو انتهاء المهلة: تُعاد بنفس الطريقة مع الـwebhook العامّ بس، لأن حمولته تحمل معرّف حدث يقدر مستقبِلك يفلتر التكرار فيه. أمّا سلاك وTeams وتيليجرام فما تُعاد، ويُعتبر التسليم فاشلاً من أول مرّة. هذي الوجهات ما تقبل مفتاح idempotency، فإعادة المحاولة بتنشر نفس التقرير بقناتك مرّتين أو ثلاث، وما فيه شي يقول للقارئ إنه حدث واحد.

ولو ما قدر يسلّم، يُوسَم الاتصال:

  • نقطة الحالة على بطاقته بصفحة التكاملات تصير كهرمانية، ويظهر يحتاج إلى مراجعة ومعه السبب بكلام واضح. واضغط إدارة عشان تشوف الصورة كاملة لكل اتصال: السبب، وسطر ما العمل:، وكلمات الوجهة نفسها مطويّة تحت التفاصيل كما أرسلتها الخدمة. والنقطة لكل أداة مو لكل نقطة نهاية، فلو عندك رابطَي سلاك وواحد متعثّر، بطاقة سلاك تصير كهرمانية للاثنين — وإدارة تسردهم كل واحد لحاله.
  • تبويب التوزيع بالمشروع يعرض نفس السبب والحلّ على كل مسار متأثّر. مسار القناة فيه اختبر مجدداً بنفس المكان؛ ومسار المتتبّع فيه رابط اختبره مجدداً من التكاملات، لأن اعتماده هناك.
  • التسليم لبقيّة الاتصالات وللبريد ما يتأثّر.
  • وأول تسليم ناجح يمسح الوسم تلقائياً.

الفصل يحذف الاعتماد المحفوظ. ولو فيه مشاريع داخل المساحة اللي أنت واقف فيها توجّه عبره، uMarker ترفض المحاولة الأولى وتسمّي لك المشاريع، عشان تعرف قبل ما تسكت إشعاراتهم مو بعدها. أكّد، وينحذف الاتصال وكل مساراته مع بعض — بما فيها مسارات مساحاتك الثانية، واللي التحذير ما يسمّيها.

ولو تبغى توقف مشروعاً واحداً بلا ما تمسّ الباقي، عطّل أو احذف مسار ذاك المشروع من تبويب التوزيع حقّه بدل كذا.