تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

قراءة سجل الرسائل المباشرة في Instagram: واجهة Conversations API

تقرأ Conversations API من Instagram، وهي واجهة برمجة التطبيقات (API)، سجل الرسائل المباشرة لحساب احترافي عبر graph.instagram.com. يسرد GET /me/conversations?platform=instagram المحادثات مع updated_time لكل منها، ويعيد GET /<CONVERSATION_ID>?fields=messages رسائل المحادثة بحسب المعرّف والوقت، ويعيد GET /<MESSAGE_ID>?fields=id,created_time,from,to,message رسالة واحدة. تتوفر التفاصيل لآخر 20 رسالة في كل محادثة.

تُمرّر easyCoexistence الرسائل المباشرة الجديدة من Instagram إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها، وترد عبر send_social_dm ضمن نافذة 24 ساعة، من Claude أو ChatGPT أو من الكود الخاص بك، عبر واجهة Meta البرمجية الرسمية؛ ولا توجد فيها أداة لسجل Conversations API.

20

أحدث الرسائل في كل محادثة التي تعيد API تفاصيلها، أما الأقدم فيأتي الرد عليه برسالة خطأ تفيد بأنها حُذفت.

30 days

مدة الخمول التي بعدها لا تُعاد المحادثات الموجودة في مجلد Requests.

2/sec

عدد استدعاءات Conversations API التي يجريها التطبيق في الثانية لكل حساب احترافي على Instagram.

2 permissions

instagram_business_basic وinstagram_business_manage_messages، على رمز وصول من شخص يستطيع إدارة رسائل الحساب.

كيف تسرد محادثات الحساب؟

باستخدام GET /me/conversations أو /<IG_ID>/conversations مع platform=instagram، ورمز وصول (token) من نوع Instagram User لشخص يستطيع إدارة الرسائل في الحساب. كل عنصر في المصفوفة data يمثل محادثة واحدة، ومعه id وupdated_time.

Listing conversations
GET https://graph.instagram.com/me/conversations
  ?platform=instagram
  &access_token=<ACCESS_TOKEN>

{
  "data": [
    { "id": "<CONVERSATION_ID>", "updated_time": "<UPDATED_TIME>" }
  ]
}

كيف تجد المحادثة مع شخص بعينه؟

أضف user_id بمعرّف Instagram المخصص للشخص، وهو IGSID الذي يصل كقيمة sender.id حين يراسل الحساب، فتعيد الاستجابة id تلك المحادثة. بذلك تحوّل حدث خطاف الويب (webhook) إلى خيط محادثته دون تصفح القائمة كاملة.

One person's conversation
GET https://graph.instagram.com/me/conversations
  ?user_id=<IGSID>
  &access_token=<ACCESS_TOKEN>

كيف تقرأ الرسائل؟

على خطوتين. يسرد GET /<CONVERSATION_ID>?fields=messages رسائل المحادثة بحسب id وcreated_time، وهي الحقول الافتراضية. ثم يعيد GET /<MESSAGE_ID> مع fields=id,created_time,from,to,message رسالة واحدة: من أرسلها وإلى من، ولكل طرف اسم مستخدم ومعرّف، مع نصها.

A conversation's messages, then one message
GET https://graph.instagram.com/<CONVERSATION_ID>
  ?fields=messages
  &access_token=<ACCESS_TOKEN>

GET https://graph.instagram.com/<MESSAGE_ID>
  ?fields=id,created_time,from,to,message
  &access_token=<ACCESS_TOKEN>

إلى أي مدى يمكنك القراءة إلى الوراء؟

يضع دليل Meta ونظرته العامة أربعة حدود على ما يُعاد:

  • تفاصيل الرسائل: آخر 20 رسالة في كل محادثة، وطلب رسالة أقدم يعيد خطأ يفيد بأنها حُذفت.
  • الطلبات: لا تُعاد المحادثات الموجودة في مجلد Requests التي لا نشاط فيها منذ 30 يومًا.
  • المشاركات: المنشور أو الريل المشارَك يعود كعنوان URL لصورته أو فيديوه فقط.
  • المعدل: استدعاءان في الثانية لكل حساب احترافي على Instagram.

ما المطلوب لذلك؟

مع Instagram Login، يلزم الإذنان instagram_business_basic وinstagram_business_manage_messages، ورمز وصول (token) من شخص يستطيع إدارة الرسائل في الحساب. يكفي Standard Access للحسابات التي تملكها أو تديرها وأضفتها إلى التطبيق، أما خدمة حسابات أخرى فتتطلب Advanced Access. كما يجب تفعيل خيار «Allow access to messages» في إعدادات تطبيق Instagram للحساب.

لماذا تحفظ سجلًا من webhook؟

لأن الواجهة تعيد التفاصيل لآخر 20 رسالة فقط في كل محادثة، لذا يجب تخزين السجل الكامل أولًا بأول. يرسل حدث الرسائل webhook الرسائل المباشرة فور وصولها، ومعرّف الشخص IGSID في sender.id، كما تصل الرسائل التي يرسلها الحساب بالمعرّفات معكوسة، فيمكن تسجيل طرفي المحادثة معًا.

كيف تقرأ سجل الرسائل المباشرة عبر easyCoexistence؟

تُمرّر الرسائل المباشرة بدلًا من قراءة السجل. تصل الرسائل المباشرة الجديدة إلى نقطة النهاية (endpoint) الخاصة بك فور وصولها بعد ضبطها عبر set_social_webhook_destination، وتُمرَّر دون الاحتفاظ بنسخة منها، وترسل send_social_dm الردود ضمن نافذة 24 ساعة، من Claude أو ChatGPT أو من الكود الخاص بك. لا توجد أداة تستدعي me/conversations، لذا تُقرأ الرسائل السابقة في تطبيق Instagram، أو يحتفظ بها نظامك الخاص فور وصولها.

الأخطاء الشائعة

  • أن تتوقع الخيط كاملًا من API. التفاصيل تتوقف عند آخر 20 رسالة، لذا خزّن الرسائل المباشرة من webhook فور وصولها.
  • الاستعلام الدوري عن المحادثات بحثًا عن رسائل جديدة. تسمح API باستدعاءين في الثانية لكل حساب، بينما يسلّم webhook كل رسالة فور وصولها.
  • البحث عن طلب رسالة قديم. لا تُعاد المحادثات الموجودة في Requests التي لا نشاط فيها منذ 30 يومًا.
  • قراءة خطأ « deleted » على أنه حذف من الشخص. يرد Meta بهذه الصيغة على أي رسالة أقدم من آخر 20 رسالة.
إنجاز ذلك باستخدام EasyCoexistence

من US$ 9 إلى US$ 0.75 لكل اتصال في الشهر، ينخفض كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

هل يمكنني تصدير سجل الرسائل المباشرة الكامل لحساب Instagram؟

ليس كاملًا عبر API، فهي تسرد المحادثات لكنها تعيد التفاصيل لآخر 20 رسالة في كل محادثة. السجل الكامل يأتي من تخزين الرسائل المباشرة كما يسلّمها webhook.

هل تؤدي قراءة الرسائل عبر API إلى تعليمها كمقروءة؟

لا. يقول Meta إن الرسائل المسلّمة عبر API لا تُعلَّم كمقروءة في تطبيق Instagram إلا بعد إرسال رد.

هل تعمل Conversations API مع Instagram Login؟

نعم. دليل Meta لها مكتوب لـ Instagram Login، مع استدعاءات إلى graph.instagram.com وأذونات instagram_business_*.

كيف أحصل على اسم مستخدم شخص من محادثة؟

اطلب from على رسالة، فيعيد اسم المستخدم للمُرسِل ومعرّفه. وتعيد User Profile API مزيدًا من البيانات، كالاسم، انطلاقًا من IGSID الخاص به بعد أن يراسل الحساب.

تابع القراءة

رسائل Instagram المباشرة عبر API ونافذة الـ24 ساعةطريقة عمل رسائل Instagram المباشرة عبر API: من يمكن للحساب مراسلته، ونافذة الرسائل 24 ساعة، والردود الخاصة، وإعداد السماح بالوصول.خطاف الويب (webhook) للرسائل على Instagram: حمولة الرسالة المباشرة (DM) والأصداء والحقولما يرسله webhook الرسائل على Instagram لكل رسالة مباشرة: معرّف المرسل المحدود والنص والمرفقات والردود على القصص والأصداء، حقلاً حقلاً، مع نافذة 24 ساعة.معرّفات مستخدمي Instagram: IG_ID وIGSID ومعرّف التطبيقمعرّفات Instagram API: IG_ID للحساب المهني، وIGSID للشخص الذي يراسل أو يعلّق، ومعرّف التطبيق الذي يعيده /me.حدود معدل Instagram API: الاستدعاءات خلال 24 ساعة وإنتاجية الرسائل المباشرة (DM)حدود معدل Instagram API: 4,800 استدعاء لكل ظهور كل 24 ساعة، و100 رسالة مباشرة في الثانية، و750 ردًا خاصًا في الساعة، والخطأ 80002.أذونات واجهة برمجة التطبيقات (API) في Instagram: النطاقات وراء كل ميزةالأذونات التي تستخدمها Instagram API مع تسجيل الدخول عبر Instagram، من instagram_business_basic إلى manage_insights، وأي ميزة تحتاج أيّاً منها.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في