# رمز QR والباركود: الإنشاء والتعرّف

## توليد رمز QR

لتوليد رمز، تحتاج إلى استخدام الدالة <https://store.mavibot.ai/function/qrcode\\_generator&#x20>;

#### المعلمات:&#x20;

**text\_for\_qr** - النص الذي يحتاج إلى ترميزه \
**api\_key** - مفتاح الوصول إلى API من إعدادات المشروع

![يمكنك توليد رمز في إعدادات المشروع](https://lh6.googleusercontent.com/G3P9JaFTZGHPGvVwzzehQy0mdgSHib6jodk5ABNL426isLQtkDmfduUrAmufT2ExI9ecJXPlTGdhywYGP5X6oGxTTu_QbsqTIE1A9RE4Qr5kVQIpkR8O3mL0-NTKuasuf2o73Kga_LD6s_hc7w)

{% hint style="info" %}
غيّر #{api\_key} إلى الرمز المميز من الإعدادات
{% endhint %}

#### مثال:

في حقل "طلب URL" الصق: <https://store.mavibot.ai/function/qrcode\\_generator>

في حقل "القيم المخزنة" الصق المتغيرات التي تريد حفظها (عنوان URL المطلوب موجود في *qr\_image\_url*):

*status->status;*&#x20;

*qr\_image\_url->qr\_image\_url*

في "معلمات JSON" اكتب

*{"text\_for\_qr":"نص للترميز","api\_key":"8629fe13ba9efebefd27a7afd701767f"}*

<figure><img src="/files/57739c22937ce5a79fc8c69db19768eebfb339e0" alt="" width="563"><figcaption></figcaption></figure>

تعيد الدالة json مع المعلمات *status* و *qr\_image\_url*

![رمز QR الذي تحصل عليه](https://lh6.googleusercontent.com/eSuVmN8FWyY6t7zXmyghnfXLbSy4S5u_Di4oryW3beBhQNZVXLXMPdve7wpx3fvqmbvYAL8J3XWn4gNff9R5pVFp04OjhgOqfJnS-kbC_kZnCV6iPO2JlJeL11TYUJ-mRij7eWVllrLlGeRZsA)

## توليد الباركود

لتوليد رمز، تحتاج إلى استخدام الدالة <https://store.mavibot.ai/function/barcode\\_generator&#x20>;

#### المعلمات:&#x20;

**text\_for\_qr** - النص الذي يحتاج إلى ترميزه \
**api\_key** - مفتاح الوصول إلى API من إعدادات المشروع

![يمكنك توليد مفتاح وصول إلى API في إعدادات المشروع](https://lh5.googleusercontent.com/cWMoOIdWMMRt6-EDnJvQXFRSsEZaTJNUnXZwcVBrBUmK19nZ_coUel3BXdrxT1sBn6L5qitVUu1-xbYuks6qsC8mxsEUGJ1u6ctNoYkFQaoLRLO4X32XupBFtVDxKuMSIY6G-Wsj_VcMqVrZPA)

**class** - فئة الرمز التي تحتاج إلى توليدها. افتراضيًا هي ea13. يمكن أن تأخذ القيم التالية: *'code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin', 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca'*

**without\_text** - (معلمة اختيارية) إذا زودتها بأي قيمة، فسيتم عرض الباركود بدون النص، كما هو موضح في الصورة أدناه.

![](https://lh5.googleusercontent.com/VXAHILxb5iktDtp4u8t6DzuQ3mfCWi-UX-XuPQ_cuSd9lvQTMEMgrcH8q7ZuqnJjRsHT5czWg_ra1RGxAVSm7OJe3nQeSI5Yu5zrvSQSxBBNB6wR-zzfuy9XEVRxTBlyv41nvKk8aaxt0fUJrQ)

{% hint style="info" %}
غيّر #{api\_key} إلى الرمز المميز من الإعدادات
{% endhint %}

مثال: *{"text":"#{barcode}","api\_key":"#{api\_key}", "class": "ean13"}*&#x20;

تعيد الدالة json مع المعلمات *status* و *qr\_image\_url* إذا نجحت و *error\_message* إذا لم تنجح

![](https://lh5.googleusercontent.com/d5iQRmdgfMrKI5_lnMzriTnyMcWm_slw4Mj5kArjxkOcGJzm5OIlRflLzqrwOe8OUdwyVl12fHC5yWQAs26g6cWuMTJoreO3cIE4HBFbBKrgZvrykg8onW4xZBIMaBGtUkhUbvXmVQLDJ-MaJw)

{% hint style="info" %}
يتم تخزين النص المثال في المتغير barcode، ويُستخدم المتغير image\_url لإرساله كصورة.
{% endhint %}

![مثال على الطلب بدون نص](https://lh6.googleusercontent.com/LOJir5XWjFLkuValhnA6WDmsDIDfXS_RZ-dtSuuN5ZJBrnTdSPmXU1SqtVcKab6yEpsLi-ZsuIRQhjbZuM3XJt9HuGf7bd_stOygSXYLPh2FJFoxEONy9ZZJOmR_R1X-nsHBdFk47_FFo_lFpA)

## التعرّف على الباركود من صورة

يمكنك استخدام هذا لإنشاء بوت يفحص رموز المنتجات. ومن الميزات المفيدة أنه يمكنه أيضًا فحص رموز QR.

عنوان الدالة التي تتعرّف على الباركود في الصورة هو <https://store.mavibot.ai/function/cv2barcode&#x20>;

لفحص صورة تحتاج إلى إرسال هذه المعلمات من الكتلة:

*{"photo":"الرابط إلى الباركود/رمز QR أو المتغير الذي يحتوي على الرابط","api\_key":"مفتاح الوصول إلى API من الإعدادات"}*

على سبيل المثال، لإرسال صورة للفحص تحتاج إلى إرسال هذه المعلمات:

![](https://lh6.googleusercontent.com/xbJz5HRo4PX_phHU5OW0j9GGANrH6sconYSdOwIW7iE-BtJwYibjv3DMZ0-UqebJaZ54TrCxH2sCFxcF3mEMEQFqdWDj4OHIf9_D5lmKn47Ye3rQ7cd6wZO6bPFfTm6OIbe90qUFBC_CYPCPgA)

في السهم في حقل "يدخل المستخدم البيانات" أدخل المتغير #{attachments}.

مثال على الكود:

`{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}`&#x20;

`الصورة` هو الرابط إلى صورة الباركود؛ وفي حالتنا، هو المتغير الذي يحتفظ بالرابط إلى الصورة المرسلة إلى البوت.

المعلمة التالية هي **api\_key** - مفتاح الوصول إلى API من إعدادات المشروع

![](https://lh6.googleusercontent.com/acBPr_Z1ewC3iC32xGYyy-l1LItVnkfdtIByxUYCbujBANi7KTfcce9mnBMl9jA4foxKv6Z75dp7fCiNBVFOKVE60EFOnhdrh2wH_eEDesvWQTO-mDYVUXCxeZTHoLv4p8RHhrr0qhhXnMmOqQ)

تعمل الدالة بهذه الطريقة:

يرسل العميل صورة للباركود، فتقوم الدالة بفحصها، وإذا نجحت، تُرجع رقم الباركود مع ضبط حالة العملية على "ok".

barcode -> "4500000000567" status -> "ok"

يمكن أن تكون حالة الفحص:

* **ok** — تم التعرّف على الباركود
* **لم يتم التعرّف على الباركود** — كما يوحي الاسم، لم يكن بالإمكان التعرّف على الباركود
* **خطأ في قراءة الصورة** — حدث خطأ أثناء قراءة الصورة
* **خطأ في الاشتراك** — هذه الميزة غير متاحة مع خطة الاشتراك الحالية لديك

يمكن استخدام المتغير status كشرط على سهم لتوجيه العميل إلى الكتلة المناسبة.

على سبيل المثال، إذا كان شرط السهم يتحقق مما إذا كانت status تساوي "barcode not recognized"، يمكنك عرض الرسالة "لم يتم التعرّف على الرمز، يُرجى المحاولة مرة أخرى" وطلب من العميل إرسال الصورة مرة أخرى.


---

# 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/myzat-khash/rmz-qr-walbarkwd-alinshaa-waltar-f.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.