תבניות והודעות אוטומטיות

Shipnest שולחת הודעות אוטומטיות בשני אופנים: מבוססות-טריגר (אירוע במשלוח מפעיל שליחה מיידית או מתוזמנת), ומתוזמנות (הודעות שמחכות בתור ונשלחות במועד הנכון דרך ה-cron). את הכל מנהלים תחת מסרונים (/messages).

תבנית היא טקסט עם פרמטרים דינמיים בתחביר {{שם}}, שמתמלאים מנתוני המשלוח בזמן השליחה. הפרמטרים הזמינים כוללים, בין השאר:

• נמען: {{destination_name}}, {{destination_phone}}, {{destination_address}}, {{destination_city}}.
• משלוח: {{barcode}}, {{cod_amount}}, {{current_date}}, {{current_time}}.
• שולח: {{source_name}}, {{source_city}}, {{company_name}}.
• שליח: {{driver_name}}, {{driver_phone}}.
• קישורים: {{tracking_url}} (מעקב), {{validation_url}} (אימות/עדכון כתובת בידי הנמען).

טריגר קושר אירוע במשלוח לתבנית ולערוץ. הטריגרים מבוססי-המשלוח (לפי שינוי סטטוס):

נוצר משלוח           task_created        (UNASSIGNED)
שובץ לשליח איסוף     delivery_accepted  (ASSIGNED)
נאסף                pickup_completed   (ACTIVE)
נקלט במחסן           in_inventory       (IN_INVENTORY)
יצא להפצה            out_inventory      (OUT_INVENTORY)
משלוח הושלם          delivery_completed (COMPLETED)
כשל במסירה           delivery_failed    (FAILED)
משלוח בוטל           task_canceled      (CANCELED)

מגדירים כל טריגר ב-/messages/triggers:

1. בוחרים נמענים — הנמען, השולח, או מספר מותאם.
2. בוחרים תבנית מהספרייה או כותבים טקסט.
3. בוחרים מועד — מיד / סוף היום / בוקר למחרת.
4. בוחרים ערוץ ומפעילים/מכבים את הטריגר.

שני ספקי WhatsApp נתמכים, וניתן להחזיק את שניהם במקביל:

• Meta Cloud API (רשמי) — דורש תבניות מאושרות מראש מ-Meta, תומך בכפתורי קריאה-לפעולה, וכפוף לחלון 24 השעות של שירות לקוחות. ראו חיבור WhatsApp Business.
• Green API (legacy) — שליחת טקסט חופשי ללא אישור תבניות מראש.

בחירת הערוץ אוטומטית: אם לתבנית יש קישור ל-Meta והספק מחובר — נבחר Meta; אחרת Green API. ניתן גם לכפות ערוץ ידנית בשליחה בודדת.

הודעות במועד דחוי נכנסות לתור (ScheduledMessage) ונשלחות ע״י cron, עם עד 3 ניסיונות בכשל. לפני כל שליחה נבדק חלון השליחה:

• שעות פעילות — הודעות נשלחות רק בטווח השעות שהוגדר לטננט (ברירת מחדל 08:00–21:00). זה חל גם על טריגרים שמוגדרים "מיידי": משלוח שנפתח בלילה לא יעיר את הלקוח — ההודעה תיצבר ותישלח כשייפתחו השעות.
• חסימת שבת — בשישי/שבת, לפי מיקום (ירושלים / תל אביב / חיפה / באר שבע) ומצב התחלה (שקיעה / הדלקת נרות). ניתנת לעקיפה.
• חסימת חגים — אופציונלית (כבויה כברירת מחדל); כשמופעלת, חוסמת ימים טובים.
• הודעה שנופלת מחוץ לחלון נשארת בתור ונשלחת אוטומטית כשהחלון נפתח — בלי לבזבז ניסיון.

את ההעדפות מגדירים ב-/messages/preferences.

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

תרחישים#

• גישור "אין מענה" וגישור צפי מסירה — העברת מסרים בין שליח ללקוח.
• כתובת שגויה / טלפון שגוי — איסוף התיקון מהלקוח ועדכון המשלוח אוטומטית.
• בקשת תיאום מועד ודיווח כשל מסירה — כולל אבחנה בין כשל בצד השולח/הנמען (הלקוח מיודע) לכשל פנימי כמו טעות מיון (פתק לצוות בלבד); כשהסיבה לא ברורה הבוט שואל את השליח.
• משלוח ניזוק — שליח מדווח שמשלוח נשבר/נפגם וחוזר; הבוט מיידע את השולח.
• בקשת שידור — שליח מבקש שישדרו אליו משלוח; הבוט מזהה את הברקוד (כולל מתמונה), משבץ, ומשדר.
• אימות קבלה — שליח טוען שהנמען כבר קיבל; הבוט מאמת מול הנמען לפני סימון כנמסר.

ביטויי-מפתח#

לכל תרחיש יש ביטויי-מפתח מובנים (למשל "אין מענה", "כתובת שגויה", "לשדר"). אפשר להוסיף ביטויים מותאמים משלכם ולערוך את תבניות התגובה — הכל ב-/settings/bot-scenarios. הגישוש דטרמיניסטי ומגודר בביטויים, לדיוק מרבי.

כל תבנית שנשלחת דרך Meta Cloud API חייבת אישור מראש מ-Meta. Shipnest מתרגמת את התבנית מפורמט הפרמטרים שלכם ({{customer_name}}) לפורמט המיקומי של Meta ({{1}}, {{2}}), מייצרת ערכי דוגמה, ומגישה לאישור. לאחר האישור התבנית נקשרת לתבנית המקומית ומשמשת בשליחה. פירוט מלא: אישור תבניות WhatsApp.

• תיבת נכנסות (/messages/inbox) — שיחות WhatsApp עם נמענים. צפייה בשרשורים, מענה (בתוך חלון 24 שעות), מדיה, ספירת לא-נקראו, וסטטוס שיחה (ממתין / טופל / בעיבוד) כולל סימון טיפול אוטומטי של ה-AI.
• לקוחות עסקיים (/messages/business-inbox) — צ׳אטים קבוצתיים (שליחים/לקוחות). קישור קבוצה ללקוח/שליח, הודעות עם זיהוי שולח, ואישור/דחייה של פעולות שהבוט מציע. ראו החלטות הבוט.
• סטטיסטיקות עסקי (/messages/business-inbox/stats) — גרף עמודות יומי של ההודעות בצ׳אט העסקי מפולח לפי שולח (AI / לקוחות וואטסאפ / צוות, כולל פילוח פר-משתמש), עם מדדי מענה אוטומטי, הודעות ממתינות, דיווחי כשל וזמני תגובה.

ב-/messages/analytics רואים פילוח שימוש ועלות: סך הודעות (נכנסות/יוצאות, Meta מול Green API), כשלים, וסיווג שיחות — Utility (ביוזמת העסק, בתשלום) מול Service (ביוזמת הלקוח, חינם בתוך החלון). העלות מוצגת בדולר ובש״ח (לפי שער מתעדכן).