# صور مخصصة

{% hint style="success" %}
متاحة فقط في خطة "Business".
{% endhint %}

الصور المخصّصة هي رسومات أو صور مصغّرة مخصصة يمكن تكييفها بشكل فريد لكل مستخدم في مشروعك. عادةً ما يتضمن هذا التخصيص تعديل عناصر معينة، مثل النص، لخدمة أغراض مختلفة — على سبيل المثال، عرض اسم المستخدم داخل الصورة لزيادة التفاعل.

لننشئ واحدة معًا.

#### **إنشاء صورة مخصّصة**

لإنشاء صورة مخصّصة، ستحتاج إلى استخدام أداة إنشاء الشهادة. يمكنك الوصول إليها من قسم إنشاء الدورة.

في أداة إنشاء الشهادة، يمكنك إعداد صور مخصّصة ليتم توزيعها عبر روبوت محادثة.

**الخطوة 1: إعداد الشهادة ونصّها**

1. انقر **"إنشاء شهادة."**
2. حمّل الصورة التي اخترتها كقالب للشهادة.

<figure><img src="/files/f1d140c0bfca5ecd1a1d66cb8d4d66f54da2d14b" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
تأكد من تفعيل خانة الاختيار "استخدام القالب كصورة مخصّصة."
{% endhint %}

الآن انتقل إلى إعدادات الشهادة ورتّب العناصر اللازمة بالترتيب الذي تريده:

<figure><img src="/files/3d84ae536a2faa3badf9607217b7b6a280f0d66f" alt=""><figcaption></figcaption></figure>

أدخل العنصر النائب لاسم المستلم (والذي سيُستبدل ديناميكيًا عبر روبوت المحادثة)، إلى جانب أي نص إضافي تريد أن يظهر على الصورة. يمكنك أيضًا ضبط إعدادات العرض الأخرى هنا.

توفّر أداة إنشاء الشهادة مرونة: لا تتردد في تجربة ألوان وخطوط وصور وعناصر تصميم أخرى مختلفة.

<figure><img src="/files/4e6ecab52333a621b8cf02e9ad03ed33b94b43aa" alt=""><figcaption></figcaption></figure>

لتسليم هذه الصور المخصّصة، ستحتاج إلى استخدام وظيفة روبوت محادثة داخل برنامج مراسلة مدمج مع نظام MaviBot.

### إرسال ملف عبر روبوت المحادثة

انتقل إلى مسار عمل روبوت المحادثة حيث تريد إرسال الصور المخصّصة. هناك، ستحتاج إلى استخدام الدالة:\
`get_custom_image(image_id, name_on_image, avatar)`

{% hint style="warning" %}

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

في كل مرة تستخدم فيها هذه الدالة، فإنها تستهلك نفس الموارد اللازمة لإرسال 10 رسائل عادية.
{% endhint %}

<table><thead><tr><th width="294">المعامل</th><th>الوصف</th></tr></thead><tbody><tr><td><mark style="color:red;">!</mark> image_id</td><td>معرّف الصورة</td></tr><tr><td><mark style="color:red;">!</mark> name_on_image</td><td>اسم المستخدم</td></tr><tr><td>avatar </td><td>صورة المستخدم الرمزية<br>إذا كنت بحاجة إلى تضمين صورة مخصّصة، فمرّر القيمة "1".</td></tr></tbody></table>

يمكنك العثور على معرّف الصورة هنا:

<figure><img src="/files/a5b3eb3780c9b30c75d785b2bab0b6856159a005" alt=""><figcaption></figcaption></figure>

كمثال، لنستخدم مسار عمل بسيط لروبوت محادثة سيرسل صورة في الدردشة:

<figure><img src="/files/0e9c57de0d43d24d36f543633fe221f9e05f8fa5" alt=""><figcaption></figcaption></figure>

إذًا، في الكتلة الثانية، سنطلب من العميل اسمه، وفي إعدادات السهم المؤدي إلى الكتلة الثالثة، سنحدد أن المستخدم يُدخل البيانات ونحفظ اسمه في متغير:

<div><figure><img src="/files/03726a2008052d48cb96931e9036111051c79301" alt=""><figcaption></figcaption></figure> <figure><img src="/files/632d4b9a496ca96903b31c2497f45f2f9a86876a" alt=""><figcaption></figcaption></figure></div>

في كتلة مسار العمل النهائية المسؤولة عن إرسال الصورة، أدخل الدالة في حقل الحاسبة. استخدم التنسيق التالي، مع تضمين `image_id` و `name` .

<figure><img src="/files/31d694593947e85cbd73999891e86fb9baafb9ba" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

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

الـ `get_custom_image` تُرجِع الدالة قاموسًا. لعرض الصورة في الدردشة، لا تُخرج متغير النتيجة (مثل، `image_1`) مباشرةً. بدلًا من ذلك، يجب أن تشير إلى القيمة المخزنة تحت المفتاح `'url'` (مثل، `image_for_user`).

إذا تم الإعداد بشكل صحيح، فسيتم إرسال الصورة وعرضها في الدردشة فورًا.
{% endhint %}

{% hint style="success" %}

## قواعد تسمية المتغيرات

عند تسمية متغيرك في الحاسبة، تأكد من أن الاسم:

* يحتوي فقط على أحرف لاتينية وأرقام (مثل، `picture` صحيح).
* لا يحتوي على مسافات (استخدم الشرطات السفلية: مثل، `apple_on_table`).
* يضع الأرقام في النهاية (مثل، `apple1`، وليس `1apple`).
  {% endhint %}

لاحظ أننا استخدمنا الصياغة `#{full_name}` لإدراج القيمة التي قدّمها المستخدم ديناميكيًا في المتغير.

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


---

# 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/kyfyh-.../swr-mkhssh.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.