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

# תבניות WhatsApp

> יצירה, הגשה לאישור וניהול תבניות הודעות WhatsApp להודעות יוצאות ב-Tedro.

# תבניות WhatsApp

תבניות הודעות WhatsApp הן פורמטים מאושרים מראש הנדרשים לשליחת הודעות יוצאות מחוץ לחלון שירות הלקוחות של 24 שעות. יש להגיש תבניות ל-Meta לאישור לפני השימוש. לאחר אישור, השתמשו בהן בשידורים, צמתי תהליך עבודה ופנייה יזומה.

<Warning>
  **Meta דורשת אישור תבניות.** לא ניתן לשלוח הודעות WhatsApp יוצאות ללא תבנית מאושרת כשנמצאים מחוץ לחלון 24 השעות מהודעת הלקוח האחרונה. זו מדיניות WhatsApp Business API, לא מגבלה של Tedro.
</Warning>

## דרישות מוקדמות

* סביבת עבודה ב-Tedro עם תפקיד **Admin**
* ערוץ WhatsApp מחובר
* גישה ל-Meta Business Suite לניהול תבניות

## הבנת חלון 24 השעות

WhatsApp אוכפת **חלון שירות לקוחות**:

| תרחיש                                 | מה ניתן לשלוח                                                 |
| ------------------------------------- | ------------------------------------------------------------- |
| **בתוך 24 שעות** מהודעת הלקוח האחרונה | הודעות חופשיות (כל טקסט, מדיה, כפתורים) דרך `wa.send_message` |
| **מחוץ ל-24 שעות**                    | רק תבניות מאושרות מראש דרך `wa.send_template`                 |

כשחלון 24 השעות פג, הדרך היחידה לשלוח הודעה לאיש קשר היא דרך תבנית מאושרת. לכן תבניות חיוניות לשידורים, מעקבים ומעורבות חוזרת.

## יצירת תבנית

<Steps>
  ### פתיחת ניהול תבניות

  עברו אל **Outbound > Templates** בסרגל הצד. לחצו על **Create Template**.

  ### בחירת קטגוריה

  בחרו את קטגוריית התבנית כנדרש על ידי Meta:

  | קטגוריה            | תרחיש שימוש                                 |
  | ------------------ | ------------------------------------------- |
  | **Marketing**      | מבצעים, הצעות, הודעות מוצר                  |
  | **Utility**        | עדכוני הזמנה, תזכורות לפגישות, התראות חשבון |
  | **Authentication** | סיסמאות חד-פעמיות, קודי אימות               |

  <Note>
    Meta גובה תעריפים שונים לפי קטגוריה. תבניות Utility בדרך כלל עולות פחות מתבניות Marketing.
  </Note>

  ### חיבור התבנית

  הזינו את תוכן התבנית:

  * **כותרת** (אופציונלי) -- טקסט, תמונה, סרטון או מסמך
  * **גוף** (חובה) -- טקסט ההודעה העיקרי. השתמשו ב-`{{1}}`, `{{2}}` וכדומה כמצייני מקום לערכים דינמיים
  * **כותרת תחתונה** (אופציונלי) -- טקסט קטן מתחת לגוף (לדוגמה, "השיבו STOP להסרה מרשימה")
  * **כפתורים** (אופציונלי) -- כפתורי קריאה לפעולה או תשובה מהירה (עד 3)

  דוגמה לגוף עם פרמטרים:

  ```
  שלום {{1}}, ההזמנה {{2}} שלך נשלחה! מועד הגעה צפוי: {{3}}.
  ```

  ### בחירת שפה

  בחרו את השפה לתבנית. ניתן ליצור את אותה תבנית במספר שפות לפלחי קהל שונים.

  ### הגשה לאישור

  לחצו **Submit**. התבנית נשלחת ל-Meta לבדיקה. אישור מתקבל בדרך כלל תוך דקות עד כמה שעות, אם כי חלק מהתבניות עשויות להימשך עד 24 שעות.
</Steps>

## סטטוס תבנית

| סטטוס      | משמעות                                                    |
| ---------- | --------------------------------------------------------- |
| **ממתין**  | הוגשה ל-Meta, ממתינה לבדיקה                               |
| **מאושרת** | מוכנה לשימוש בשידורים וצמתי תהליך עבודה                   |
| **נדחתה**  | Meta דחתה את התבנית. סקרו את סיבת הדחייה וערכו/הגישו מחדש |

<Tip>
  אם תבנית נדחתה, בדקו את [הנחיות התבניות של Meta](https://developers.facebook.com/docs/whatsapp/message-templates/guidelines/) לסיבות דחייה נפוצות: תוכן מטעה, חוסר שפת opt-out או הפרות מדיניות.
</Tip>

## שימוש בתבניות

תבניות מאושרות ניתנות לשימוש בשני מקומות:

1. **שידורים** -- בחרו תבנית בעת יצירת שידור WhatsApp. פרמטרי התבנית ממולאים עם נתוני איש הקשר או ערכים מותאמים. ראו [שידורים וקמפיינים](/he/outbound/broadcasts-campaigns).

2. **צמתי תהליך עבודה** -- השתמשו בצומת `wa.send_template` לשליחת תבניות באופן תכנותי. הגדירו את שם התבנית, שפה ומיפוי פרמטרים בהגדרות הצומת. ראו הפניית [צמתי WhatsApp](/he/nodes/whatsapp-nodes).

## פרמטרי תבנית

פרמטרים הם מצייני מקום דינמיים שמוחלפים בערכים בפועל כשהתבנית נשלחת:

| פרמטר   | ערך לדוגמה  | מקור                           |
| ------- | ----------- | ------------------------------ |
| `{{1}}` | "שרה"       | שם איש הקשר                    |
| `{{2}}` | "ORD-12345" | שדה מותאם או משתנה תהליך עבודה |
| `{{3}}` | "15 במרץ"   | ערך מחושב                      |

בצמתי תהליך עבודה, מפו פרמטרים באמצעות משתני הקשר כמו `{{contact.name}}` או `{{conversation.fields.order_id}}`.

## טיפול ב-Opt-Out

WhatsApp דורשת שתבניות Marketing יכללו דרך לאנשי קשר לבצע opt-out. כאשר איש קשר משיב STOP, UNSUBSCRIBE או מילות מפתח דומות:

* Tedro מגדירה אוטומטית `opted_out = true` ברשומת איש הקשר
* שידורים ושליחות תבניות עתידיים נחסמים לאיש קשר זה
* ה-opt-out נרשם בציר הזמן של פעילות איש הקשר

## מה הלאה

<CardGroup cols={2}>
  <Card title="שידורים וקמפיינים" icon="megaphone" href="/he/outbound/broadcasts-campaigns">
    שלחו תבניות מאושרות לקבוצות אנשי קשר עם תזמון ואנליטיקה.
  </Card>

  <Card title="צמתי WhatsApp" icon="message-square" href="/he/nodes/whatsapp-nodes">
    השתמשו ב-wa.send\_template בתהליכי האוטומציה שלכם.
  </Card>
</CardGroup>