מודול וואטסאפ – הגדרות מלאות (זרימת הגדרה בת 3 שלבים)
 

מודול הוואטסאפ ב-Biz1 הוא מערכת תקשורת ניתנת להגדרה מלאה המאפשרת לארגון לחבר וואטסאפ, לנהל זיכויים (קרדיטים), לשלוח מסמכים, ולתקשר עם לקוחות וקבוצות ישירות מהפלטפורמה.
 

הגדרות הוואטסאפ מיושמות כזרימת הגדרה בת 3 שלבים. שלבים אלו מגדירים כיצד וואטסאפ עובד טכנית ותפעולית בתוך המערכת. ללא השלמת הגדרות אלו, דף הוואטסאפ אינו יכול להתחבר, לשלוח הודעות או להשתמש בתבניות.
 

מסמך זה מספק תיאור ארוך ומלא של זרימת הגדרות הוואטסאפ, כולל היכן הן מופיעות, מה עושה כל שלב, כל פרטי ההגדרה, וכיצד הן משמשות את דף הוואטסאפ.
 

---

1. הגדרות וואטסאפ – מטרה כללית
 

זרימת הגדרות הוואטסאפ בת 3 השלבים אחראית על הגדרת:
 

1. זיכויים (קרדיטים) ומנויים (כמה הודעות וואטסאפ ניתן לשלוח)

2. תבניות הודעות (איזו תוכן נשלח עם מסמכים)

3. חיבור ספק (כיצד Biz1 מתחבר לוואטסאפ)
    

הגדרות אלו מפעילות ישירות את דף הוואטסאפ (dashboard/whatsappweb), שבו משתמשים משוחחים בפועל עם לקוחות וקבוצות.
 

בקיצור:
 

הגדרות מגדירות יכולת → דף הוואטסאפ משתמש ביכולת זו

 

---

2. היכן מופיעות הגדרות הוואטסאפ
 

הגדרות הוואטסאפ נגישות מתוך הגדרות אדמין.
 

• מיקום:
  
  dashboard/admin/settings
   

• טריגר (הפעלה):
  
  לחיצה על “וואטסאפ” בסרגל הצד של ההגדרות פותחת את חלון הגדרות הוואטסאפ.
   

• מזהה חלון:
  
  #modal_whatsapp
   

• תנאי נראות:
  
  הגדרות הוואטסאפ מופיעות רק כאשר מודול הוואטסאפ מופעל עבור הארגון
  ($whatsapp_lists_module == '1').
   

• גישה:
  
  זמין בדרך כלל לבעלי ארגונים או למשתמשים עם הרשאות אדמין/הגדרות.
   

כאשר הוא נפתח, החלון טוען אוטומטית את כל נתוני הוואטסאפ הרלוונטיים על ידי קריאה ל-
whatsapp_data_display().
 

---

3. זרימת הגדרות וואטסאפ – מבנה ברמה גבוהה
 

ההגדרות מאורגנות לשלושה שלבים עוקבים, המוצגים עם מחוון התקדמות:
 

1. בחר תוכנית וואטסאפ (שלב 1 מתוך 3)

2. תבניות וואטסאפ (שלב 2 מתוך 3)

3. ספק וואטסאפ (שלב 3 מתוך 3)
    

כל שלב נבנה על קודמו.
 

---

שלב 1 – בחר תוכנית וואטסאפ (תיאור עמוק ומלא)
 

מטרת שלב 1
 

שלב 1 מגדיר כמה הודעות וואטסאפ הארגון יכול לשלוח.
 

הודעות וואטסאפ ב-Biz1 מבוססות זיכויים (קרדיטים). כל הודעת וואטסאפ יוצאת צורכת זיכויים מחבילה פעילה. זיכויים אלו נרכשים באמצעות תוכניות מנוי וואטסאפ.
 

שלב זה משרת שתי מטרות:
 

• הצגת תוכניות וואטסאפ זמינות

• הצגת חבילות שכבר נרכשו (“החבילות שלי”)
   

---

סקירת ממשק משתמש של שלב 1
 

• כותרת: בחר תוכנית וואטסאפ

• מחוון התקדמות: 1/3

• אייקון עזרה

• כפתור סגירה

• קטע כרטיסי תוכניות

• טבלת החבילות שלי

• כפתור הוסף מנוי

• כפתור הבא
   

---

כרטיסי תוכניות זמינים
 

כרטיסי התוכניות מציגים אילו תוכניות וואטסאפ זמינות לרכישה.
 

• תוכניות נטענות מתוך טבלת email_sms_plans

• רק שורות עם type = 'whatsapp' מוצגות
   

כל כרטיס תוכנית מציג:
 

• סוג / נתונים: מספר הודעות וואטסאפ (לדוגמה 500, 1000)

• תוקף: משך התוכנית (לדוגמה חודש אחד)

• מחיר: עלות התוכנית
   

כרטיסים אלו הם אינפורמטיביים עד להוספת מנוי.
 

---

הוסף מנוי
 

לחיצה על “הוסף מנוי” פותחת תת-חלון שבו המשתמש:
 

• בוחר אחת מתוכניות הוואטסאפ

• משלים תשלום או אישור

• שולח את הרכישה
   

עם הצלחה:
 

• רשומה חדשה מוכנסת לטבלת email_sms_plans_paid

• טבלת החבילות שלי מתרעננת אוטומטית
   

---

החבילות שלי (חשוב מאוד)
 

טבלת החבילות שלי מציגה את כל זיכוי הוואטסאפ שבבעלות הארגון כרגע.
 

כל שורה מייצגת חבילת וואטסאפ שנרכשה.
 

שדות מפתח:
 

• סוג: וואטסאפ

• מחיר: מחיר ששולם

• נתונים: סה"כ זיכויים להודעות שנרכשו

• הודעות נותרו: הודעות שנותרו (נתונים − בשימוש)

• תוקף: תקופת תוקף

• תאריך: תאריך יצירה או תפוגה
   

כיצד הזיכויים משמשים
 

בכל פעם ש:
 

• משתמש שולח הודעת וואטסאפ

• אוטומציה שולחת הודעת וואטסאפ

• מסמך נשלח באמצעות וואטסאפ
   

המערכת מפחיתה את “הודעות נותרו” מהחבילה הפעילה.

אם הודעות נותרו = 0, ייתכן ששליחת וואטסאפ תיחסם או תוגבל.
 

---

ניווט משלב 1
 

• הבא → עובר אל תבניות וואטסאפ (שלב 2)

• סגור → יוצא מחלון ההגדרות
   

---

שלב 2 – תבניות וואטסאפ (תיאור עמוק ומלא)
 

מטרת שלב 2
 

שלב 2 מגדיר איזה תוכן נשלח כאשר מסמכים משותפים באמצעות וואטסאפ.
 

תבניות וואטסאפ הן תבניות הודעה מובנות המשמשות בעת שליחת:
 

• הצעות מחיר

• הזמנות רכש

• חשבוניות

• קבלות

• תעודות משלוח

• וסוגי מסמכים אחרים
   

ללא תבניות, הודעות וואטסאפ מבוססות מסמכים לא יכולות להיות מעוצבות כהלכה.
 

---

סקירת ממשק משתמש של שלב 2
 

• כותרת: תבניות וואטסאפ

• מחוון התקדמות: 2/3

• אייקון עזרה

• כפתור סגירה

• כפתור הוסף תבנית

• טבלת תבניות

• ניווט אחורה / קדימה
   

---

הוספה או עריכה של תבניות
 

משתמשים יכולים:
 

• להוסיף תבנית וואטסאפ חדשה

• לערוך תבנית קיימת

• למחוק תבניות
   

כל תבנית מגדירה:
 

• מזהה תבנית

• שם תבנית

• גוף ההודעה

• לאילו סוגי מסמכים היא חלה
   

תבניות נשמרות בטבלת whatsapp_templates ומסודרות לפי position.
 

---

כיצד תבניות משמשות
 

כאשר מסמך נשלח באמצעות וואטסאפ מכל מקום ב-Biz1:
 

1. המערכת מזהה את סוג המסמך

2. היא מחפשת את התבנית התואמת ב-whatsapp_templates

3. תוכן ההודעה מיושם

4. הודעת הוואטסאפ נשלחת באמצעות תבנית זו
    

זה חל על:
 

• שליחות ידניות

• שליחות אוטומטיות

• הודעות מסמכים שנוצרו על ידי המערכת
   

---

ניווט משלב 2
 

• אחורה → חוזר לשלב 1 – בחר תוכנית וואטסאפ

• הבא → עובר אל שלב 3 – ספק וואטסאפ
   

---

שלב 3 – ספק וואטסאפ (תיאור עמוק ומלא)
 

מטרת שלב 3
 

שלב 3 מגדיר כיצד Biz1 מתחבר לוואטסאפ עצמו.
 

זוהי שכבת החיבור הטכנית. ללא ספק מוגדר, דף הוואטסאפ אינו יכול:
 

• לטעון צ'אטים

• לשלוח הודעות

• לקבל הודעות
   

---

ספקים נתמכים
 

Biz1 תומכת במספר ספקי וואטסאפ, כולל:
 

• Green API

• Message Bird

• Whapi

• Higents (עבור ארגונים נבחרים)
   

הספק הנבחר קובע כיצד הודעות נשלחות ומתקבלות.
 

---

Green API (המקרה הנפוץ ביותר)
 

כאשר Green API נבחר:
 

• ניתן להגדיר מופע אחד או יותר (instances)

• כל מופע מייצג מספר וואטסאפ
   

הגדרת מופע כוללת:
 

• idInstance

• apiTokenInstance

• מספר נייד

• דגל מופע ברירת מחדל

• סטטוס הרשאה
   

מספר מופעים מאפשרים:
 

• מספרי וואטסאפ מרובים

• איזון עומסים

• שימוש מבוסס צוות
   

---

שמירת הגדרות ספק
 

כאשר הספק והמופעים נשמרים:
 

• ההגדרות נשמרות ברמת המשתמש/ארגון

• דף הוואטסאפ משתמש באופן מיידי בתצורה זו
   

---

ניווט משלב 3
 

• אחורה → חוזר לשלב 2 – תבניות וואטסאפ

• אין כפתור הבא (זהו השלב האחרון)

• סגירת החלון משלימה את ההגדרה
   

---

קשר עם דף הוואטסאפ (קריטי)
 

דף הוואטסאפ (dashboard/whatsappweb) תלוי לחלוטין בהגדרות אלו.
 

שלב 1 → זיכויים (קרדיטים)
 

שולט על האם ניתן לשלוח הודעות וכמה.
 

שלב 2 → תוכן
 

שולט על אילו תבניות הודעה משמשות כאשר מסמכים נשלחים.
 

שלב 3 → חיבור
 

שולט על כיצד Biz1 מתחבר לוואטסאפ ואיזה מספר משמש.
 

אם שלב כלשהו חסר או לא הושלם:
 

• ייתכן שדף הוואטסאפ לא יטען צ'אטים

• הודעות עלולות להיכשל

• מסמכים עלולים לא להישלח
   

---

זרימת שימוש מקצה לקצה
 

1. אדמין פותח הגדרות → וואטסאפ

2. שלב 1: סוקר תוכניות, רוכש חבילות, בודק זיכויים שנותרו

3. שלב 2: מגדיר תבניות לשליחת מסמכים

4. שלב 3: בוחר ספק ושומר חיבור וואטסאפ

5. משתמשים פותחים את דף הוואטסאפ

6. צ'אטים נטענים באמצעות הספק

7. הודעות צורכות זיכויים

8. מסמכים משתמשים בתבניות
    

---

סיכום סופי
 

ה-הגדרות מלאות של וואטסאפ (זרימת 3 שלבים) הן היסוד של מודול הוואטסאפ ב-Biz1.
 

• שלב 1 שולט בזיכויים

• שלב 2 שולט במבנה הודעה

• שלב 3 שולט בקישוריות טכנית
   

יחד, שלבים אלו מבטיחים שדף הוואטסאפ עובד באופן אמין, מאובטח ובקנה מידה.