# תבנית הפעלה לבוט WhatsApp עסקי

## 1. מטרת הגרסה
- פעולה אחת שהבוט משלים:
- תוצאה עסקית מדידה:
- מה הבוט לא עושה:
- בעל מוצר:
- אחראי שירות ומחליף:

## 2. קהל וכניסות
| קוד מקור | נקודת כניסה | ציפיית המשתמש | סוג הסכמה |
|---|---|---|---|
| site_service | כפתור בעמוד שירות | פתיחת בקשת חזרה | טיפול בפנייה |
|  |  |  |  |

## 3. נתונים נחוצים
| שדה | חובה | למה הוא משנה החלטה | מערכת יעד | זמן שמירה |
|---|---|---|---|---|
| full_name | כן | מאפשר לנציג לזהות פונה | CRM | לפי מדיניות העסק |
|  |  |  |  |

## 4. תיעוד הסכמה
- consent_scope:
- consent_source:
- consent_text_version:
- consent_at:
- opt_out_at:
- בעלים לאישור משפטי או פרטיות:

## 5. מצבי שיחה
| מצב | אירוע כניסה | פעולה מותרת | מצב יציאה | חריגה לנציג |
|---|---|---|---|---|
| awaiting_intent | ברכה נכנסת | הצגת מטרות | collecting_details | שתי תשובות לא מובנות |
|  |  |  |  |  |

## 6. נוסחי הודעות
### פתיחה
[מי העסק, מה אפשר לבצע, איך מגיעים לנציג ואיך מבקשים הסרה]

### בקשת נתון
[שאלה אחת בלבד]

### אישור לפני פעולה
[סיכום הנתונים, מה יקרה ומה עדיין לא הובטח]

### כשל
[מה לא הצליח, מה הועבר לאדם, ומה אין צורך לשלוח שוב]

### העברה לנציג
[מה הועבר ומתי צפוי טיפול בלי הבטחה לא מבוססת]

### הסרה
[אישור קצר והיקף ההסרה]

## 7. חוזה אירועים
- conversation_id:
- message_id:
- state_version:
- idempotency_key:
- event_type:
- occurred_at:
- payload מינימלי:
- נתונים שאסור להעתיק:

## 8. מטריצת אחריות
| רכיב | בעל חשבון | בעל תפעולי | מחליף | ערוץ הסלמה |
|---|---|---|---|---|
| WhatsApp Business Platform |  |  |  |  |
| אוטומציה |  |  |  |  |
| CRM |  |  |  |  |
| תור שירות |  |  |  |  |

## 9. מבחני קבלה
| ID | תנאי פתיחה | צעדים | תוצאה צפויה | ראיה | עבר או נכשל |
|---|---|---|---|---|---|
| WA-01 | איש קשר חדש | השלמת המסלול ואישור | ליד אחד וסיכום אמין | מזהה ליד ואירועים |  |
| WA-02 | אותו אירוע זמין פעמיים | שליחת webhook כפול | אין פעולה כפולה | duplicate_ignored |  |
| WA-03 | CRM אינו זמין | השלמת המסלול | אין הצלחה ונוצרת משימה | מזהה שגיאה ומשימה |  |
| WA-04 | איסוף פרטים פעיל | כתיבת נציג | עצירת אוטומציה והעברת הקשר | מצב וסיכום |  |
| WA-05 | הודעה מתוזמנת קיימת | כתיבת הסרה | ביטול המשלוח ועדכון הסכמה | opt_out_at |  |
| WA-06 | מצב חדש כבר נשמר | הגעת אירוע ישן | המצב אינו נדרס | גרסאות מצב |  |

## 10. שער השקה
- [ ] כל בדיקות הפרטיות, ההסרה והכפילות עברו
- [ ] אין הודעת הצלחה במסלול כשל
- [ ] נוהל ההשבתה נוסה
- [ ] נציג מקבל הקשר מלא
- [ ] תבניות, חלון ומגבלות אומתו מול Meta בזמן השחרור
- [ ] מקור התנועה הראשון מוגדר ומוגבל

## 11. נוהל תקלה
1. עצרו שליחה אוטומטית אם יש סיכון ללקוח או להסכמה.
2. אתרו לפי conversation_id ו-message_id.
3. זהו את השכבה האחרונה שהצליחה.
4. בדקו idempotency לפני ניסיון חוזר.
5. העבירו לנציג עם סיכום אם אין פתרון בטוח.
6. שמרו ראיה, סיבה ותיקון בלי לשכתב היסטוריה.

## 12. אישורי מסירה
- שירות: שם, תאריך והערות
- תפעול: שם, תאריך והערות
- פרטיות או משפטי: שם, תאריך והערות
- מיישם: גרסת שחרור, תאריך וקישור לראיות