תיעוד

איך מתחילים

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

1. 1. נכנסים לבונה ומתארים את האתר או האפליקציה.
2. 2. הדף נשמר כטיוטה — הוא לא חי ואף אחד לא רואה אותו.
3. 3. מבקשים שינויים בשיחה עד שהוא מוכן.
4. 4. לוחצים פרסום. רק אז הוא עולה לאוויר.

אתר שאוסף פניות מקבל גם מסך ניהול שקורא אותן — לא צריך לבקש אותו בנפרד.

שמירת נתונים

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

await stavData.add('orders', { name: 'דנה', total: 120 });
const orders = await stavData.list('orders');
await stavData.update('orders', id, { status: 'נשלח' });
await stavData.remove('orders', id);
await stavData.set('orders', allRecords);   // replaces the collection

• שם האוסף הוא שלכם לבחירה — 'orders', 'leads', מה שמתאים.
• כל הפונקציות מחזירות Promise עם רשימת הרשומות שאחרי הפעולה.
• set מחליף את כל האוסף ולא מוסיף לו. משתמשים בו לסנכרון מלא, לא להוספת רשומה.
• הנתונים שייכים לדף ונשמרים בחשבון שלכם — לא ב-localStorage, ולא נעלמים כשהמבקר מנקה את הדפדפן.

בינה מלאכותית בדף

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

const answer = await stavAI.ask('מה שעות הפתיחה?', { system: 'ענה בקצרה' });

מחזיר טקסט. רץ על הקרדיטים של בעל הדף.

פניות, הזמנות והתראות

window.stav מחבר את הדף לעסק שמאחוריו.

await stav.lead({ name, phone, message });  // פנייה — מגיעה למסך הניהול
await stav.order({ items, customer });      // הזמנה — סכומים מחושבים בשרת
await stav.notifyOwner('הזמנה חדשה');       // התראה לבעל העסק
await stav.contact();                       // { phone, email, whatsapp } של העסק
await stav.openWhatsApp('שלום');            // פותח וואטסאפ אצל המבקר
await stav.whatsappUrl('שלום');             // אותו קישור בלי לפתוח — מחזיר מחרוזת
await stav.reply({ comment, about, name }); // סתיו עונה לתגובה של קורא

• lead — דורש שם, ועוד טלפון או מייל. אותו צינור שהטפסים של הפלטפורמה עצמה עוברים בו.
• order — הסכום מחושב מחדש בשרת מהפריטים, כך שמה שהדפדפן טוען שהמחיר הוא לא משנה. הקונה נוסף למועדון הלקוחות.
• reply — מחזיר { reply }. תשובה ריקה היא תשובה תקינה, לא שגיאה: אין מפתח, נגמרו הקרדיטים, או שהתשובה לא עברה את בדיקת השרת. דף שמתייחס לשתיקה ככישלון יציג שגיאות ביום רגיל.
• notifyOwner — מגיע לוואטסאפ של בעל העסק כשהוא מוגדר, ונרשם על הדף בכל מקרה.

חיבורים ומפתחות

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

מפתחות של סתיו

מפתחות שסתיו מנפיקה לכם, לפי קטגוריה. בוחרים קטגוריה, לוחצים צור מפתח, ומקבלים מפתח של סתיו. הקטגוריה הראשונה היא AI לאתרים: מפתח שמאפשר לשרת של אתר חיצוני (לא דף שנבנה בסתיו) להריץ את הבינה של סתיו דרך POST /api/ai-run, על הקרדיטים של החשבון. משתמשים בו מהשרת בלבד — לא בקוד גלוי בדפדפן. בדף שסתיו או קלוד בונים אין צורך בו: שם window.stavAI עובד בלי מפתח.

חיבורים לשירותים חיצוניים

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

const r = await stav.call('shipping', { path: 'rates', query: { city: 'תל אביב' } });
if (r.ok) render(r.data);

מחזיר { status, ok, data }. תשובה שאינה 2xx היא תשובה, לא שגיאה — רק חיבור שאינו קיים או קריאה שלא הושלמה נכשלים.

בנייה מתוך קלוד

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

הכלים שקלוד מקבל בחשבון שלכם, בשמם המלא:

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

קרדיטים ומנוי

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

• · קרדיט אחד = 100,000 טוקנים. כל חשבון מקבל 10 קרדיטים בחינם.
• · הקרדיטים משותפים לכל האתרים בחשבון, לא לכל אתר בנפרד.
• · הספירה היא לפי טוקנים בלבד — קלט, פלט וחשיבה. המודל שענה לא משנה כמה יורד לכם.
• · בנייה ועריכה צורכות הרבה יותר משיחה — הן שולחות מסמך שלם ומקבלות אחד.
• · חודש ראשון חינם. אחריו מנוי חודשי מפעיל את כל הדפים בחשבון.

מה צורך קרדיטים ומה לא

את היתרה רואים במסך ההגדרות של האתר, ובלוח המחוונים.