אימייל

ערוץ האימייל קולט את האימיילים הנכנסים שלכם ומאפשר ל-pipeline להשיב, להעביר או ליצור משימות בהמשך הזרם.

מבנה

שני מודולים משלימים:

• email_inbound — קבלה (IMAP)
• email_outbound — שליחה (ספק מוגדר, או relay דרך ה-SMTP שלכם)

הם עצמאיים: תוכלו להשתמש רק בנכנס (למיון ללא תשובה), או רק ביוצא (להתראות מ-pipeline שמופעל בדרך אחרת).

הגדרה

1. הגדרות → שירותים → דוא״ל, לשונית חשבונות — חיבור תיבת IMAP עם ה-credentials שלה.
2. מיפוי התיבה לpipeline יעד.
3. (אופציונלי) הגדרת שולח (SMTP) להשבה.

מה ה-pipeline מקבל

עבור כל אימייל נכנס, נוצר exchange חדש עם:

• exchange.user_message — גוף האימייל (HTML → טקסט מנורמל)
• exchange.email.subject — נושא
• exchange.email.from — שולח מנורמל
• exchange.email.thread_id — מזהה שרשור (שימושי להקשר multi-turn)
• exchange.email.attachments — רשימת FileMetadata (קבצים מצורפים מעובדים)

קבצים מצורפים

ניתן להעביר את הקבצים המצורפים לצומת file_transform: טקסט הניתן לבחירה מתוך PDF (pdf_extract_text, ללא OCR — PDF סרוק אינו מחזיר טקסט), קריאת חוברת Excel כשורות (xlsx_to_json, xls_to_json), פיצול PDF או רינדורו כתמונות, חילוץ ארכיון. משם, הסוכן שלכם יכול לעבוד איתם כטקסט או כנתונים מובנים.

Threads והקשר multi-turn

כאשר לקוח משיב לתשובה קודמת, betool מזהה את ה-thread_id ומשחזר את היסטוריית השרשור בהקשר הסוכן. הדבר שקוף לחלוטין לתכנון ה-pipeline.

איכות כתובות והחזרות דואר (bounces)

שלושה צמתים מגנים על המוניטין שלכם כשולחים:

• email_check — בודק כתובת אחת או יותר לפני שליחה: רשימת החסימה של הארגון, תחביר, ולאחר מכן DNS של הדומיין (MX, ובהיעדרו A/AAAA; «null MX» נחשב לדחייה). הוא גם מסמן, מבלי לשנות את הפסיקה, כתובות חד-פעמיות, תיבות כלליות (info@…) וסיכונים (שגיאת הקלדה אצל ספק גדול, סיומת כפולה, שרת «catch-all»). הוא עצמו אינו חוסם דבר: הוא מפרסם את הפסיקות ואת רשימת הכתובות הניתנות למסירה. לא מתבצעת שום בדיקת SMTP.
• email_list_clean — מסווג רשימה שלמה (למשל מקובץ מיובא) לשלושה גיליונות: נקיות, לבדיקה, נדחות, מוכנים לייצוא עם data_to_file. הסרת כפילויות, אותן בדיקות כמו email_check, וניתוח צורת הכתובת. מחויב בקרדיטים לכל כתובת ייחודית, היתרה נבדקת לפני העיבוד.
• email_bounce_parse — קורא הודעת אי-מסירה שהתקבלה בתיבה נכנסת. הכתובות נלקחות רק מהשדות המובנים של ההודעה, לעולם לא מהטקסט החופשי. הן מתווספות לרשימת החסימה: כישלון קבוע חוסם כבר מההופעה הראשונה; כישלון זמני חוסם לאחר 3 הופעות, למשך 72 שעות.

השליחות הבאות (הצומת email_outbound וה-tool email.send) מסירות אוטומטית את הכתובות החסומות; אם לא נותר אף נמען, דבר אינו נשלח. רק מנהל יכול להסיר חסימה קבועה.

מגבלות ידועות

• עדיין אין תמיכה נייטיבית ב-MS Exchange EWS (ניתן לחשוף Exchange דרך IMAP).
• אין תמיכה ב-Microsoft Graph עבור Office 365 (ב-roadmap).
• עיבוד אימיילים ישנים מאוד (Outlook 2003 RTF מקונן) עלול לאבד עיצוב.