Skip to main content
GET
نسخة تجريبية (Beta). انظر نظرة عامة على الأتمتة للاطلاع على وصف الميزة الكامل.
تُعيد كل محاولة إرسال لأتمتة واحدة، من الأحدث إلى الأقدم. يُسجّل كل صف المستلم، والمشغّل المطابق، ونتيجة كل إجراء، وأي خطأ. تُعاد صفوف آخر 30 يومًا. توجد الصفوف الأقدم في Firestore (يُحتفظ بها لأجل غير مسمى للتحليلات) لكنها تُستبعد من هذه النقطة الطرفية للأداء.

حالة صف النشاط

يحتوي كل صف على status رئيسي بالإضافة إلى status لكل إجراء داخل actionResults[]. pending وin_flight حالات مؤقتة؛ وسواها حالات نهائية. عندما تحتوي الأتمتة على أكثر من إجراء، تُشتق حالة status على المستوى الأعلى من نتائج كل إجراء بهذا الترتيب: auth_error إذا واجه أي إجراء خطأ مصادقة، ثم sent إذا قُبل أي إجراء، ثم deduplicated إذا كانت كل الإجراءات مُزالة التكرار، ثم skipped إذا كانت كل الإجراءات مكبوحة عمدًا (skipped أو deduplicated)، وإلا فـ failed. راجع actionResults[] للاطلاع على تفاصيل كل إجراء.
تُؤكّد sent أن Meta قبلت الرسالة، وليس أن المستلم قد استلمها. ينطبق هذا على الرسائل الخاصة على Instagram وعلى رسائل Messenger الخاصة من صفحة Facebook: تسجّل الأتمتة القبول فقط ولا تتتبّع التسليم. لا يكشف Instagram أي إشارة تسليم على أي واجهة برمجية، وإذا كان إعداد Message requests لدى المستلم يمنع الغرباء، فإن Meta تقبل الإرسال وتُسقطه بصمت. راجع رسالة أتمتة أُرسلت لكنها لم تُسلَّم.

حقول نتيجة كل إجراء

يصف كل إدخال في actionResults[] نتيجة إجراء واحد:

ما يحتويه sent

تُقتطع القيم النصية الطويلة إلى 4,000 حرف، ويُعيَّن truncated عند حدوث ذلك. أما القيم المخزّنة تحت أسماء مفاتيح تبدو كبيانات اعتماد، مثل token أو secret أو password أو apiKey، فتُسجَّل على أنها "[redacted]". كما يُسجَّل messageUrl الخاص بإجراء send_dm دائمًا على أنه "[redacted]"، لأن عنوان URL قد يحمل سرًّا في مساره أو في سلسلة الاستعلام. بالنسبة إلى الأتمتة المُشغَّلة بالتعليقات (comment_keyword)، يحمل الصف أيضًا commentId على المستوى الأعلى — وهو معرّف تعليق Instagram الأصلي الذي تم ربط الرسالة الخاصة به. تكون قيمته null بالنسبة إلى المشغّلات المدفوعة بالرسائل (dm_keyword، story_reply، dm_reaction). تحمل الصفوف أيضًا postId (المنشور الذي تُرك عليه تعليق comment_keyword) وstoryId (الستوري الخاص بـ story_reply وstory_comment). تكون قيمة كل منهما null للمشغّلات الأخرى، وتغيب عن الصفوف المكتوبة قبل إضافة هذين الحقلين.

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

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

string
مطلوب
معرّف الأتمتة الذي يُعاد من POST /automations.

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

number
افتراضي:25
حجم الصفحة. الافتراضي 25، والحد الأقصى 100. القيم خارج النطاق [1, 100] يتم تقييدها؛ والقيم غير الصحيحة أو ≤0 تُعيد HTTP 400.
string
مؤشر معتم مأخوذ من الاستجابة السابقة meta.pagination.next. يُحذف في الطلب الأول.للأمام فقط — تمرير ?previous= يُعيد HTTP 400.

شكل الاستجابة

تُغلّف الاستجابة قائمة النتائج في activity[] ومعلومات المؤشر في meta.pagination:
meta.pagination.next عبارة عن سلسلة معتمة مُشفَّرة بـ base64 — عاملها كصندوق أسود ومرّرها كما هي في ?next= بالطلب التالي. تكون meta.pagination.hasMore بقيمة true عند وجود صفحة إضافية واحدة على الأقل.