سرد المحادثات مع جهة اتصال
كل سلسلة كتبها العنوان أو كُتبت إليه، في كل المجلدات: تبويب البريد في جهة اتصال في التطبيق. ولا يلزم أن يكون العنوان جهة اتصال محفوظة. يصل `limit` إلى 100 وقيمته الافتراضية 25، ويعود `nextCursor` بوصفه `cursor` ما دام `hasMore` صحيحًا.
ينفّذ الاستدعاء الحقيقي على مساحة عملك، بمفتاحك أنت.
GET /contacts/{email}/threads
كل سلسلة كتبها العنوان أو كُتبت إليه، في كل المجلدات: تبويب البريد في جهة اتصال في التطبيق. ولا يلزم أن يكون العنوان جهة اتصال محفوظة. يصل limit إلى 100 وقيمته الافتراضية 25، ويعود nextCursor بوصفه cursor ما دام hasMore صحيحًا.
مثال
يتطلب threads:read، لأنه يقرأ البريد لا جهة الاتصال.
curl "$OE/contacts/ada%40example.com/threads?q=invoice&sort=newest" -H "$AUTH"{ "object": "list", "data": [ { "object": "thread", "id": "thr_5d31c2a8…", "subject": "Invoice 2026-09", "from": { "name": "Ada Lovelace", "email": "[email protected]" }, "receivedAt": "2026-09-22T16:04:11.000Z", "messageCount": 3, "hasUnread": true, "labels": [{ "id": "INBOX", "name": "Inbox" }] } ], "hasMore": false, "nextCursor": null}يبحث q داخل تلك السلاسل بصياغة البحث في الصندوق. وsort هو newest (الافتراضي) أو oldest أو sender أو subject. أعِد cursor مع q وsort نفسيهما.
كل صف ملخص. ويقرأ GET /threads/{id} الرسائل التي خلفه.