# التعليقات والإخفاء التلقائي

> اقرأ تعليقات فيسبوك وإنستجرام على صفحات وكيل مجيب، واعرف ما أخفاه الذكاء الاصطناعي ولماذا، وأخفِ تعليقًا أو أظهِره، وشغّل الإخفاء التلقائي للتعليقات أو أوقفه عبر الواجهة البرمجية العامة.

يرد ذكاء مجيب الاصطناعي على التعليقات في صفحات فيسبوك وحسابات إنستجرام الخاصة بك، ومع تشغيل الإخفاء التلقائي للتعليقات يُخفي المسيء والمزعج وما شابههما. عبر الواجهة البرمجية العامة تقرأ هذه التعليقات مع الرد على كل منها وحالة إشرافها، وتُخفي تعليقًا أو تُظهره من أدوات الإشراف لديك، وتشغّل الإخفاء التلقائي أو توقفه. التعليقات تحت `/v1/agents/{agentId}/comments`.

## كيف أعرض تعليقات الوكيل؟

اجلبها بـ `GET`، الأحدث أولًا. صفِّها بـ `moderation_status` أو `platform` أو `post_id`؛ وهذا يعرض كل ما هو مخفي الآن:

```bash
curl "https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/comments?moderation_status=hidden" \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"
```

يحمل كل تعليق ما كُتب، ومن كتبه، والرد عليه (`reply`)، وحالة إشرافه (`moderation`). وتضم القائمة التعليقات التي سجّلها مجيب على حسابات فيسبوك وإنستجرام المتصلة بالوكيل؛ وتُستبعد تعليقات الحساب الذي فصلته أو نقلته إلى وكيل آخر. وعلى خلاف صفحة التعليقات، تُبقي القائمة تعليقات الحساب السابقة ما دام الرد على التعليقات في الحساب والإخفاء التلقائي للوكيل متوقفين معًا. راجع [مرجع عرض التعليقات](../api-reference/list-comments).

## كيف أقرأ حالة إشراف التعليق؟

اقرأ `moderation` لا `reply.status`، فالأخير يخص الرد وحده: قد يكون رد التعليق المخفي `skipped` أو `failed` أو `replied`. وتعني القيمة null في `moderation.status` أن التعليق لم يُفحص قط، كأن يكون الإخفاء التلقائي متوقفًا حين وصل. والتعليق الذي أُعيد إظهاره يحمل `unhidden` ولا يُخفى تلقائيًا مرة أخرى. ويعني `hidden_by: platform` أنه أُخفي على فيسبوك أو إنستجرام نفسيهما، بفلتر فيسبوك أو بيد أحدهم في Meta Business Suite. وكل قيمة موضّحة في [مرجع جلب تعليق](../api-reference/get-comment).

## كيف أُخفي تعليقًا أو أُظهره؟

أرسل `POST` إلى `hide` أو `unhide` الخاصين بالتعليق:

```bash
curl -X POST https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID/comments/COMMENT_ID/hide \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE"
```

يعمل كما يعمل **إخفاء التعليق** و**إظهار التعليق** في صفحة التعليقات، ويعيد التعليق. يختفي التعليق المخفي عن العامة دون أن يُحذف، ولا يُرد عليه. والتعليق الذي تُظهره لا يُخفى تلقائيًا مرة أخرى. وإخفاء تعليق مخفي أصلًا يعيد `422 comment_already_hidden`، وإظهار تعليق غير مخفي يعيد `422 comment_not_hidden`، ويعني `422 platform_hide_failed` أن فيسبوك أو إنستجرام رفض الطلب أو تعذّر الوصول إليه، كأن يكون التعليق قد حُذف. وقد يكون مؤقتًا، فأعد المحاولة لاحقًا. وإن فشل الإخفاء أو الإظهار بـ `500` ثم أعدت المحاولة، فإن `comment_already_hidden` أو `comment_not_hidden` يعني أن الطلب الأول نجح. راجع [مرجع إخفاء تعليق](../api-reference/hide-comment).

## كيف أشغّل الإخفاء التلقائي للتعليقات أو أوقفه؟

هو إعداد للوكيل، فأرسل `PATCH` إلى الوكيل بـ `comment_auto_hide_enabled`:

```bash
curl -X PATCH https://api.mojeeb.app/v1/agents/YOUR_AGENT_ID \
  -H "Authorization: Bearer mk_live_YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{ "comment_auto_hide_enabled": false }'
```

وهو مفعّل افتراضيًا. وما دام مفعّلًا، يفحص الذكاء الاصطناعي كل تعليق جديد على حسابات الوكيل في فيسبوك وإنستجرام، حتى حيث يكون `respond_to_comments` متوقفًا في القناة، ويُخفي ما تقول قواعد مجيب وتعليماتك الرئيسية بإخفائه. راجع [التعليقات الاجتماعية](/docs/features/social-comments#كيف-يعمل-الإخفاء-التلقائي-للتعليقات) لتعرف ما يُخفى وكيف تخصّصه.

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

### هل تحذف الواجهة البرمجية التعليقات؟

لا. لا يحذف الذكاء الاصطناعي ولا الواجهة البرمجية التعليقات، بل يُخفيانها فقط، ويمكنك التراجع عن ذلك.

### هل يُحسب الإخفاء ضمن حد الرسائل؟

لا. تُحسب ردود الذكاء الاصطناعي وحدها. وعند بلوغ الحد يتوقف الذكاء الاصطناعي عن الرد ويستمر في الإخفاء؛ ودون اشتراك نشط لا يفعل أيًّا منهما.

### هل تظهر هنا التغييرات التي تتم على فيسبوك أو إنستجرام؟

تغييرات فيسبوك تظهر خلال ثوانٍ: التعليق الذي يُخفى أو يُظهَر هناك يحدّث `moderation`، مع `hidden_by: platform` عند الإخفاء. أما إنستجرام فلا يُبلغ مجيب، لذا لا يظهر التغيير الذي تم في تطبيق إنستجرام إلا بعد أن يفتح أحدهم ذلك المنشور في صفحة التعليقات؛ وعرض التعليقات عبر الواجهة البرمجية لا يفحص إنستجرام.

### ما النطاقات التي تحتاجها هذه الاستدعاءات؟

`comments:read` لعرض التعليقات وقراءتها، و`comments:write` لإخفائها وإظهارها. ويحتاج تغيير `comment_auto_hide_enabled` إلى `agents:write`. ويحملها كل مفتاح اليوم؛ راجع [التوثيق](../authentication).