> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senderz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# מושגי יסוד

> מודל הנתונים ותהליך השליחה: סביבות עבודה, אנשי קשר, פלחים, קמפיינים, אוטומציות.

הבנת שישה אובייקטים מסבירה כמעט הכול ב-Senderz.

## האובייקטים

<CardGroup cols={2}>
  <Card title="סביבת עבודה" icon="building">
    הדייר שלכם. כל איש קשר, קמפיין, דומיין ואינטגרציה שייכים לסביבה אחת בדיוק.
  </Card>

  <Card title="איש קשר" icon="user">
    נמען. נושא זהות, הסכמה לכל ערוץ, תגיות, מאפיינים מותאמים וציונים חזויים.
  </Card>

  <Card title="פלח" icon="filter">
    מסנן חי מעל אנשי הקשר. פלחים דינמיים מחושבים מחדש בכל קריאה; פלחים סטטיים הם
    רשימת חברות קבועה.
  </Card>

  <Card title="קמפיין" icon="paper-plane">
    שליחה חד-פעמית לפלח בערוץ יחיד — אימייל, SMS או התראות.
  </Card>

  <Card title="אוטומציה" icon="bolt">
    תהליך שמופעל מאירוע. מגיב לעד עם טיימרים, הסתעפויות וצעדים רב-ערוציים.
  </Card>

  <Card title="תבנית" icon="file-lines">
    תוכן לשימוש חוזר. בלוקים לאימייל, HTML גולמי, טקסט SMS או התראת דפדפן.
  </Card>
</CardGroup>

## מזהים ציבוריים מול פנימיים

**מזהה סביבת העבודה** — הערך שאתם שולחים כ-`X-Sender-Tenant` — הוא ה-slug של הסביבה (מחרוזת קצרה וקריאה), לא ה-UUID הפנימי. ה-API מקבל את שניהם.

## תהליך השליחה

כל הודעה — קמפיין, אוטומציה, בדיקה או טרנזקציה — עוברת דרך אותם שערים באותו סדר. לכן באג בבונה אינו יכול לייצר שליחה לא-חוקית: האכיפה חיה ב-worker, לא בממשק.

<Steps>
  <Step title="חסימות (Suppression)">
    ריבאונדים קשים, תלונות והסרות חוסמים איש קשר תוך שניות.
  </Step>

  <Step title="הסכמה">
    לנמען חייבת להיות הסכמה מתועדת לאותו ערוץ. מקור, IP, זמן וערוץ נרשמים.
  </Step>

  <Step title="תקרות תדירות ושעות שקט">
    תקרות לכל איש קשר, משותפות בין ערוצים. שיווק ב-SMS, קול והתראות למספרים
    ישראליים מכבד שעות שקט ושבת. אימייל פטור מהחסימה החוקית.
  </Step>

  <Step title="ארנק SMS (ל-SMS בלבד)">
    שום SMS של דייר לא מגיע לספק ללא אישור ארנק.
  </Step>

  <Step title="חתימת DKIM (לאימייל בלבד)">
    נחתם ב-worker באמצעות מפתח לכל דייר ב-AWS KMS.
  </Step>

  <Step title="שיגור לספק">
    אימייל דרך שרשרת ספקים עם failover; SMS דרך ספקים ישראליים; התראות דרך Web
    Push; קול דרך TTS.
  </Step>
</Steps>

## מצבי הסכמה

לכל ערוץ באיש קשר יש אחד מארבעה מצבים:

<ParamField path="subscribed">רשום — יכול לקבל שיווק בערוץ.</ParamField>
<ParamField path="unsubscribed">הוסר — שיווק חסום; טרנזקציה/OTP עדיין מותרים.</ParamField>
<ParamField path="never_subscribed">לא נרשמה הסכמה מעולם — ברירת המחדל השמרנית בייבוא.</ParamField>
<ParamField path="cleaned">הוסר בניקוי (למשל ריבאונדים חוזרים).</ParamField>

## שיווק מול טרנזקציה

דואר טרנזקציוני — אישורי הזמנה, איפוס סיסמה, קודי OTP — עובר ב**מסלול נפרד** שמדלג על תקרות תדירות ושעות שקט. ההפרדה היא ברמת סוג-ההודעה, לא ברמת הקמפיין.

<Warning>
  אל תנסו לשלוח תוכן שיווקי דרך ה-API הטרנזקציוני כדי לעקוף שעות שקט או הסכמה.
  שערי התאימות מגנים על המוניטין שלכם ועל חשבונות הספקים המשותפים של הפלטפורמה.
</Warning>