يشرح هذا القسم كيفية اكتشاف إرسال المستخدم لملف، والحصول على رابط الملف، وكيفية التعامل معه بشكل صحيح.

لتحديد متى أرسل المستخدم مرفقًا (مثل صورة، ملف، فيديو، أو صوت)، يجب استخدام شرط المشغل:

attachment_message

بعد إرسال المستخدم لملف، يتم إنشاء المتغيرات النظامية التالية:

  • #{attachments}: يحتوي على روابط جميع المرفقات من رسالة المستخدم، بتنسيق مصفوفة JSON. استخدم هذا عندما تحتاج إلى معالجة ملفات متعددة أو التعامل مع بنية البيانات برمجيًا.
  • #{attachment_url}: يحتوي على رابط مباشر بنص عادي للمرفق الأول (أو الوحيد). هذا هو المتغير الأكثر ملاءمة للاستخدام الفوري، مثل عرض الرابط في رسالة أو تمريره إلى وظيفة أخرى.

لفهم الفرق العملي، يمكنك عرض كلا المتغيرين في رسالة البوت. سيعرض المتغير #{attachments} مصفوفة JSON منظمة، بينما سيعرض المتغير #{attachment_url} رابطًا بسيطًا قابلًا للنقر.

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

للقيام بذلك، قم بتعريف متغير جديد في الحاسبة في محرر الكتل وقم بتعيين قيمة #{attachment_url} إليه.

مثال:
user_file = #{attachment_url}

قم بتعيين قيمة attachment_url إلى المتغير url_image1.