שליחת הודעות הזמנה ב-WhatsApp מ-Shopify

איך Shopify Flow שולח הודעת WhatsApp?

באמצעות הפעולה Send HTTP request, ששולחת בקשה לכל כתובת URL עם כותרות וגוף שיכולים להשתמש במשתני Liquid מהטריגר.

בונים תהליך עבודה על הטריגר של יצירת הזמנה ומוסיפים את Send HTTP request. כתובת ה-URL היא נקודת הקצה של ההודעות ב-Cloud API עבור מזהה המספר המחובר. מוסיפים כותרת Authorization שערכה Bearer ואחריו אסימון הגישה של המספר, השמור כסוד ב-Flow ומופנה כמשתנה סוד. ערכי סוד אינם מוצגים בממשק של Flow ומוסתרים מיומני ההרצה, וזה המקום הנכון לאסימון. הגוף הוא הודעת תבנית, כשמספר הטלפון של הלקוח נמצא בשדה to ופרטי ההזמנה הם הפרמטרים של התבנית.

Flow רואה תגובה 2XX או 3XX כהצלחה. Meta עונה לבקשה תקינה עם מזהה ההודעה, ולכן הרצה מוצלחת אומרת ש-Meta קיבלה את ההודעה.

{
  "messaging_product": "whatsapp",
  "to": "<customer phone, digits only>",
  "type": "template",
  "template": {
    "name": "order_confirmation",
    "language": { "code": "en" },
    "components": [{
      "type": "body",
      "parameters": [{ "type": "text", "text": "{{order.name}}" }]
    }]
  }
}

למה הודעת הזמנה חייבת להיות תבנית?

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

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

יש גם עניין ההסכמה. Meta דורשת הסכמה מראש (opt-in) לפני שעסק שולח הודעה למישהו ב-WhatsApp: האדם מסר את מספרו והסכים לקבל הודעות מהעסק הזה. תיבת סימון בקופה שמציינת זאת היא הדרך הנפוצה לאסוף אותה, ותהליך העבודה צריך לבדוק אותה לפני השליחה.

מה עושים אם התוכנית של החנות לא כוללת את Send HTTP request?

משתמשים במקום זאת בוובהוק של מנהל Shopify. תחת הגדרות, התראות, וובהוקים אפשר ליצור וובהוק לאירוע כמו יצירת הזמנה, בפורמט JSON, לכתובת URL. מכוונים אותו לשרת קולט: צומת Webhook של n8n, או נתיב ב-PHP, ב-Python או ב-Node. השרת קורא את ההזמנה, בודק הסכמה ושולח את אותה קריאת תבנית ל-Cloud API.

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

טעויות נפוצות

• שליחת טקסט חופשי עם יצירת הזמנה. הלקוח עדיין לא כתב, ולכן Meta דוחה אותה; חייבים להשתמש בתבנית מאושרת.
• השארת הטיפול בשגיאות על Retry עבור תגובות 4XX. Flow יכול לנסות שוב עד 24 שעות בקשה ש-Meta לעולם לא תקבל.
• הצבת האסימון בכותרת כטקסט גלוי. שומרים אותו כסוד ב-Flow כדי שלא יופיע בממשק וביומנים.

שאלות נפוצות

המשיכו לקרוא