Documentation menu

عنصر رابط الاجتماع

تفاصيل الانضمام إلى فعالية عبر الإنترنت أو هجينة: تسمية المزوّد، ورابط الانضمام، ووقت البدء، وكم دقيقة قبل البدء يجب أن يظهر رابط الانضمام نشطًا. إنه العنصر الذي يقف وراء لحظة «انقر هنا للانضمام» في دعوة ندوة عبر الإنترنت أو اجتماع عن بُعد، وقد صُمّم ليبقى دقيقًا سواء فتح المستلم الرسالة قبل أسبوع أو قبل بدء المكالمة بثلاثين ثانية.

آلية العمل

حقل المزوّد (Zoom أو Google Meet أو Microsoft Teams أو مخصّص) مجرد تسمية — لا OAuth ولا ربط حساب مع أيٍّ منها، بل رابط عادي تلصقه بنفسك. ووظيفته الوحيدة اختيار نص زر الانضمام («الانضمام عبر Zoom» مقابل «الانضمام إلى الاجتماع» العام للخيار المخصّص)، لا أكثر.

تعرض رسالة HTML المُرسَلة زر الانضمام دائمًا رابطًا حقيقيًا قابلًا للنقر، وفق اصطلاح «ثابت لحظة الإرسال» نفسه الذي يتّبعه عنصرا العدّاد التنازلي والمنتج. فلا يمكن جلب الرسالة من جديد مع اقتراب موعد بدء الاجتماع، ولذلك لا سبيل إلى تقييد الزر هناك.

بجانب الزر، يتتبّع سطر حالة وشارة العدّ التنازلي. فما دام startsAt في المستقبل، يكون النص «يبدأ خلال Xd Xh Xm» (أو «Xh Xm» حين يتبقى أقل من يوم)، إلى جانب صورة GIF صغيرة تُعرض على الخادم وتُبنى بتقنية صورة العدّاد التنازلي نفسها التي يستخدمها عنصر العدّاد التنازلي. وتواصل تلك الصورة العدّ بشكل صحيح عبر مرات الفتح، مع أنها صورة ثابتة تُولَّد من جديد عند كل طلب، لا شيئًا متحركًا على جهاز المستلم. وبمجرد أن يحين وقت البدء، تتحوّل الشارة إلى «مباشر الآن» دون أي عدّ تنازلي إضافي.

العرض المباشر المستضاف هو المكان الوحيد الذي يقيّد فيه هذا العنصر فعلًا زر الانضمام، لأنه، على عكس الرسالة المُرسَلة، يُجلب من جديد في كل زيارة. فهناك لا يظهر زر الانضمام إلا حين يكون وقت العرض ضمن opensMinutesBefore دقيقة من startsAt. وقبل أن تنفتح تلك النافذة، يرى المستلم شارة رمادية غير نشطة نصها «يُفتح قبل البدء بـ N دقيقة» (أو «لم يُفتح بعد» إذا كانت قيمة opensMinutesBefore تساوي 0) بدلًا من رابط يعمل. ويُحسب ذلك بشكل متزامن من خصائص العنصر نفسه مقابل الساعة الحالية — دون قراءة من Firestore، ودون حالة ردود مخزّنة — فتكون تكلفته زهيدة في كل عرض للعرض المباشر. أما العنصر الذي لم يُضبط فيه startsAt إطلاقًا فيبقى مفتوحًا دائمًا، في الرسالة والعرض المباشر على السواء، إذ لا يوجد ما يُقيَّد وفقه.

سطر الاتصال الهاتفي الاختياري، إن مُلئ، يُعرض نصًا عاديًا بجانب زر الانضمام في كل المستويات — وهو ليس رابطًا بحد ذاته، بل مجرد رقم هاتف لمن ينضم صوتيًا فقط.

الحقول القابلة للضبط:

  • المزوّد — Zoom أو Google Meet أو Microsoft Teams أو مخصّص (تسمية فقط).
  • رابط الانضمام — وجهة الزر.
  • وقت البدء — موعد بدء الاجتماع؛ ويتحكّم أيضًا في شارة «يبدأ خلال» وفي تقييد العرض المباشر.
  • الاتصال الهاتفي (اختياري) — رقم هاتف يُعرض نصًا عاديًا.
  • يُفتح رابط الانضمام قبل البدء بهذا العدد من الدقائق — نافذة التقييد في العرض المباشر (الافتراضي 15؛ وتعني 0 أن الرابط يبقى غير نشط حتى لحظة البدء بالضبط لا أكثر).
  • لون الخلفية، والحشو، والحدّ، واستدارة الزوايا للبطاقة.
  • تجاوزات لون تسمية الحالة وحجمها، ولون زر الانضمام وخلفيته.

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

أمثلة

Subject

Your seat is booked — join link inside

تقرن دعوة الندوة عبر الإنترنت عنصر رابط الاجتماع بعدّاد تنازلي في موضع أعلى من الرسالة — يبني العدّاد التنازلي الإحساس بالإلحاح في الأيام السابقة، ثم تتولّى شارة رابط الاجتماع المهمة بقراءة «يبدأ خلال» دقيقة مع اقتراب اللحظة. وللفعالية الهجينة، ضع عنصر رابط اجتماع وعنصر المكان معًا في الرسالة نفسها ليحصل الحاضرون عن بُعد والحاضرون شخصيًا كلٌّ على عنصر التحكّم الذي يخصّه. ويبدأ غرض المشروع «فعالية» بهذا الاقتران تحديدًا — راجع الفعاليات والندوات عبر الإنترنت. وضبط opensMinutesBefore على قيمة مثل 10 أو 15 يمنع من ينقرون مبكرًا من الانضمام إلى مكالمة شبه فارغة لا يحدث فيها شيء بعد.

كيف يبدو البديل الثابت

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">Starts in 2h 14m</p>
  <img src="https://mailinapp.com/api/countdown?t=1753401600000&c=111827&s=9f2a..." width="220" height="40" alt="Starts in 2h 14m"
       style="display:block;max-width:100%;height:auto;margin-bottom:8px" />
  <a href="https://zoom.us/j/123456789"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;
            border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Join on Zoom
  </a>
  <p style="margin:8px 0 0;font-size:13px;color:#4b5563">Dial in: +1 415 555 0100</p>
</div>

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

انظر أيضًا