الاتصال: على مستوى الحساب
الاعتماد نفسه: رابط سلاك، رمز بوت تيليجرام والمحادثة اللي اخترتها، نقطتك أنت. يُدخَل مرّة وحدة من صفحة التكاملات بالحساب، وتقدر تعيد استخدامه بأي مكان.
القنوات توصل فريقك كله، في المكان اللي هم أصلاً شغّالين فيه. تفضيلات البريد والجرس شي شخصي لكل مستخدم، أمّا القناة فهي وجهة مشتركة: قناة سلاك، أو محادثة تيليجرام، أو قناة Microsoft Teams، أو webhook خاص فيك. وuMarker تنشر نشاط المشروع هناك أول بأول، بلا ما يحتاج أحد يدخل uMarker عشان يشوفه.
القنوات تضيف على الإشعارات الشخصية ولا تلغيها؛ هي تبثّ نفس الأحداث لمكان يشوفه الفريق كله.
uMarker تقسم القناة لشيئين، ويستاهل تفهم القسمة قبل ما تبدأ:
الاتصال: على مستوى الحساب
الاعتماد نفسه: رابط سلاك، رمز بوت تيليجرام والمحادثة اللي اخترتها، نقطتك أنت. يُدخَل مرّة وحدة من صفحة التكاملات بالحساب، وتقدر تعيد استخدامه بأي مكان.
المسار: على مستوى المشروع
أي مشروع يرسل له، ووش الأحداث. يُضاف من تبويب التوزيع داخل المشروع. والاتصال الواحد يخدم أي عدد من المشاريع.
يعني الوكالة تلصق رابط سلاك مرّة وحدة وبعدها ترفقه بعشرة مشاريع عملاء، وكل واحد باختيار أحداث مختلف، بدل ما تعيد لصق نفس الاعتماد لكل مشروع. ويعني كمان إن فصل اعتماد مستخدَم يحذّرك بأسماء المشاريع اللي بتفقد توجيهها — مع حدّ واحد يهمّك لو عندك أكثر من مساحة.
| النوع | وش ترسل uMarker | متاح من |
|---|---|---|
| Webhook موقّع عامّ | حمولة JSON مُهيكلة وموقّعة | المجاني (كل الباقات) |
| سلاك (incoming webhook) | رسالة مقروءة ومعها رابط | البداية (99 ) |
| تيليجرام (بوتك، ينشر بمحادثة تختارها) | نفس الرسالة المقروءة | البداية (99 ) |
| Microsoft Teams (webhook عبر Workflows) | نفس الرسالة المقروءة | احترافي (249 ) |
النوع اللي ما تشمله باقتك يظهر بصفحة التكاملات مقفولاً ومعه اسم الباقة اللي تفتحه، وما ينخفي أبداً. وفيه كمان سقف لعدد الاتصالات اللي يمسكها الحساب بنفس الوقت، والقنوات تتشارك هذا السقف مع متتبّعات المهام: واحد على المجاني، وثلاثة على البداية، وعشرة على احترافي، وخمسة وعشرين على الوكالات، محسوبة على مستوى الحساب للنوعين مع بعض. يعني GitHub مربوط ياخذ وحدة منها — وعلى المجاني عندك مكان لمتتبّع أو قناة، مو للاثنين.
المسار يشترك بأي من هذي السبعة:
| الحدث | متى ينطلق |
|---|---|
new_feedback |
تُرسَل ملاحظة جديدة للمشروع |
assigned |
يُسنَد التقرير لعضو |
mentioned |
يُذكَر عضو بـ@ في تعليق |
status_change |
تتغيّر حالة التقرير |
priority |
تتغيّر أولوية التقرير |
resolved |
يُحلّ التقرير، أو ينحلّ دبوس في نقاشه |
issue_linked |
يُربط التقرير بـتذكرة متتبّع خارجية |
ولكل مسار مفتاح تشغيل. أطفئه عشان توقف التسليم بدون ما تحذف التوجيه، وشغّله لمّا تبغى ترجّعه.
من صفحة التكاملات بالحساب، اضغط ربط على بطاقة الأداة. تنفتح لك لوحة موجَّهة، وشكلها واحد لكل الأدوات:
خطوات الربط. خطوات مرقّمة، كل وحدة فيها رابط مباشر يفتح لك الصفحة الصحيحة بالخدمة الثانية، والحقول تعبّيها بنفس الخطوة اللي تطلبها. وما ينطلب منك إلا اللي تحتاجه تلك الخدمة: أي عنوان ثابت تعبّيه uMarker بنفسها، فما تركّب رابط API بيدك أبداً.
الاختبار. اضغط أرسل رسالة اختبار. uMarker ترسل رسالة حقيقية، موسومة بوضوح إنها اختبار، للي قدامك على الشاشة بالضبط. تأكّد إنها وصلت.
الحفظ. زرّ ربط يتفعّل بعد ما ينجح الاختبار. ولو غيّرت أي شي بعد الاختبار، اللوحة تنبّهك وتطلب تختبر مجدداً قبل الحفظ.
ولو الوجهة واقفة الحين وتبغى تحفظها برضو، فيه احفظ دون اختبار ناجح، واسمه يقول وش يسوّي. ورابط سلاك أو Teams أو الـwebhook لازم يبقى عنوان https عامّ (شوف أمان النقطة).
ولمّا ينرفض اختبار أو حفظ، اللوحة تقول لك السبب بلغتك: السبب، وسطر ما العمل:. ونصّ الخدمة نفسه مطويّ تحت التفاصيل كما أرسلتها الخدمة، وأي سرّ فيه ممسوح.
وبعد الحفظ، الاعتماد مشفّر عند التخزين وما يرجع يظهر لك. ومع الـwebhook العامّ تسكّ uMarker كمان سرّ توقيع من 40 محرف، تشوفه بعد الربط.
وهذا اللي تسوّيه بكل خدمة:
https://hooks.slack.com/…) والصقه في حقل الرابط.uMarker تنشر رسالة Block Kit: العنوان، وتفاصيل التقرير كحقول، وأزرار تفتحه (شوف شكل الرسالة). ما فيه تركيب تطبيق ولا بوت ولا OAuth؛ رابط الـwebhook هو التكامل كله.
وهذا الرابط اعتماد حامل متنكّر: أي أحد يمسكه يقدر ينشر بقناتك. عشان كذا uMarker تشفّره عند التخزين وما ترجّعه لك أبداً.
ما تركّب رابط تيليجرام. تعطي uMarker رمز البوت وتختار المحادثة، والباقي عليها.
افتح BotFather في تيليجرام (الخطوة توديك له مباشرة) وأرسل /newbot. اختر اسماً، واسم مستخدم ينتهي بـbot. وBotFather بيرد عليك برمز.
الصق الرمز في رمز البوت واضغط تحقّق من الرمز. الرمز الصحيح يعرض الرمز صحيح — البوت ومعه اسم بوتك. والرمز الغلط ينرفض هنا، قبل ما ينحفظ أي شي.
افتح البوت واضغط Start. البوت ما يقدر يراسل أحد ما ضغطها. ورابط بوتك (t.me/<yourbot>) يظهر بهذي الخطوة بعد التحقّق من الرمز.
أو لمجموعة: أضف البوت لها برابط الخطوة (t.me/<yourbot>?startgroup=1) وأرسل فيها رسالة. ولو وضع الخصوصية بالمجموعة يخفي الرسائل العادية عن البوت، أرسل /start. وللقناة، خلّ البوت مشرفاً.
اضغط ابحث عن محادثاتي. اللوحة تسرد المحادثات الخاصة والمجموعات والقنوات اللي يشوفها البوت؛ اختر وين توصل التقارير. وبمجموعة فيها مواضيع تقدر تختار الموضوع كمان، والافتراضي العام — بلا موضوع.
ولو القائمة فاضية، اللوحة تقول لا توجد محادثات لبوتك بعد: سوِّ الخطوة 3، وبعدها اضغط ابحث عن محادثاتي مرّة ثانية. تيليجرام ما يعرض إلا رسائل آخر 24 ساعة، فلو ضغطت Start قبل كذا، أرسل للبوت رسالة جديدة.
اضغط أرسل رسالة اختبار، وشوفها توصل، وبعدها ربط.
uMarker تنشر رسالة تيليجرام منسّقة ومعها زرّ فتح التقرير (شوف شكل الرسالة). والرمز اعتماد: يُشفَّر عند التخزين وما يرجع يظهر لك.
uMarker تنشر بطاقة Adaptive Card فيها العنوان وتفاصيل التقرير وزرّ فتح التقرير (شوف شكل الرسالة). ومثل سلاك، webhook بس: بلا بوت وبلا تفاعل باتجاهين.
وTeams يقبل الرسالة قبل ما ينشرها، فنجاح أرسل رسالة اختبار يثبت بس إن Teams استلم الطلب. تحقّق من القناة نفسها عشان تتأكّد إنها وصلت.
POST موقّع بسرّ.استخدمه للأتمتة، أو لجسر مخصّص، أو لخدمة uMarker ما تتكامل معها مباشرة. وكل طلب يحمل ترويسة X-uMarker-Signature عشان يتحقّق مستقبِلك إنه فعلاً جاي من uMarker وما انعدّل بالطريق. شكل الحمولة كامل ووصفة تحقّق خطوة بخطوة في مرجع Webhooks الصادرة.
كل قناة توصلها الرسالة بصيغة منصّتها نفسها، عشان المُفرِز يقدر يقرّر الأولوية ومين يمسك التقرير بلا ما يفتحه:
https عامّ، فلو منصّتك ما عندها واحد، الرابط ينكتب داخل النصّ بدل الزرّ.message للتسهيل.وكل رسالة تحمل وش صار ومين سوّاه، وعنوان التقرير، والمشروع والحالة والأولوية والمُسنَد إليه والمُبلِّغ والصفحة والجهاز والمتصفّح وعدد الدبابيس، والتسميات لو فيه. والحقل الفاضي ينشال، ما ينعرض فراغ. وبعدها الحدث نفسه:
| الحدث | وش تضيف الرسالة |
|---|---|
status_change |
الحالة، من ← إلى |
priority |
الأولوية، من ← إلى |
mentioned |
التعليق مقتبساً، وكاتبه |
assigned |
لمين انسند |
issue_linked |
المتتبّع ومفتاح التذكرة، مع زرّ فتح التذكرة في المتتبّع (مثل «فتح MD-45 في Jira») |
والرسائل تنكتب بلغة حسابك، ومن اليمين لليسار للعربي، وأي شي كتبه إنسان يُهرَّب عشان ما يخرّب التنسيق. والنصّ الطويل ينقصّ عشان يناسب حدّ كل منصّة. وأرسل رسالة اختبار تستخدم نفس طريقة البناء مع تقرير نموذجي، فالاختبار يوريك بالضبط شكل الرسائل الحقيقية.
افتح المشروع وروح لتبويب التوزيع.
أرفِق الاتصال اللي سوّيته.
أشّر على الأحداث اللي تبغى هذا المشروع يمرّرها عبره.
احفظ. يبدأ ينشر مع أول حدث مطابق.
اضغط اختبار على المسار عشان تتأكّد من التوصيل قبل ما تعتمد عليه. يرسل رسالة حقيقية، موسومة كاختبار، وبلا ما يحتاج تقرير موجود.
كرّرها لكل مشروع. ونفس الاتصال يقدر يحمل اختيار أحداث مختلف بكل مشروع: تقارير موقع عميل تروح لقناة ذاك العميل، والمنشن بس، وهكذا.
الـ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 غير مفحوص وقت الإرسال. شوف نظرة عامة على الأمان والخصوصية.
كل نشر يُرسَل لطابور، فما يعطّل أبداً الأكشن اللي أطلقه، وكل وجهة تُسلَّم لحالها: تعثّر قناة ما يأثّر على قناة ثانية ولا على بريدك ولا على بقيّة المستقبِلين.
التسليم بمهلة 10 ثوانٍ، واللي بعدها يعتمد على هل ردّت وجهتك ولّا لا.
ولو ما قدر يسلّم، يُوسَم الاتصال:
الفصل يحذف الاعتماد المحفوظ. ولو فيه مشاريع داخل المساحة اللي أنت واقف فيها توجّه عبره، uMarker ترفض المحاولة الأولى وتسمّي لك المشاريع، عشان تعرف قبل ما تسكت إشعاراتهم مو بعدها. أكّد، وينحذف الاتصال وكل مساراته مع بعض — بما فيها مسارات مساحاتك الثانية، واللي التحذير ما يسمّيها.
ولو تبغى توقف مشروعاً واحداً بلا ما تمسّ الباقي، عطّل أو احذف مسار ذاك المشروع من تبويب التوزيع حقّه بدل كذا.