كل تعليق ورسالة، في قائمة واحدة تبرمج عليها
يجلب FoPost التعليقات والرسائل المباشرة من كل حساب متصل إلى صندوق وارد واحد. اعرضها، واحسب غير المقروء، وعلّم العناصر كمُعالَجة، وردّ عليها، كل ذلك عبر الواجهة نفسها التي تستخدمها لوحة تحكمك.
curl "https://api.fopost.com/v1/inbox?workspace_id=9b2f6c1e-...&state=unread" \
-H "X-API-Key: $API_KEY"
{
"data": [
{ "id": "1f8b6a37-...", "type": "comment", "state": "unread", "platform": "instagram", "author_name": "Customer", "author_handle": "customer", "text": "Does this ship to Canada?", "post": { "id": "7d3e0a52-...", "title": "Launch day" }, "platform_created_at": "2026-08-29T14:02:11Z", "can_reply": true, "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." },
{ "id": "2c9d4e81-...", "type": "dm", "state": "unread", "platform": "facebook", "author_name": "Jordan P.", "author_handle": null, "text": "Hi, I need help with an order.", "post": null, "platform_created_at": "2026-08-29T13:48:30Z", "can_reply": true, "account": { "id": "c30e9f12-...", "platform": "facebook", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." }
],
"meta": { "page": 1, "per_page": 25, "total": 2, "total_pages": 1 }
}قائمة واحدة
تعليقات ورسائل من كل حساب، الأحدث أولًا، بالحقول نفسها.
عدد غير المقروء
طلب واحد لرقم الشارة، لكل مساحة عمل أو عبرها جميعًا.
الرد من الكود
أجب عن تعليق أو رسالة ويعود الرد إلى الشبكة.
وجّه المحادثات الواردة إلى المكان الصحيح
استعلم من صندوق الوارد وفق جدول أو عند الحاجة، وصفِّ حسب النوع أو الحساب أو الحالة، ثم مرّر كل عنصر إلى نظام الدعم أو قناة المحادثة أو إلى شخص من فريقك. ويرتبط كل عنصر بالمنشور الذي ينتمي إليه، إن وُجد.
اقرأ مرجع صندوق الواردcurl "https://api.fopost.com/v1/inbox/unread-count?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY"
{ "count": 14 }التصفية
حسب النوع أو الحساب أو المنصة أو حالة القراءة، مع تقسيم إلى صفحات.
مرتبط بالمنشور
تحمل التعليقات المنشور الذي تنتمي إليه، فتربطها بالتحليلات.
حسابات صندوق الوارد
تعرض GET /v1/inbox/accounts الحسابات المتصلة التي تغذّي صندوق الوارد.
أجب حيث سأل العميل
أرسل ردًا عبر POST إلى عنصر في صندوق الوارد فيُنشر ردًا على تعليق أو رسالة مباشرة على الشبكة الأصلية، من الحساب المتصل. وعلّم العناصر كمقروءة أو محلولة أو مؤجلة عبر PATCH حتى لا يعالج نظامان العنصر نفسه أبدًا.
اطّلع على نقطة نهاية الردcurl -X POST https://api.fopost.com/v1/inbox/1f8b6a37-.../reply \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "text": "Yes, we ship to Canada. Delivery takes 3 to 5 days." }'
curl -X PATCH https://api.fopost.com/v1/inbox/1f8b6a37-... \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "state": "read" }'رد أصلي
تُرسل الردود على التعليقات والرسائل المباشرة عبر API الشبكة نفسها.
تحديثات الحالة
مقروء أو محلول أو مؤجل، فتخرج العناصر المُعالَجة من قائمة الانتظار.
إرسال صريح
لا شيء يردّ من تلقاء نفسه. كل رسالة صادرة طلب تنفّذه أنت.
محدَّث حين تحتاجه، وهادئ حين لا تحتاجه
يتزامن صندوق الوارد وفق جدول لكل حساب متصل. وحين تحتاج إلى الأحدث الآن، استدعِ نقطة نهاية التحديث لمساحة العمل ثم اقرأ مجددًا. والحصر في مساحة العمل يعني أن مفتاح الوكالة لا يرى إلا محادثات عميله.
ابدأ البناء
تحديث عند الطلب
تجلب POST /v1/inbox/refresh الأحدث لكل حساب في مساحة العمل.
مزامنة مجدولة
تُبقي المزامنة في الخلفية القائمة محدَّثة دون أي طلب منك.
معزول ضمن مساحة العمل
هوية الكاتب ونص الرسالة لا يغادران مساحة العمل التي ينتميان إليها أبدًا.
أسئلة حول API التعليقات وصندوق الوارد، مع إجاباتها
ما الشبكات التي تغذّي صندوق الوارد؟
هل يمكنني الرد على الرسائل المباشرة؟
ما سرعة ظهور التعليقات الجديدة؟
هل تستطيع API الرد تلقائيًا؟
هل أحصل على الملف الشخصي للكاتب؟
هل يوجد حدّ لمعدل الطلبات؟
ابنِ على API التعليقات وصندوق الوارد اليوم
البداية مجانية وواجهة API كاملة مُضمَّنة. أنشئ مفتاحًا ونفّذ أول طلب خلال دقائق.
احصل على مفتاح API