איך להתקין סוכן ב-Shopify

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

6 בספטמבר 2026

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

שלב 1. הטמעת הקוד בערכת העיצוב#

1. באדמין של Shopify, פתחו את “חנות אונליין” (Online Store) ← “ערכות עיצוב” (Themes).
2. בערכת העיצוב הפעילה, לחצו על ... ← “עריכת קוד” (Edit code).
3. ברשימת הקבצים, מצאו את layout/theme.liquid.
4. הדביקו את שורת הקוד מהפאנל ישירות לפני תגית הסגירה </body>.
5. שמרו.

אלטרנטיבה ללא עריכת ערכת העיצוב: “חנות אונליין” (Online Store) ← “העדפות” (Preferences) ← “קוד מותאם אישית” (Custom code) או כל אפליקציה להטמעת סקריפטים. התוצאה זהה.

    <!-- Commerce Agents -->
    <script src="https://comag.vibevox.pro/widget.js" data-slug="your-slug" async></script>
  </body>
</html>

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

שלב 2. איסוף הקטלוג#

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

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

שלב 3. השאירו את התשלום לחנות#

ב-Shopify, אין צורך להפעיל תשלום בצ'אט. התהליך הנכון הוא:

1. בהגדרות החנות, ציינו קישור לעגלת הקניות — בדרך כלל https://your-domain/cart.
2. הסוכן בוחר מוצר, מציג את כרטיס המוצר ומוביל את הקונה לעגלת הקניות של Shopify בלחיצת כפתור.
3. תהליך ההזמנה והתשלום מתבצע כרגיל, עם כל כללי המשלוח והמיסים שלכם.

כדי לראות אילו דיאלוגים מסתיימים ברכישה, הטמיעו את קטע פיקסל הרכישה בדף התודה. ב-Shopify, זה נמצא ב“הגדרות” (Settings) ← “קופה” (Checkout) ← “דף סטטוס הזמנה” (Order status page) ← “סקריפטים נוספים” (Additional scripts). הקטע עם הצבת מספר ההזמנה והסכום נמצא בפאנל, תחת “ווידג'ט וקישור”.

המוצר מגיע לעגלת הקניות מבלי להפריע לשיחה#

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

זה עובד כך: בקישור המוצר של Shopify קיים מזהה וריאנט. הסוכן מעביר אותו לעגלת הקניות שלכם דרך הממשק המובנה /cart/add.js. הדף אינו נטען מחדש, הדיאלוג אינו נקטע, הקונה רואה אישור קצר וממשיך לבחור. המוצר נמצא כבר בעגלת הקניות של Shopify — עם כל כללי ההנחות, המיסים והמשלוח שלכם.

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

כאשר הלקוח מוכן, הכפתור “מעבר לקופה” מוביל ל-/cart, שם הכל כבר נאסף. מכאן והלאה — קופת Shopify רגילה.

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

• פתחו את החנות במצב גלישה בסתר, המתינו לכפתור הצ'אט.
• שאלו על מוצר לפי שם — אמור להופיע כרטיס מוצר עם מחיר.
• לחצו על “מעבר לקופה” — עגלת הקניות של Shopify אמורה להיפתח.
• בצעו הזמנת בדיקה וודאו שהרכישה סומנה ב“הזמנות”.

צ'אט בהתאמה לחלון הראווה#

ערכת העיצוב של Shopify קובעת את האווירה הכללית של החנות, והצ'אט לא אמור לחרוג מכך. בהגדרות הווידג'ט קיימות שלוש אפשרויות: בהירה, כהה ו“כמו של המבקר”, העוקבת אחר הגדרות המכשיר של הקונה.

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

שלב 4. בדיקה#

בעיות נפוצות#

• הווידג'ט נעלם לאחר שינוי ערכת העיצוב. הקוד נמצא בקובץ ערכת העיצוב. שינוי או עדכון של ערכת העיצוב מוחק את העריכה — הטמיעו את הקוד מחדש או השתמשו ב-Custom code, שאינו תלוי בערכת העיצוב.

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

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

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

שאלות נפוצות#

האם נדרשת אפליקציה מ-Shopify App Store#

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

האם הסוכן יכול להציג וריאנטים של מוצרים#

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

מה קורה עם מספר מטבעות#

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

האם הסוכן ידע על מלאי#

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

האם הווידג'ט משפיע על מהירות החנות#

הסקריפט נטען באופן אסינכרוני ואינו חוסם את הרינדור. הדבר כמעט ואינו משפיע על מדדי Core Web Vitals.