الاستقبال
التصنيفات والمجموعات
افرز البريد المرسل والمستلَم في تصنيفات تلقائيًا، وامنح وكيلًا مجموعة لا تغادرها محادثاته.
التصنيفات
يعمل التصنيف مثل مجلد في Gmail. يمكن أن تحمل الرسالة حتى 10 تصنيفات، ويمكن أن تضم مساحة العمل 200 تصنيف. أنشئ تصنيفًا بـ POST /labels، واعرضها مع أعداد الرسائل وغير المقروءة بـ GET /labels، واقرأ تصنيفًا واحدًا بـ GET /emails?label=Billing. يمكن الإشارة إلى التصنيفات بالاسم أو بمعرّف lbl_ في كل مكان.
الإرسال إلى تصنيف
{
"from": "Orders <orders@example.com>",
"to": [
"customer@example.net"
],
"subject": "Order 1042",
"text": "Reply with a delivery window.",
"labels": [
"Agent/Orders"
]
}تُنشأ أسماء التصنيفات غير المعروفة. وترث كل رسالة لاحقة في المحادثة، بما فيها ردود العميل، تصنيفات المحادثة.
المجموعات
أنشئ تصنيفًا مع "skip_inbox": true لتحويله إلى مجموعة. يُؤرشَف البريد المستلَم الذي يحصل على تصنيف مجموعة، سواء من قاعدة فرز أو من ردّ على محادثة مصنَّفة أو من POST /emails/:id/labels، فيظهر داخل التصنيف فقط ولا يظهر أبدًا في صندوق الوارد. أما البريد المرسل فلا يظهر في صندوق الوارد أبدًا. وبذلك تبقى محادثات مهام الوكيل في مكان واحد في الاتجاهين.
{
"name": "Agent/Orders",
"skip_inbox": true,
"rules": [
{
"inbox_id": "inb_…"
}
],
"apply_to_existing": true
}قواعد الفرز
تفرز القواعد البريد الجديد تلقائيًا. يجب أن تتحقق كل الشروط المضبوطة في القاعدة: inbox_id (العنوان المستقبِل)، وdirection (in أو out)، ومقاطع نصية من from وto (To وCc) وsubject دون مراعاة حالة الأحرف. أما skip_inbox الخاصة بالقاعدة فتؤرشف البريد المستلَم الذي تطابقه فقط. أضف القواعد بـ POST /labels/:id/rules؛ ويفرز apply_to_existing البريد المحفوظ أيضًا.
العمل مع مجموعة
استعلم دوريًا عبر GET /emails?label=Agent%2FOrders&direction=in&unread=true، واقرأ المحادثة بـ GET /threads/:id، وردّ باستخدام reply_to_email_id، ثم علّم الرسالة على أنها عولجت بـ PATCH /emails/:id مع {"read": true}. انقل رسالة إلى تصنيف أو خارجه بـ POST /emails/:id/labels مع {"add": [...], "remove": [...]}. يوفّر خادم MCP العمليات نفسها بالأسماء create_label وcreate_label_rule وlabel_email وlist_emails.