الانتقال إلى المحتوى الرئيسي
GET
احصل على الرسائل أو المحادثات لمنصة مراسلة. تختلف أوقات الاسترجاع في كل شبكة تواصل اجتماعي. على Facebook وInstagram، تكون الرسائل متاحة عبر Ayrshare في الوقت الفعلي. على X/Twitter، هناك تأخير يصل إلى 3 دقائق لرؤية تحديثات الرسائل الجديدة. يرجى الاتصال بالدعم لمعرفة المزيد عن خطة Enterprise إذا كنت بحاجة إلى الوصول إلى رسائل X/Twitter في الوقت الفعلي.
تخزين مؤقت للاستجابات: يتم تخزين استجابات GET messages مؤقتًا لتحسين الأداء. بالنسبة إلى Facebook وInstagram، يتم تخزين الاستجابات مؤقتًا لمدة 60 ثانية. بالنسبة إلى X/Twitter، يتم تخزين الاستجابات مؤقتًا لمدة 15 ثانية لدعم الاستعلام الدوري (polling) بشكل أفضل. تشير الحقول lastUpdated وnextUpdate في الاستجابة إلى وقت آخر جلب للبيانات ومتى ستكون البيانات الجديدة متاحة.
استرجاع سجل الرسائل الأولي لـ Facebook وInstagram محدود بآخر 20 رسالة. يرجى الاطلاع على قسم استرجاع سجل الرسائل لـ Facebook وInstagram لمزيد من المعلومات.

معلمات الترويسة

معلمات المسار

platform
string
مطلوب
المنصة للحصول على الرسالة: facebook أو instagram أو twitter

معلمات الاستعلام

status
string
افتراضي:"active"
مطلوب
إرجاع المحادثات النشطة أو المحادثات المؤرشفة. القيم: active أو archived.
conversationId
string
إرجاع المحادثة المحددة فقط.
conversationsOnly
boolean
افتراضي:false
إرجاع جميع المحادثات. إذا كانت true فسيتم تجاهل حقل conversationId.
limit
integer
X/Twitter فقط. حدد عدد الرسائل المُعادة لكل طلب (1–100). يتيح استعلامًا دوريًا فعالاً دون مزامنة سجل كامل. استخدمه مع next للترقيم. إذا تم حذفه، سيتم استخدام السلوك الافتراضي (استرجاع كامل الرسائل).
next
string
X/Twitter فقط. مؤشر ترقيم مشفّر تم إرجاعه من حقل meta.pagination.next في الطلب السابق. استخدمه مع limit لجلب الصفحة التالية من النتائج.