יועציםהקריאה שומרת מייל נכנס בכרטיס הלקוח. היא המסלול לתיבות שאינן אופיס 365 — Gmail או
כל שרת מייל אחר. למי שעובד עם אופיס יש
חיבור ישיר, בלי API.
ההגדרה במסך
במסך מודולים וממשקים, בבלוק Gmail או כל מייל אחר, מפעילים את שיוך אוטומטי
של מיילים נכנסים. נדרשת הרשאת הגדרות מערכת.
לוחצים הפקת קוד חדש, והמסך מציג כתובת ייעודית לכל משתמש פעיל. מעתיקים את הכתובת
של המשתמש ומגדירים ב-MAKE (Integromat) שליחה אליה בכל מייל שנכנס לתיבה שלו.
נדרש חשבון MAKE.
המודול בתשלום: 20 ₪ לכל משתמש, כמו בחיבור לאופיס.
POST https://app.yoatsim.co.il/api/MailGeneral/AAA?token=BBB
AAA — מזהה המשתמש שאליו שייכת התיבה.
BBB — המזהה הייחודי של החברה, מהכפתור הפקת קוד חדש באותו מסך.
המסך מציג את הכתובת המלאה והמוכנה לכל משתמש פעיל, שורה בטבלה לכל אחד.
גוף הקריאה
{
"From": "[email protected]",
"To": "[email protected]",
"CC": "",
"Subject": "נושא ההודעה",
"Body": "<html>גוף ההודעה</html>",
"Created": "2026-08-16T09:30:00+03:00",
"ID": "מזהה ההודעה בתיבה",
"HasAttachments": false,
"Files": []
}
| שדה | תוכן |
|---|---|
From |
כתובת השולח. לפיה נקבע מי המשתמש ששלח, כשמדובר במייל יוצא |
To |
כתובת הנמען |
CC |
עותקים |
Subject |
נושא ההודעה. נשמר כשורת הנושא של הפעילות |
Body |
גוף ההודעה, כולל ה-HTML. חובה — בתוכו נמצא זיהוי הכרטיס |
Created |
מועד ההודעה. נשמר כזמן הפעילות |
ID |
מזהה ההודעה בתיבה |
HasAttachments |
האם יש קבצים מצורפים |
Files |
רשימת הקבצים |
איך נקבע לאיזה כרטיס המייל נכנס
הזיהוי נמצא בתוך Body, לא בכתובת השולח. המערכת שותלת בכל מייל שיוצא ממנה סימן
זיהוי נסתר, שנושא את מזהה הכרטיס, ומחפשת אותו בהודעה שמגיעה בקריאה.
מכאן שלוש התנהגויות שחשוב להכיר:
- נשמרות תשובות למיילים שיצאו מהמערכת. הודעה שאין בה את הסימן לא תישמר, והקריאה
תחזור בהצלחה בלי שנוצר דבר - לא נפתח כרטיס חדש מהודעה שלא זוהתה
- הסימן מוסר מגוף ההודעה לפני השמירה, כך שהוא לא מופיע בכרטיס
כפילויות נחסמות: הודעה עם אותו מזהה, אותו שולח ואותו נושא שכבר נשמרה באותו
כרטיס בחמש הדקות האחרונות לא תישמר פעמיים.
שליפת מייל ידני
בשדה Webhook לשליפת מייל ידני מזינים כתובת שאליה המערכת פונה כדי למשוך
הודעות לפי דרישה — הכיוון ההפוך מהקריאה שלמעלה.
היא שולחת:
{ "UserID": 123, "From": "[email protected]", "Fetch": 10 }
ומצפה לקבל בחזרה מערך הודעות באותו מבנה של גוף הקריאה. תשובה Accepted נחשבת
לריקה.
כשזה לא עובד
הקריאה מחזירה הצלחה אבל אין פעילות בכרטיס — לא נמצא סימן הזיהוי ב-Body. זה
המצב הרגיל בכל מייל שלא מהווה תשובה למייל שיצא מהמערכת.
שום מייל לא נשמר — הטוקן לא תואם למזהה הייחודי של החברה, המשתמש אינו פעיל, או
שהחברה אינה פעילה. בכל אחד מהמקרים האלה הקריאה מסתיימת בשקט.
ה-Body מגיע כטקסט בלבד — הסימן מוטמע ב-HTML של ההודעה. שליחה של הגרסה
הטקסטואלית בלבד תמנע כל זיהוי.