StoreChart
מילון מונחים

Webhook

נכתב על ידי צוות StoreChart3 דקות קריאה

בקצרה

Webhook היא בקשת HTTP אוטומטית שמערכת אחת שולחת לכתובת URL במערכת אחרת ברגע שמתרחש אירוע, כמו הזמנה חדשה או תשלום. במקום שהמערכת הקולטת תשאל שוב ושוב אם משהו השתנה (polling), המערכת השולחת דוחפת את נתוני האירוע, בדרך כלל בפורמט JSON, מיד כשהוא קורה.

חיבור בין שתי מערכות מסתכם בדרך כלל בשאלה אחת: איך מערכת ב' יודעת שמשהו קרה במערכת א'? היא יכולה לשאול כל כמה דקות, וזה איטי ובזבזני, או שמערכת א' תודיע לה מיד. Webhook הוא האפשרות השנייה. כשנכנסת הזמנה, נשלח טופס או עובר תשלום, מערכת המקור שולחת הודעת HTTP קצרה לכתובת שהמערכת הקולטת רשמה מראש. וובהוקים עומדים מאחורי רוב האינטגרציות בזמן אמת באיקומרס, ולהבין איך הם נכשלים חשוב בדיוק כמו להבין איך הם עובדים. בהמשך: מה זה Webhook, איך הוא עובד, דוגמה ורשימת טעויות נפוצות.

מה זה Webhook

Webhook היא בקשת HTTP אוטומטית שמערכת אחת שולחת לכתובת URL במערכת אחרת ברגע שמתרחש אירוע, כמו הזמנה חדשה או תשלום.

  • כיוון: דחיפה חד-כיוונית מהמערכת השולחת לכתובת הקולטת.
  • פורמט: נתוני האירוע נשלחים בדרך כלל ב-JSON.
  • ההבדל מ-polling: המערכת הקולטת לא צריכה לשאול שוב ושוב אם משהו השתנה.

איך Webhook עובד

  1. רישום. המערכת הקולטת מוסרת לשולחת כתובת URL ובוחרת לאילו אירועים היא רוצה להירשם, למשל "הזמנה נוצרה".
  2. אירוע. משהו קורה במערכת השולחת.
  3. מסירה. השולחת מבצעת בקשת POST לכתובת, עם נתוני האירוע בגוף הבקשה ומטא-דאטה כמו סוג האירוע וחתימה בכותרות.
  4. אישור. הצד הקולט בודק את הבקשה, שומר או מעבד אותה, ועונה בקוד סטטוס 2xx. כל תשובה אחרת, או היעדר תשובה, נחשבים כישלון, ושולחים רבים מנסים שוב.

דוגמה: מטען של הזמנה

כך יכול להיראות מטען (payload) של הזמנה, בדוגמה מומצאת:

{
  "event": "order.created",
  "order_id": "1042",
  "total": 249.9,
  "currency": "ILS",
  "customer": { "name": "Dana Levi", "phone": "050-0000000" }
}

Webhook מול polling

  • polling: המערכת הקולטת פונה ל-API של המערכת השנייה לפי לוח זמנים ושואלת אם יש משהו חדש. זה פשוט ומתקן את עצמו, אבל תמיד מאחר בעד מחזור אחד, ורוב הקריאות חוזרות ריקות.
  • וובהוקים: מגיעים תוך שניות ולא עולים כלום כשלא קורה כלום.
  • בפועל: משלבים את השניים. וובהוקים בשביל המהירות, וסנכרון API מדי פעם כדי לתפוס מה שפוספס.

איך לקלוט וובהוקים בבטחה

  • לאמת את השולח. פלטפורמות חותמות על כל מסירה עם סוד משותף. WooCommerce שולחת כותרת X-WC-Webhook-Signature ו-Shopify שולחת X-Shopify-Hmac-Sha256, והצד הקולט מחשב את החתימה מחדש ודוחה אי-התאמה. כשאין חתימה, טוקן סודי וארוך בכתובת משמש כאמצעי הזיהוי.
  • לטפל בכפילויות. בגלל ניסיונות חוזרים אותו אירוע יכול להגיע פעמיים. מזהים כפילות לפי מזהה אירוע או הזמנה, כדי שהזמנה אחת לא תהפוך לשתיים.
  • לענות מהר. עיבוד איטי גורם לפסק זמן, שגורם לניסיון חוזר, שיוצר עוד עומס.
  • לתעד כל מסירה. כששתי מערכות לא מסכימות, יומן המסירות הוא המקום הראשון לבדוק.

Webhook בחנות אונליין

כמעט כל יכולת "בזמן אמת" באיקומרס, מהתראה על הזמנה חדשה ועד ליד שמופיע ב-CRM, מתחילה ב-webhook.

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

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

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

Webhook ב-StoreChart

StoreChart קולטת וובהוקים:

  • חנויות מחוברות: חיבור חנות WooCommerce או Shopify רושם בחנות webhook של הזמנה חדשה, והחתימה של הפלטפורמה נבדקת בכל מסירה לפני שההזמנה נשמרת.
  • כפילויות: מסירה חוזרת של הזמנה שכבר קיימת מזוהה במקום ליצור כפילות.
  • מקורות אחרים: StoreChart מנפיקה כתובות webhook נכנסות המוגנות בטוקן, להזמנות, ללידים ולהזמנות מערוצי מכירה. כך כלים כמו Make מעבירים אליה נתונים.
  • תיעוד: המסירות שהתקבלו מתועדות, ואת המסירות מחנויות ומ-webhooks של הזמנות אפשר לבדוק ביומני האינטגרציה.
  • מה לא כלול: StoreChart לא שולחת וובהוקים למערכות אחרות.

שאלות נפוצות

מה החיסרון של webhooks לעומת polling?

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

מה קורה כשמסירת webhook נכשלת?

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

האם webhook מתאים לתקשורת דו-כיוונית?

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

StoreChart על הנתונים של החנות שלכם

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