توليد رمز QR

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

المعلمات:

text_for_qr - النص الذي يحتاج إلى الترميز
api_key - مفتاح الوصول إلى API من إعدادات المشروع

يمكنك توليد رمز في إعدادات المشروع

قم بتغيير #{api_key} إلى الرمز المميز من الإعدادات

مثال:

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

في حقل "القيم المخزنة" الصق المتغيرات التي تريد حفظها (الرابط المطلوب موجود في qr_image_url):

status->status;

qr_image_url->qr_image_url

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

{"text_for_qr":"نص للترميز","api_key":"8629fe13ba9efebefd27a7afd701767f"}

ترجع الدالة json مع المعلمات status و qr_image_url

رمز QR الذي تحصل عليه

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

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

المعلمات:

text_for_qr - النص الذي يحتاج إلى الترميز
api_key - مفتاح الوصول إلى API من إعدادات المشروع

يمكنك توليد مفتاح وصول إلى API في إعدادات المشروع

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

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

قم بتغيير #{api_key} إلى الرمز المميز من الإعدادات

مثال: {"text":"#{barcode}","api_key":"#{api_key}", "class": "ean13"}

ترجع الدالة json مع المعلمات status و qr_image_url في حالة النجاح و error_message في حالة الفشل

النص المثال مخزن في المتغير barcode، ويستخدم المتغير image_url لإرساله كصورة.

مثال على الطلب بدون نص

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

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

عنوان الدالة التي تتعرف على الباركود في صورة هو https://store.mavibot.ai/function/cv2barcode 

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

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

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

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

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

{"photo":"#{attachments}","api_key":"8629fe13ba9efebefd27a7afd701767f"}

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

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

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

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

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

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

  • ok — تم التعرف على الباركود
  • barcode not recognized — كما يوحي الاسم، لم يتم التعرف على الباركود
  • error image reading — حدث خطأ في قراءة الصورة
  • error subscription — هذه الميزة غير متاحة مع خطة الاشتراك الحالية الخاصة بك

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

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