عرض كافة المحادثات

after

نوعه مصفوفة array، يساعد على عرض المحادثات التي يتجاوز رقم تعريفي معين فيها قيمة محددة.

before

نوعه مصفوفة array، يساعد على عرض المحادثات التي يقل رقم تعريفي معين فيها عن قيمة محددة.

agent_ids

نوعه مصفوفة array، يساعدك على عرض المحادثات التي يتابعها وكلاء أو موظفون معينون في مركز المساعدة بناءً على الرقم التعريفي للوكيل.

archived

نوعه منطقي boolean، بإعطائه القيمة true تُعرض المحادثات المؤرشفة فقط، وبإعطائه القيمة false تُعرض كافة المحادثات ما عدا المحادثات المؤرشفة.

assign_to

نوعه مصفوفة array، تكتب ضمنه الأرقام التعريفية للوكلاء agents الذين تود عرض المحادثات المُسندة إليهم.

contact_ids

نوعه مصفوفة array، تكتب ضمنه الأرقام التعريفية للأشخاص contacts الذين تواصلوا مع مركز المساعدة، ويساعدك على عرض المحادثات المتعلقة بأشخاص محددين.

conversation_status_ids

نوعه مصفوفة array، تكتب ضمنه الأرقام التعريفية لحالات المحادثات، ويساعدك على تصفية المحادثات المعروضة تبعًا لحالة معينة أو مجموعة حالات معينة.

expand

نوعه مصفوفة array، يساعد على تحديد المعلومات التي تود عرضها عن كل محادثة، ويقبل القيم التالية:

• inbox صندوق البريد الذي تتبع له المحادثة.
• conversation_status حالة المحادثة.
• created_by مُنشئ المحادثة.
• last_message أحدث رسالة في المحادثة.
• tags الوسوم التي تندرج تحتها المحادثة.
• assigned_agent الوكيل المُسندة إليه المحادثة.
• reviews تقييمات المحادثة.

form_date

نوعه سلسلة نصية string، يساعدك على عرض المحادثات ابتداءً من تاريخ معين.

to_date

نوعه سلسلة نصية string، يساعدك على عرض المحادثات لغاية تاريخ معين، وباستخدامه مع المعامل from_date السابق يمكنك إظهار المحادثات بين تاريخين.

inbox_ids

نوعه مصفوفة array، يساعدك على عرض المحادثات التابعة لصناديق بريد معينة فقط، إذ تكتب ضمنه الأرقام التعريفية لصناديق البريد، علمًا أنك تستطيع الحصول عليها بإرسال طلب GET إلى نقطة الاتصال

inboxes/

.

last_reply_by

نوعه سلسلة نصية string، يقبل إحدى قيمتين فقط contact أو agent، بإعطائه القيمة contact ستظهر لك المحادثات التي كانت آخر رسالة فيها من الشخص المُرسِل، وبإعطائه القيمة agent ستحصل على المحادثات التي كانت آخر رسالة فيها من أحد الوكلاء.

limit

نوعه عدد صحيح integer، يساعدك على التحكم بعدد المحادثات المعروضة في الاستجابة response، قيمته الافتراضية 6 ما لم تعطه قيمة مغايرة.

query

نوعه سلسلة نصية string، وهو مخصص للبحث في الحقول النصية، مثل: اسم الشخص، أو نص الرسالة أو غيره، ويساعدك على اظهار المحادثات التي تتضمن كلمات معينة

replied_agent_ids

نوعه مصفوفة array، يساعدك على عرض المحادثات التي رد عليها وكيل في مركز مساعدة بناءً على الرقم التعريفي.

sort

نوعه سلسلة نصية string، يساعدك على ترتيب المحادثات تصاعديًا أو تنازليًا تبعًا لعدة عوامل.

• لترتيبها من أقدم محادثة إلى أحدث محادثة أو العكس استخدم created_at.desc أو created_at.asc.
• لترتيبها من أقدم رسالة إلى أحدث رسالة أو العكس استخدم send_message_at.asc أو send_message_at.desc.
• لترتيبها حسب عدد الرسائل ضمن كل محادثة من الأكثر إلى أقل أو العكس استخدم messages_count.desc أو messages_count.asc.

status

نوعه سلسلة نصية string، يساعدك على عرض المحادثات التي تتصف بحالة محددة، وذلك بكتابة اسم الحالة مثل opened أو closed وليس رقمها التعريفي كما في المعامل conversation_status_ids ويمكنك تصفية المحادثة هنا وفق عدة حالات.

tags

نوعه مصفوفة array يساعد على عرض المحادثات التي لها وسوم معينة حيث تمرر للمصفوفة أسماء هذه الوسوم.