# كيفية إنشاء شهادة

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

{% hint style="success" %}
يمكن إعادة إنشاء الشهادات المصدرة وتعديلها إذا لزم الأمر.
{% endhint %}

يوفّر منشئ الشهادات من MaviBot إمكانية إنشاء شهادة مع رابط إلى دورتك أو بدونه.

<div data-with-frame="true"><figure><img src="/files/80a7e13bc3709da6cc57f7eeeb343bc9d6c6fbcb" alt="" width="563"><figcaption></figcaption></figure></div>

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

## لنبدأ!

لإنشاء شهادة، انتقل إلى تبويب “Courses”، حيث ستظهر علامتا تبويب في الأعلى. عليك الانتقال إلى “Certificate builder”.

<div data-with-frame="true"><figure><img src="/files/ce570c7cba5761bc4772ac9eb79cea276dee0498" alt="" width="563"><figcaption></figcaption></figure></div>

إذا لم تكن قد أنشأت أي شهادات بعد، فسيظهر الزر في منتصف مساحة العمل؛ وإذا كانت لديك منتجات جاهزة، فسيكون على الجانب الأيمن من الشاشة.

<div data-with-frame="true"><figure><img src="/files/bf19e0b0410557aa962671b68d25052b50085aae" alt=""><figcaption></figcaption></figure></div>

بعد النقر على زر "Create"، ستنتقل إلى الإعدادات الأساسية للشهادة.

<div data-with-frame="true"><figure><img src="/files/9dd086ab052b500aa924d0d51d9eea2ee1a76f8a" alt="" width="428"><figcaption></figcaption></figure></div>

### الإعدادات الرئيسية للشهادة

في الإعدادات الرئيسية للشهادة، يتم ضبط الصيغة والربط بالدورة. إذا كانت لديك دورة بالفعل، فسيتم اختيار صورة الشهادة.

**اسم الشهادة** هو حقل نصي لاسم شهادتك.

<div data-with-frame="true"><figure><img src="/files/01c06b8ca67e9d703df873ec96d37af89c823a36" alt=""><figcaption></figcaption></figure></div>

**صيغة الشهادة** تتيح لك اختيار شكل شهادتك: 1:1 (مربع)، أو 16:9 (مستطيل)، أو 4:3 (عمودي).

<div data-with-frame="true"><figure><img src="/files/e54cc6ffd90f478ec391eb358f7021422e3df930" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## يرجى الملاحظة

يجب أن تتطابق الصورة المرفوعة مع الصيغة المحددة.
{% endhint %}

**بعد ذلك يمكنك اختيار الدورة** والخطة التي ستُربط بها شهادتك.

<div data-with-frame="true"><figure><img src="/files/15603c404344af19f0f3d1e993a85e192945f7e1" alt="" width="498"><figcaption></figcaption></figure></div>

إذا لم تكن لديك أي دورات، يمكنك تخطي هذه الخطوة.

{% hint style="info" %}
لا تتطلب إعدادات الشهادة ربطها بدورة معينة أو بخطة أسعار محددة. يضمن هذا الإعداد أن الطالب سيحصل على الشهادة بعد إتمام أي دورة بنجاح من فهرسك، وعلى أي خطة متاحة.
{% endhint %}

إذا كنت ترغب في إصدار صورة مخصصة كشهادة، فاستخدم مربع الاختيار "Custom image" دون الرجوع إلى الدورة:

<div data-with-frame="true"><figure><img src="/files/1638ec893386da76071ef2dab1fba3a8cd53fc49" alt="" width="488"><figcaption></figcaption></figure></div>

{% hint style="info" %}
كيفية إنشاء الصور المخصصة وعرضها عبر بوت موضحة في المقال "[الصور المخصصة](/doc/ar/kyfyh-.../swr-mkhssh.md)".
{% endhint %}

في حقل “**Upload certificate**”، أدرج الصورة التي ستكون خلفية شهادتك.

<div data-with-frame="true"><figure><img src="/files/b16470ed4ce1e0f2df0b0d45345a09802607bb62" alt="" width="491"><figcaption></figcaption></figure></div>

يمكنك تنزيل الصورة من جهازك أو إضافة رابط إليها من التخزين السحابي للملفات.

لإضافة شهادة من التخزين السحابي للملفات، ارفع صورة في القسم المناسب.

<div data-with-frame="true"><figure><img src="/files/f497d0472771102c6a5e08e4c4e5f5d31a3abf8b" alt=""><figcaption></figcaption></figure></div>

ثم انسخ الرابط الخاص بها:

<div data-with-frame="true"><figure><img src="/files/f4b307220233651024b01d5a2a66fa07572e6d1e" alt=""><figcaption></figcaption></figure></div>

وألصق الرابط في حقل URL في منشئ الشهادات:

<div data-with-frame="true"><figure><img src="/files/5f151cedc7267916ba44a9cd53134cd2dacc5d99" alt=""><figcaption></figcaption></figure></div>

ثم انقر على “**حفظ**” الزر:

<div data-with-frame="true"><figure><img src="/files/89bc1f59c2e17b623599d2d040e2a15ea672b29b" alt="" width="389"><figcaption></figcaption></figure></div>

سيظهر سطر “Configure input fields”. انقر عليه للمتابعة في إعداد الشهادة:

<div data-with-frame="true"><figure><img src="/files/2732cc4bfc3a9a6fa2d88d2f60dc631022b52766" alt="" width="389"><figcaption></figcaption></figure></div>

### إعدادات حقول الإدخال

{% hint style="success" %}

## يرجى الملاحظة

ستعرض الشهادة البيانات التي أدخلها الطالب في حسابه الشخصي. لذلك من المهم إبلاغ طلابك بأن البيانات يجب إدخالها بشكل صحيح: الاسم الكامل وصورة الطالب.
{% endhint %}

اضبط النص الافتراضي في حقول الإدخال هذه. سيتم تعبئة قيمها تلقائيًا عند إصدار الشهادة.

<div data-with-frame="true"><figure><img src="/files/a72e83d43be38efbd7e9339567100bb9caece15c" alt=""><figcaption></figcaption></figure></div>

**الاسم**

يحدد هذا الحقل **اسم المستلم**. عندما يُنهي الطالب الدورة، سيتم إدراج اسمه تلقائيًا في هذا الحقل على الشهادة.

لديك تحكم كامل في مظهره: اختر الخط، واضبط الوزن والحجم، وحدد اللون، واضبط موضعه بدقة.

<div data-with-frame="true"><figure><img src="/files/d0873dc2e19f04e7c3a89a748c4bfecd639d0d2e" alt=""><figcaption></figcaption></figure></div>

يمكنك تعديل عناصر النص مباشرةً على معاينة الشهادة:

* **للنقل:** مرّر فوق النص حتى يتغير المؤشر إلى أيقونة يد. ثم انقر واسحب العنصر إلى موضعه الجديد.
* **لتغيير الحجم:** مرّر فوق الزاوية السفلية اليمنى لمربع النص حتى يتغير المؤشر إلى سهم تغيير الحجم. انقر واسحب لضبط الحجم.\
  تنعكس جميع التغييرات فورًا في لوحة الإعدادات.

<div data-with-frame="true"><figure><img src="/files/53b864486c52e3ef1577f17879444b82cdffeae3" alt=""><figcaption></figcaption></figure></div>

**التاريخ**

يعرض تاريخ إصدار الشهادة، والذي يتم تعيينه تلقائيًا إلى تاريخ إكمال الطالب للدورة.

> **المنطق:** بالنسبة للدورات التي تحتوي على واجبات منزلية، يعكس التاريخ تسليم آخر واجب. وإلا فهو تاريخ الدرس الأخير.

<div data-with-frame="true"><figure><img src="/files/997acc448dd9bed3e1362d8b12c146e0713272bc" alt=""><figcaption></figcaption></figure></div>

**الصورة الرمزية**

تعرض صورة ملف الطالب الشخصي. يمكنك تخصيصها بتغيير موضعها واختيار شكل (مثل: دائرة، مربع، مربع بزوايا مستديرة).

<div data-with-frame="true"><figure><img src="/files/0337a1889a1d3aba34252e03a2eb22c52f0a2bcd" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

## يرجى الملاحظة

* إذا كنت لا تريد عرض صورة رمزية على شهادتك، فلا تملأ الحقول.
* إذا اخترت عرض صورة رمزية على الشهادة، لكن الصورة غير مرفوعة في الحساب الشخصي للطالب، فستظهر صورة رمزية فارغة على الشهادة.
  {% endhint %}

**الرقم التسلسلي للشهادة** يتكون من سلسلة ورقم. يمكنك إدخال السلسلة بنفسك وتعديلها بالطريقة نفسها مثل الاسم أو التاريخ. يتم إنشاء الرقم تلقائيًا عند إصدار الشهادة.

<div data-with-frame="true"><figure><img src="/files/452c3abfc71c51e6c9fb900d7923680c9f5140c9" alt=""><figcaption></figcaption></figure></div>

يمكنك أيضًا إضافة أي نص.

<div data-with-frame="true"><figure><img src="/files/260bfc7647e4ec3b7ab302b40bf792ab5fd4916e" alt=""><figcaption></figcaption></figure></div>

للقيام بذلك، انقر على “Add text”، ثم أدخل النص المطلوب وعدّله كما تريد. لزيادة أو تقليل حجم النص، تحتاج إلى إدخال قيمة رقمية في حقل “Size”.

{% hint style="success" %}
إذا كنت تريد أن يكون النص بنفس النمط، فيمكنك نسخ حجم النص ولونه، واختيار الخط والسُمك المناسبين.
{% endhint %}

لتجنب فقدان تقدم الإعداد بالكامل، انقر على زر “Save”.

<div data-with-frame="true"><figure><img src="/files/3a674cf358bf22d38cc5c9fbdf0f238c51cb5fa2" alt=""><figcaption></figcaption></figure></div>

بعد إعداد جميع البيانات، يمكنك تنزيل معاينة لرؤية شكل شهادة طلابك:

<div data-with-frame="true"><figure><img src="/files/c82b857ad92d72bc2919ffa3e5f1ef0caa53ed08" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
تُعرض جميع الشهادات المنشأة في "Certificate builder". يمكنك دائمًا استبدالها أو تغيير الإعدادات.
{% endhint %}

شهادتك أصبحت الآن مفعلة! وسيتم **إصدارها تلقائيًا** للطلاب الذين يُكملون معايير الدورة بنجاح (جميع الدروس وأي واجبات منزلية مطلوبة) وستكون متاحة للتنزيل في حساباتهم الشخصية.

## إصدار الشهادات عبر روبوت محادثة

لتهيئة إصدار الشهادات عبر روبوت المحادثة الخاص بك، اتبع الخطوات التالية:

1. انتقل إلى مسار عمل البوت الذي سيتولى تسليم الشهادة.
2. أضف كتلة جديدة إلى هذا المسار.
3. داخل الكتلة، اختر **Calculator** وظيفة وقم بتهيئتها لعمليات الشهادات.

**get\_certificate(course\_id, name\_on\_cert, avatar, date, tariff\_id, texts)**

{% hint style="warning" %}

## يرجى الملاحظة

استخدام هذه الوظيفة داخل بوتك يستهلك موارد تعادل إرسال **10 رسائل قياسية**.
{% endhint %}

{% hint style="danger" %}

## &#x20;تنبيه

يجب إكمال إعداد الشهادة في إعدادات الدورة قبل استخدام هذه الوظيفة.
{% endhint %}

<table><thead><tr><th width="231">معلمات الوظيفة</th><th>وصف المعلمة</th></tr></thead><tbody><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> course_id</strong></td><td>معرّف الدورة</td></tr><tr><td><mark style="color:red;"><strong>!</strong></mark><strong> name_on_cert</strong></td><td><p>الاسم على الشهادة</p><p>(يمكنك طلبه أو أخذه مباشرةً من بطاقة العميل)</p></td></tr><tr><td><strong>avatar</strong></td><td><p>معلمة اختيارية، 1 - إذا كنت تحتاج إلى تمرير صورة العميل الرمزية، 0 - إذا لم تكن بحاجة إلى ذلك</p><p><em>(القيمة الافتراضية هي 0، لا تنسَ إعداد عرض الصورة الرمزية في الدورة إذا كنت تريد تمريرها)</em></p></td></tr><tr><td><strong>date</strong></td><td><p>معلمة اختيارية، التاريخ بأي صيغة</p><p><em>(الافتراضي سيكون التاريخ الحالي)</em></p></td></tr><tr><td><strong>tariff_id</strong></td><td><p>معلمة اختيارية مطلوبة إذا كنت تريد إصدار شهادة مهيأة لخطة</p><p><em><strong>(</strong><mark style="color:red;"><strong>!</strong></mark><strong> </strong><strong>يجب أن تكون الخطة مهيأة مسبقًا)</strong></em></p></td></tr><tr><td><strong>texts</strong></td><td><p>هي معلمة اختيارية لتمرير مصفوفة من النصوص إليها.</p><p>(إذا مرّرت <strong>نصوصًا أكثر</strong> مما قمت بإعداده، فسيتم <strong>تجاهل الإضافية ببساطة</strong>; إذا مرّرت <strong>أقل</strong>، فسيتم <strong>عرض النصوص التي مررتها</strong>)</p></td></tr></tbody></table>

{% hint style="danger" %}
! <mark style="color:red;">**أخطاء في تمرير المعلمات:**</mark>

* إذا تم تمرير المعلمة course\_id بشكل غير صحيح، فستُرجع الوظيفة <mark style="color:red;">**الخطأ wrong course\_id.**</mark>
* إذا تم تمرير المعلمة tariff\_id بشكل غير صحيح، فستُرجع <mark style="color:red;">**الخطأ wrong tariff\_id.**</mark>
  {% endhint %}

{% hint style="success" %}
بمجرد الإعداد، سيصدر البوت الشهادة للطالب عبر رسالة دردشة تحتوي على رابط وصول.
{% endhint %}

{% hint style="info" %}
للتعرّف على كيفية إنشاء وإصدار الصور المخصصة باستخدام منشئ الشهادات، يُرجى الرجوع إلى المقال "[الصور المخصصة](/doc/ar/kyfyh-.../swr-mkhssh.md)".
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/lms/certificate/builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.