MailInApp

تضمين الدورات والندوات التفاعلية عبر الإنترنت في تطبيقك

مستخدموك النهائيون ملكك أنت، لا ملك MailInApp — تتيح Embed API لواجهتك الخلفية تسجيلهم في دورة أو ندوة عبر الإنترنت وتضمين العارض الفعلي في تطبيقك، مع ترك قرار الأحقية لنظام الفوترة الخاص بك، بينما يتولى MailInApp الاستضافة والفيديو ورسائل دورة الحياة المحيطة بها.

الموضوع

You're registered — here's your link

تتيح Embed API لواجهتك الخلفية تسجيل مستخدميك النهائيين في دورة أو ندوة عبر الإنترنت على MailInApp وتضمين العارض في تطبيقك — دون أن يلمس ذلك المستخدم أبدًا حسابًا في لوحة تحكم MailInApp.

مستخدموك النهائيون ملكك أنت، لا ملك MailInApp — ولا ينبغي أن يضطروا إلى إنشاء حساب منفصل لمجرد مشاهدة دورة تستضيفها لهم.

واجهتك الخلفية، وأحقيتك أنت

يمنح POST /api/v1/courses/[id]/enroll الوصول إلى دورة لعنوان بريد إلكتروني أو يسحبه، ويسجّل POST /api/v1/webinars/[id]/register حاضرًا في ندوة عبر الإنترنت — وكلاهما يُصادَق بمفتاح API من نوع Bearer نفسه الذي تستخدمه واجهة Send API. يقرر نظام الفوترة أو الدفع الخاص بك من له الأحقية؛ ويكتفي MailInApp بعرض النتيجة.

ضمّن العارض الفعلي

بعد التسجيل، ينشئ POST /api/v1/courses/[id]/embed-token رمزًا موقّعًا قصير الأجل. وجّه إطار iframe أو نافذة تطبيقك إلى عنوان URL المُعاد، فيُطلق تسجيل دخول حتميًا في الخلفية — ويرى المستخدم النهائي تطبيقك طوال الوقت، ولا يرى أبدًا صفحة دخول MailInApp.

رسائل تفاعلية حول التسجيل، إن أردتها

يمكن لحقل lifecycleBindings في الدورة أو الندوة توجيه أحداث registered/reminder/enrolled/completed إلى مشروع في الاستوديو — عنصر رابط الاجتماع بزر الانضمام الحقيقي، وعدّاد تنازلي حتى وقت البدء. ويرجع تلقائيًا إلى النص العادي حين لا يُربط شيء، فلا يُعطّل تفعيل الميزة أي إعداد قائم أبدًا.

المفتاح نفسه، بحصة خاصة به

تتشارك Embed API مع واجهة Send API حد 60 طلبًا في الدقيقة لكل مفتاح، ولها إضافة إلى ذلك حصة شهرية مخصصة من الاستدعاءات حسب الباقة — صفر في باقتي Free وStarter، على غرار القيود المفروضة على واجهة Send API نفسها في هاتين الفئتين.

البدء

أنشئ مفتاح API من قسم المطورون، واستدعِ نقطة نهاية التسجيل في ندوة أو دورة من واجهتك الخلفية، ثم أنشئ رمز تضمين ووجّه إليه — راجع البدء السريع مع Embed API للاطلاع على بنية الطلبات كاملة.

تسلسل نموذجي للبناء والإرسال

  1. 1

    أنشئ مفتاح API

    تتشارك Embed API مفتاح API من نوع Bearer نفسه مع واجهة Send API المعاملاتية — مفتاح واحد يصادق كل مسار في حسابك.

  2. 2

    سجّل مستخدمك النهائي

    POST /api/v1/webinars/[id]/register لندوة تتطلب التسجيل، أو POST /api/v1/courses/[id]/enroll للوصول إلى دورة — تستدعيها واجهتك الخلفية بنفسها، دون أي نموذج أو حساب على MailInApp.

  3. 3

    ضمّن العارض

    ينشئ POST /api/v1/courses/[id]/embed-token رمزًا موقّعًا قصير الأجل؛ وجّه إطار iframe أو نافذة تطبيقك إلى عنوان URL المُعاد للانتقال إلى تجربة الدورة أو الندوة الفعلية.

  4. 4

    اربط رسائل دورة الحياة، إن شئت

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

عناصر مصمَّمة لهذا الغرض

الأسئلة الشائعة

هل يحتاج المستخدم النهائي إلى حساب في لوحة تحكم MailInApp؟

لا — وهذا هو الغرض من Embed API. يُطلق رمز التضمين الموقّع تسجيل دخول حتميًا في الخلفية، فلا يرى المستخدم النهائي إلا تطبيقك، ولا يرى أبدًا صفحة دخول أو لوحة تحكم لـ MailInApp.

من يقرر أحقية المستخدم في الوصول إلى دورة؟

أنت — تستدعي واجهتك الخلفية نقطة نهاية التسجيل لمنح الوصول أو سحبه استنادًا إلى نظام الفوترة أو الدفع الخاص بك. يكتفي MailInApp بعرض الدورة؛ وليس هو المرجع في تحديد من دفع.

هل يمكن أن تتضمن رسائل التسجيل والتذكير عناصر تفاعلية كأي حملة عادية؟

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

هل لـ Embed API حد معدل أو حصة منفصلة؟

تتشارك مع واجهة Send API حد 60 طلبًا في الدقيقة لكل مفتاح، ولها إضافة إلى ذلك حصة شهرية مخصصة من الاستدعاءات حسب الباقة — صفر في باقتي Free وStarter، على غرار القيود المفروضة على واجهة Send API المعاملاتية في هاتين الفئتين.

هل يعمل هذا مع ندوة ذات تسجيل عام، لا مع الندوات المضمَّنة في التطبيقات فقط؟

مع الاثنين — يمكن أن تبقى الندوة مفتوحة لتسجيل أي شخص عبر الصفحة المستضافة لدى MailInApp، أو أن تستخدم Embed API للتسجيل المضمَّن في التطبيق، أو الاثنين معًا؛ كل ما تفعله الواجهة هو فرض وضع التسجيل بدلًا من الوصول المفتوح.

توثيق ذو صلة

انظر أيضًا

ابنِ هذا في الاستوديو

ابدأ بالباقة المجانية — كل عنصر تفاعلي ومحرك البدائل الكامل مضمَّنان في كل فئة.

ابدأ البناء مجانًاعرض كل حالات الاستخدام