الوثائق

البريد الإلكتروني

البريد الوارد (IMAP) والصادر. حفظ السلاسل، تحليل المرفقات.

البريد الإلكتروني

تستوعب قناة البريد الإلكتروني رسائلك الواردة، وتتيح لـpipeline الردّ عليها أو إعادة توجيهها أو إنشاء مهام لاحقة.

النموذج

وحدتان متكاملتان:

  • email_inbound — الاستقبال (IMAP)
  • email_outbound — الإرسال (مشغّل مُهيَّأ، أو ترحيل عبر SMTP الخاص بك)

وهما مستقلّتان: يمكنك استخدام وحدة الاستقبال فقط (للفرز دون الردّ)، أو وحدة الإرسال فقط (لإرسال الإشعارات من pipeline مُشغَّل بطريقة أخرى).

الإعداد

  1. الإدارة ← البريد الإلكتروني ← صناديق البريد — اربط صندوق بريد IMAP ببيانات اعتماده.
  2. اربط صندوق البريد بـpipeline مستهدَف.
  3. (اختياري) هيّئ مُرسِلًا (SMTP) للردّ.

بالنسبة إلى البنى التي تحتاج إلى الاحتفاظ بالتحكّم في خوادم بريدها، فإنّ betool لا يستبدل خادم MTA الخاص بك: نحن نقرأ ونكتب عبر IMAP / SMTP القياسي.

ما يستقبله الـpipeline

لكل بريد وارد، يُنشأ exchange جديد يحتوي على:

  • exchange.user_message — نصّ البريد (HTML ← نصّ مُطبَّع)
  • exchange.email.subject — سطر الموضوع
  • exchange.email.from — المُرسِل المُطبَّع
  • exchange.email.thread_id — مُعرِّف السلسلة (مفيد لسياق متعدّد الدورات)
  • exchange.email.attachments — قائمة FileMetadata (مرفقات مُحلَّلة)

المرفقات

تُمرَّر المرفقات إلى عقدة file_transform للاستخراج (نصّ صِرف، OCR لملفات PDF الممسوحة، تحليل مُهيكَل لـCSV / Excel). ومن هناك، يستطيع وكيلك التعامل معها كما لو كانت نصًّا أصليًا.

السلاسل والسياق متعدّد الدورات

عندما يردّ عميل على ردّ سابق، يتعرّف betool على thread_id ويستعيد سِجلّ السلسلة في سياق الوكيل. وهذا شفّاف بالنسبة إلى تصميم الـpipeline.

القيود المعروفة

  • لا يوجد دعم أصيل لـMS Exchange EWS بعد (يمكنك عرض Exchange عبر IMAP).
  • لا يوجد دعم لـMicrosoft Graph لـOffice 365 (ضمن خارطة الطريق).
  • تحليل رسائل قديمة جدًا (تنسيق RTF المتداخل في Outlook 2003) قد يفقد بعض التنسيق.