יומני אינטגרציה לכל החיבורים במקום אחד
יומן לכל webhook, סנכרון, קריאה לחברת משלוחים ואירוע של ערוץ מכירה, עם סטטוס ופרטי השגיאה. כשל ב-webhook יוצר התראה בעדיפות גבוהה.
בקצרה
יומני האינטגרציה של StoreChart מתעדים כל webhook, הרצת סנכרון, קריאה לחברת משלוחים ואירוע של ערוץ מכירה, עם סטטוס, חנות ופרטי השגיאה. webhook שנכשל ב-WooCommerce, ב-Shopify או בחיבור מותאם יוצר התראה בעדיפות גבוהה, ושאר הכשלים מחכים ביומן תחת סינון השגיאות, ואפשר לחפש בתוך ההודעות.
יומן אחד לכל החיבורים
כל webhook, סנכרון ושגיאה, עם הפרטים לבדיקה
- יומן אחד ל-webhooks ולסנכרון של WooCommerce ו-Shopify, ל-webhooks נכנסים, לאינטגרציות משלוחים ולאירועי ערוצי מכירה
- התראה בעדיפות גבוהה כש-webhook של WooCommerce, Shopify או חיבור מותאם נכשל
- סינון לפי סטטוס (הצלחה, שגיאה או מידע) ולפי קטגוריה, חנות ומקור ייבוא
- חיפוש בסוגי אירועים, בתוכן ההודעות ובשמות החנויות
- כל רשומה שומרת את הפרטים שלה, כמו הנתונים שנשלחו והודעת השגיאה, לצורך בדיקה
יכולות יומני האינטגרציה
כל תקלה בחיבור נרשמת ונשארת לבדיקה
עבודה עם היומן ב-3 שלבים
מהחשש שמשהו נפל, לתשובה ברורה
חברו WooCommerce, Shopify, משלוחים או ערוצי מכירה. האירועים שלהם מתחילים להופיע ביומן אוטומטית: אין מה להפעיל.
webhook שנכשל יוצר התראה בעדיפות גבוהה במערכת, ושאר הכשלים מחכים ביומן תחת סינון השגיאות.
סננו לפי סטטוס, קטגוריה וחנות, חפשו בהודעות, ופתחו את הרשומה כדי לראות מה השתבש.
יומני אינטגרציה: איתור תקלות סנכרון
מה נרשם ביומן
יומני האינטגרציה מראים מה עשו החיבורים של החנות כשלא הסתכלתם. שלושה מקורות כותבים אליהם:
- חיבורי חנות: WooCommerce, Shopify וחיבורים מותאמים רושמים כל webhook שהתקבל וכל הרצת סנכרון.
- משלוחים: כל הזמנה שנשלחה לחברת השליחויות, מספר המעקב, והבקשה והתשובה כשמשהו נכשל.
- ערוצי מכירה: אירועים כמו הזמנה שנכנסה מחנות של שותף.
הרשומות נכתבות אוטומטית מרגע שהחיבור פעיל, ואין מה להגדיר.
סטטוס, קטגוריה וחיפוש
כל רשומה מתויגת בחנות, בסטטוס ובקטגוריה. השילוב ביניהם מצמצם מאות רשומות לכמה שחשובות עכשיו.
- סטטוס: למשל הצלחה, מידע, אזהרה, שגיאה או בתהליך.
- קטגוריה: webhook, סנכרון, חיבור, משלוחים או ערוץ מכירה.
- חנות: הבורר הגלובלי מציג חנות אחת או את כולן.
- חיפוש: לפי סוג אירוע, תוכן ההודעה או שם החנות.
איתור תקלת סנכרון
- בוחרים חנות ומסמנים סטטוס שגיאה.
- אם צריך, מצמצמים לקטגוריה אחת.
- מחפשים מספר הזמנה, שם אירוע או מילה מהודעת השגיאה.
- פותחים את הרשומה ורואים את הפרטים שנשמרו.
- אחרי התיקון בודקים שהרשומות החדשות מגיעות בסטטוס הצלחה.
שגיאה אחת בין עשרות הצלחות מרמזת בדרך כלל על הזמנה עם נתון חריג. אם כל ה-webhooks מחנות אחת נכשלים מאותה שעה, כנראה השתנה משהו בחיבור, כמו מפתח API שבוטל.
מתי מקבלים התראה בפעמון
לא כל שגיאה מגיעה לפעמון:
- webhook שנכשל: ב-WooCommerce, ב-Shopify או בחיבור מותאם, יוצר התראה בעדיפות גבוהה.
- סנכרון חלקי: סנכרון שבו הזמנות לא נקלטו מגיע בעדיפות גבוהה.
- משלוחים: כשל בשליחה לחברת שליחויות נרשם ביומן בלי התראה.
- ערוצי מכירה: אירוע שנכשל נרשם ביומן בלי התראה.
לכן שווה לפתוח את היומן עם סינון שגיאות פעם ביום. מי שאחראי על החיבורים צריך גם לוודא שקטגוריית התפעול לא מושתקת אצלו.
דוגמה: הזמנות שלא הגיעו לשליח
חנות Shopify שולחת כ-60 הזמנות ביום לחברת שליחויות דרך StoreChart. לקוחה שואלת למה לא קיבלה מספר מעקב, והפעמון ריק.
- מסננים לפי קטגוריית משלוחים וסטטוס שגיאה: 9 רשומות מהבוקר.
- בכולן אותה הודעה על כתובת לא מלאה.
- בבקשה ששמורה ברשומה רואים שמספר הבית הוזן בשדה אחר.
- מתקנים את הכתובות ומטפלים בהזמנות.
- מייצאים את הרשומות לקובץ JSON, למקרה שהתקלה תחזור.
מאותו יום, בדיקת שגיאות בצהריים נכנסת לשגרה של הצוות.
למי זה מתאים ומה לא כלול
- מתאים ל: חנות שמחוברת ל-WooCommerce או ל-Shopify, שולחת משלוחים דרך המערכת או מפעילה ערוצי מכירה.
- שיתוף עם תמיכה: מעתיקים את סוג האירוע, הזמן והודעת השגיאה, ושולחים לצוות התמיכה או לספק האינטגרציה.
- שמירה: נשמרות רק הרשומות האחרונות, וישנות נמחקות אוטומטית. זה לא ארכיון.
- ייצוא וניקוי: מייצאים לקובץ JSON לפני שהרשומות מתנקות, ואפשר לנקות את היומן ידנית.
- ניטור חיצוני: אין שליחה של רשומות למערכת ניטור ואין webhooks יוצאים.
- כללי התראה: אין כללים שאתם מגדירים בעצמכם.
המספרים בדוגמאות שבמאמר זה להמחשה בלבד ואינם משקפים נתוני לקוח בפועל.
שאלות נפוצות על יומני אינטגרציה
למה אני צריך לוגים אם הכל עובד?
כי הבעיות מתחילות "בשקט": webhook אחד שנכשל יכול להפוך לכמה הזמנות שלא סונכרנו. עם היומן והתראות הכשל, תגלו את הבעיה מוקדם: לא אחרי שלקוח מתלונן.
כמה היסטוריית לוגים נשמרת?
היומן שומר את האירועים האחרונים של כל חשבון, ורשומות ישנות מתנקות אוטומטית כדי שהוא יישאר מהיר. הוא נועד לאיתור תקלות עכשוויות, לא לארכוב לטווח ארוך.
מה קורה כש-webhook נכשל?
כש-webhook של WooCommerce, של Shopify או של חיבור מותאם נכשל, הכשל נרשם ביומן עם הודעת השגיאה והפרטים, ונוצרת התראה בעדיפות גבוהה במערכת. ל-WooCommerce ול-Shopify יש כללי שליחה חוזרת משלהם ל-webhooks שלא קיבלו תשובת הצלחה.
האם אפשר לסנן לוגים לפי חנות ספציפית?
כן. כל רשומה מתויגת בחנות ובקטגוריה שלה, ובורר החנויות הגלובלי מצמצם את היומן לחנות אחת. בשילוב עם סינון הסטטוס אפשר לראות, למשל, רק את השגיאות של חנות A.
מה רואים ברשומה של משלוח שנשלח לחברת שליחויות?
את ההזמנה, את חברת המשלוחים ואת מספר המעקב אם התקבל, לצד הבקשה שנשלחה והתשובה שחזרה. אם השליחה נכשלה, רואים גם את פרטי השגיאה. כשל כזה נרשם ביומן, אבל לא יוצר התראה בפעמון.
איך אני יכול לשתף לוג עם צוות תמיכה?
מאתרים את הרשומה בסינון או בחיפוש, ומייצאים את היומן לקובץ JSON או מעתיקים את סוג האירוע, הזמן והודעת השגיאה. את זה שולחים לצוות התמיכה או לספק האינטגרציה, ובדרך כלל זה מספיק כדי לאתר את הבעיה.
אני מקבל התראה ברגע שאירוע אינטגרציה נכשל?
לא על כל כשל. webhook שנכשל ב-WooCommerce, ב-Shopify או בחיבור מותאם, וסנכרון שבו הזמנות לא נקלטו, יוצרים התראה בעדיפות גבוהה. כשלים במשלוחים ובערוצי מכירה נרשמים ביומן בלי התראה, ולכן כדאי לסנן לפי שגיאות באופן קבוע.


