StoreChart
Webhooks למפתחים

webhooks נכנסים לקליטת הזמנות ולידים

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

בקצרה

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

Webhooks לקליטת הזמנות ולידים

כתובת ייחודית לכל חנות או ערוץ לידים: שולחים JSON והרשומה נוצרת.

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

איך מגדירים webhook נכנס

כמה שלבים בין יצירת כתובת webhook לקבלת ההזמנה הראשונה.

1
יוצרים כתובת webhook

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

2
שולחים JSON מהמערכת שלכם

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

3
ההזמנה מופיעה ב-StoreChart

בקשה תקינה יוצרת את ההזמנה מיד. בקשה לא תקינה מקבלת תשובה שמפרטת בדיוק אילו שדות לתקן.

4
בודקים ביומני האינטגרציה

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

מה webhooks נכנסים נותנים לכם

  • הזמנות ולידים

    Webhook הזמנות לכל חנות ו-webhook לידים לכל ערוץ לידים, לכל אחד כתובת משלו.

  • Payload מלא

    בקשה אחת מכילה את כל ההזמנה (לקוח, פריטים ומשלוח) בלי קריאות API נוספות.

  • אימות באמצעות token

    בכל כתובת יש token ייחודי שמשויך לחנות אחת או לערוץ לידים אחד; בקשות עם token לא מוכר או לא פעיל נדחות.

  • הגנה מכפילויות

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

  • זיהוי לקוחות

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

  • שגיאות אימות ברורות

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

Webhooks נכנסים ב-StoreChart

לכל אינטגרציה מותאמת יש כתובת webhook משלה, ויומני האינטגרציה מציגים כל בקשה שהתקבלה בה עם הסטטוס שלה.

Webhooks נכנסים ב-StoreChart

Webhooks לקליטת נתונים: מדריך למפתחים

שליחת בקשה לכתובת ה-Webhook

Webhooks נכנסים מכניסים הזמנות ולידים ל-StoreChart ברגע שהם קורים, בלי שמישהו יקליד אותם מחדש.

  • הבקשה: HTTP POST עם גוף JSON.
  • הכתובת: הכתובת הייחודית של אינטגרציית webhook מותאמת בחנות, או של ערוץ לידים.
  • ה-token: הוא פרט הגישה. שמרו אותו בצד השרת כמו סיסמה, ולא בקוד שרץ בדפדפן.
  • כיוון אחד: ה-webhooks נכנסים בלבד. StoreChart לא שולחת את האירועים שלה החוצה.

אימות נתונים ושגיאות

כל הזמנה נבדקת מול סכמה לפני שמשהו נכתב.

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

ניסיונות חוזרים וכפילויות

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

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

שיוך לקוחות ומוצרים

בצד המקבל, StoreChart עושה את עבודת השיוך.

  • לקוחות: מזוהים לפי טלפון ואחר כך לפי מייל, והזמנה של לקוח חוזר מתחברת לכרטיס הקיים שלו.
  • מוצרים: פריטי ההזמנה משויכים למוצרים שלכם לפי מק״ט.
  • כל מקור: חנות שנבנתה בהתאמה, ERP או תרחיש Make.com מקבלים אותו טיפול כמו חיבורי WooCommerce ו-Shopify.

שאלות נפוצות

באיזה פורמט צריכה להישלח הבקשה?

בקשת 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 ובודקים ביומני האינטגרציה שהיא התקבלה