webhooks נכנסים לקליטת הזמנות ולידים
כתובת URL ייעודית ומאובטחת לקבלת נתוני JSON מכל מערכת, אתר או טופס. כל קריאה מתועדת ביומן, כך שקל לאתר תקלות.
בקצרה
webhooks נכנסים ב-StoreChart מאפשרים לכל מערכת, אפליקציה או חנות עצמאית לשלוח הזמנות ולידים כבקשת JSON לכתובת ייחודית. כל קריאה נבדקת, מתועדת ביומן האינטגרציות עם הסטטוס שלה, ונוצרת ממנה הזמנה או ליד. כך קל לאתר תקלות ולבדוק מה התקבל. הכתובת מאובטחת בטוקן.
Webhooks לקליטת הזמנות ולידים
כתובת ייחודית לכל חנות או ערוץ לידים: שולחים JSON והרשומה נוצרת.
- הזמנות שנשלחות כ-JSON לכתובת ה-webhook של החנות נוצרות ב-StoreChart עם הפריטים, פרטי הלקוח ופרטי המשלוח.
- ה-token הייחודי שבכתובת מאמת כל בקשה, והשבתת האינטגרציה מפסיקה את קבלת הנתונים בכתובת.
- הזמנות כפולות מזוהות לפי מספר ההזמנה החיצוני, כך שבקשה שנשלחה שוב לא יוצרת הזמנה שנייה.
- Webhook לידים הופך פניות מטפסים ומדפי נחיתה ללידים ב-StoreChart.
איך מגדירים webhook נכנס
כמה שלבים בין יצירת כתובת webhook לקבלת ההזמנה הראשונה.
מוסיפים לחנות אינטגרציית webhook מותאמת (או מגדירים ערוץ לידים ללידים) ומעתיקים את הכתובת הייחודית שלה.
המערכת שלכם שולחת HTTP POST עם ההזמנה או הליד כ-JSON, בהזמנה: מספר חיצוני, סטטוס, סכום, פרטי לקוח, פריטים ופרטי משלוח.
בקשה תקינה יוצרת את ההזמנה מיד. בקשה לא תקינה מקבלת תשובה שמפרטת בדיוק אילו שדות לתקן.
כל בקשה שמגיעה ל-webhook ההזמנות של חנות (שהתקבלה, נדחתה או זוהתה ככפולה) נרשמת ביומני האינטגרציה עם הנתונים שנשלחו, כך שמערכת שולחת שמתחילה להיכשל נראית מיד.
מה webhooks נכנסים נותנים לכם
הזמנות ולידים
Webhook הזמנות לכל חנות ו-webhook לידים לכל ערוץ לידים, לכל אחד כתובת משלו.
Payload מלא
בקשה אחת מכילה את כל ההזמנה (לקוח, פריטים ומשלוח) בלי קריאות API נוספות.
אימות באמצעות token
בכל כתובת יש token ייחודי שמשויך לחנות אחת או לערוץ לידים אחד; בקשות עם token לא מוכר או לא פעיל נדחות.
הגנה מכפילויות
הזמנות מזוהות ככפולות לפי המספר החיצוני שלהן, ולידים לפי תוכן הפנייה, כך שניסיונות חוזרים בטוחים.
זיהוי לקוחות
הלקוחות מזוהים קודם לפי טלפון ואחר כך לפי מייל, כך שהזמנה של לקוח חוזר מתחברת לכרטיס הלקוח הקיים שלו.
שגיאות אימות ברורות
נתונים שלא תואמים לסכמה נדחים עם רשימת השדות הלא תקינים, והניסיון נרשם ביומן לצורך בדיקה.
Webhooks נכנסים ב-StoreChart
לכל אינטגרציה מותאמת יש כתובת webhook משלה, ויומני האינטגרציה מציגים כל בקשה שהתקבלה בה עם הסטטוס שלה.

Webhooks לקליטת נתונים: מדריך למפתחים
שליחת בקשה לכתובת ה-Webhook
Webhooks נכנסים מכניסים הזמנות ולידים ל-StoreChart ברגע שהם קורים, בלי שמישהו יקליד אותם מחדש.
- הבקשה: HTTP POST עם גוף JSON.
- הכתובת: הכתובת הייחודית של אינטגרציית webhook מותאמת בחנות, או של ערוץ לידים.
- ה-token: הוא פרט הגישה. שמרו אותו בצד השרת כמו סיסמה, ולא בקוד שרץ בדפדפן.
- כיוון אחד: ה-webhooks נכנסים בלבד. StoreChart לא שולחת את האירועים שלה החוצה.
אימות נתונים ושגיאות
כל הזמנה נבדקת מול סכמה לפני שמשהו נכתב.
- תשובת 422: בקשה עם שדות חסרים או שגויים נדחית, עם פירוט השדות הלא תקינים.
- יומני אינטגרציה: הניסיון נרשם עם הנתונים הגולמיים, כך שרואים בדיוק מה המערכת השולחת שלחה.
ניסיונות חוזרים וכפילויות
רשתות נופלות, ולכן הצד השולח צריך לנסות שוב כשאין תשובת הצלחה ברורה. זה בטוח:
- הזמנות: מזוהות לפי מספר ההזמנה החיצוני ולא נוצרות שוב.
- לידים: מזוהים ככפולים לפי התוכן שלהם.
- תשובת 429: הבקשות מוגבלות בקצב לכל token. שולח שמקבל 429 צריך להאט ולנסות שוב מאוחר יותר.
שיוך לקוחות ומוצרים
בצד המקבל, StoreChart עושה את עבודת השיוך.
- לקוחות: מזוהים לפי טלפון ואחר כך לפי מייל, והזמנה של לקוח חוזר מתחברת לכרטיס הקיים שלו.
- מוצרים: פריטי ההזמנה משויכים למוצרים שלכם לפי מק״ט.
- כל מקור: חנות שנבנתה בהתאמה, ERP או תרחיש Make.com מקבלים אותו טיפול כמו חיבורי WooCommerce ו-Shopify.
ניהול הזמנות ב-StoreChart
שאלות נפוצות
באיזה פורמט צריכה להישלח הבקשה?
בקשת HTTP POST עם גוף JSON. בהזמנות, הגוף כולל את מספר ההזמנה החיצוני, סטטוס, סכום, מטבע, פרטי לקוח, פריטים ופרטי משלוח, והוא נבדק מול הסכמה בכל בקשה.
מה קורה אם אותה הזמנה נשלחת פעמיים?
StoreChart בודקת את מספר ההזמנה החיצוני, מזהה שההזמנה כבר קיימת, ולא יוצרת אותה שוב. כך המערכת השולחת יכולה לנסות שוב בבטחה בקשה שהיא לא בטוחה שעברה.
מה אפשר לשלוח ל-StoreChart?
הזמנות, דרך ה-webhook המותאם של חנות, ולידים, דרך ה-webhook של ערוץ לידים. StoreChart לא שולחת את האירועים שלה החוצה למערכות אחרות.
איך בקשה מאומתת?
באמצעות ה-token הייחודי שבכתובת ה-webhook. ה-token מזהה לאיזו חנות או לאיזה ערוץ לידים שייכים הנתונים, ולכן שמרו את הכתובת פרטית ובצד השרת, והשביתו את האינטגרציה אם היא נחשפה.
מה קורה כשהנתונים לא תקינים?
הבקשה נדחית עם תשובת 422 שמפרטת כל שדה לא תקין, והניסיון נרשם ביומני האינטגרציה יחד עם הנתונים הגולמיים, כך שרואים בדיוק מה המערכת השולחת שלחה.
יש הגבלת קצב?
כן. הבקשות מוגבלות בקצב לכל token כדי להגן על המערכת. שולח שחורג מהמגבלה מקבל תשובת 429 וצריך לנסות שוב מאוחר יותר.
אפשר להשתמש ב-webhooks נכנסים עם Make.com או Zapier?
כן. כל כלי שיודע לשלוח HTTP POST עם JSON, כולל מודול ה-HTTP של Make ופעולת ה-webhook של Zapier, יכול לשלוח הזמנות או לידים לכתובות ה-webhook של StoreChart.
צרו את ה-webhook הנכנס הראשון שלכם
מעתיקים כתובת, שולחים הזמנה ב-JSON ובודקים ביומני האינטגרציה שהיא התקבלה
