يشرح هذا الدليل كيفية عمل سمات إجراءات واجهة برمجة تطبيقات REST في Astra وكيفية استخدامها داخل وكلاء Astra. تعمل السمات كعناصر نائبة تخزن البيانات وتمررها بين التعليمات والإجراءات.

ستتعرف على الأنواع المختلفة للسمات، وكيفية عملها، وكيفية استخدامها بشكل صحيح عند تكوين إجراءات واجهة برمجة تطبيقات REST (نقل الحالة التمثيلية).

في Astra، السمة هي عنصر نائب يخزن قيمة. يسمح لوكيلك باستخدام البيانات ديناميكيًا أثناء التنفيذ.

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

يتم تصنيف السمات في Astra بناءً على كيفية استخدامها:

يمكن الإشارة إلى كلا النوعين في جميع أنحاء سير عمل وكيلك.

سمات جهات الاتصال هي نوع محدد من السمات المرتبطة ببيانات العملاء.

تشمل الأمثلة الشائعة:

يمكنك إنشاء سمات مخصصة بناءً على حالة الاستخدام الخاصة بك داخل الوكيل.

ترتبط سمات جهات الاتصال بهذه الحقول فقط عند التقاط البيانات عبر هذه التدفقات.

ترتبط سمات الإجراءات بالإجراءات المكونة في وكيلك.

تصبح هذه متاحة عند إضافة إجراءات معينة إلى وكيلك.

أمثلة:

تستخدم إجراءات واجهة برمجة تطبيقات REST في Astra عناصر نائبة لتمرير البيانات الديناميكية.

تُكتب العناصر النائبة باستخدام: ##{{placeholder_name}}

يمكنك استخدامها في:

هذا هو النهج الأكثر مرونة والموصى به.

أنشئ إدخال بيانات في تكوين الإجراء الخاص بك.

حدد:

لديك 3 خيارات:

أشر إليه في حمولتك: ##{{data_input_name}}

تأكد من تطابق الاسم تمامًا.

يمكنك الإشارة مباشرة إلى سمة جهة اتصال: ##{{contact.attribute_name}}

يمكنك الإشارة إلى إخراج إجراء: ##{{action.<action_id>#out#<attribute_name>}}

من خلال فهم سمات Astra، يمكنك بناء وكلاء أكثر تنظيمًا وموثوقية وديناميكية داخل Wati.