סנכרון אוטומטי של נתוני מוצר SaaS ו-CRM לאתר שיווקי ב-Webflow

סנכרון אוטומטי של נתוני מוצר SaaS ו-CRM לאתר שיווקי ב-Webflow

Webflow
בינה מלאכותית (AI)
ניהול תוכן (CMS)
ניהול לקוחות (CRM)
n8n
HubSpot
תאריך פרסום: 16 ביולי 2026

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

תהליך העבודה הזה סוגר את שלושת הפערים הללו על ידי התייחסות ל- Webflow CMS כשכבת תצוגה שמתעדכנת ללא הרף באמצעות אוטומציה:

  1. מהמוצר ל-Webflow. משימה מתוזמנת ב-n8n מושכת את רשימת האינטגרציות והערות השחרור העדכניות מ-API המוצר שלכם ומעדכנת אותן באוספי ה-CMS של Webflow דרך Data API v2.
  2. מ-Webflow ל-HubSpot. הטופס שולח את פרטי הפנייה ל-n8n, שממפה אותם לשליחת טופס ב-HubSpot. HubSpot יכול להתאים אנשי קשר לפי כתובת האימייל. נתוני עוגיית המבקר הם אופציונליים ותלויים בהסכמה למדידה.
  3. מהמבקר לדף מותאם אישית. סקריפט צד-לקוח קטן מחליף את תוכן ה-Hero בהתאם לפרמטר הקמפיין.

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

תרשים ארכיטקטורה: משימת n8n לילית שולפת נתוני מוצר מה-API, משווה מול פריטי Webflow CMS, יוצרת או מעדכנת אותם ומפרסמת; טופס מבקר עם נתוני UTM עובר דרך webhook של n8n לעדכון ב-HubSpot

דרישות קדם

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

כתובת בסיס ל-Webflow Data API: https://api.webflow.com/v2. כותרת אימות (Auth header) בכל קריאה: Authorization: Bearer YOUR_WEBFLOW_TOKEN.

רוצים ליישם את זה בעסק שלכם?

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

חלק 1 — אוספי Webflow CMS (שכבת התצוגה)

צור שני אוספים. השדה הקריטי הוא מזהה חיצוני (External ID) — מפתח ראשי של המוצר עבור כל רשומה. כך הסנכרון מתאים פריט קיים במקום ליצור כפילויות.

שדות אוסף אינטגרציות

שדות אוסף Integrations ב-Webflow CMS: Name, Slug, External ID, Category, Logo, Description ו-Status עם סוגים והערות

שדות אוסף יומן שינויים: name,slug,external-id,release-date (תאריך), body (טקסט עשיר), version (טקסט פשוט), type (אפשרות: תכונה/תיקון/שיפור).

חלק 2 — סנכרון n8n (מהמוצר ל-Webflow CMS)

צומת אחר צומת. מופעל מדי לילה; מבצע upsert לפי מזהה חיצוני.

צומת 1 — טריגר תזמון — יומי, למשל 04:00.

צומת 2 — בקשת HTTP: שליפת נתוני מוצר

GET https://api.yourproduct.com/integrations (Bearer your product token). מחזיר מערך כגון [{ id, name, category, logoUrl, description, status }, ...].

צומת 3 — בקשת HTTP: קבלת פריטי Webflow קיימים (לצורך השוואה)

דוגמת בקשה ששוחזרה. יש לשלוף את כל הדפים באמצעות limit/offset ומספר הפריטים הכולל שבתשובה, ולבחור את שפת ה-CMS הרצויה. מרכזים את כל הפריטים לפני ההתאמה; מאה הפריטים הראשונים אינם בהכרח כל האוסף.

GET https://api.webflow.com/v2/collections/{COLLECTION_ID}/items?limit=100&offset=0
Authorization: Bearer {WEBFLOW_SITE_TOKEN}
accept: application/json

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

צומת 4 — קוד: הפרדה בין יצירה לעדכון פריטים תואמים

זהו הקוד המקורי ששוחזר, לצורך הסבר. הקוד מוסיף לעדכון כל פריט שנמצא לו מזהה תואם, ואינו משווה ערכי שדות. הוא מניח רשומת מוצר אחת בכל פריט n8n ומערך items מאוחד של Webflow. יש להתאים את הקלט למצב ההרצה של צומת הקוד. ודאו שהמזהים החיצוניים והשמות אינם ריקים ושהמזהים ייחודיים; השתמשו ב-Map להתאמה. כלל ה-slug מסיר אותיות עבריות ועלול ליצור ערך ריק; יצירה מחדש של slug קיים עלולה לשנות כתובות. שמרו כתובות קיימות ובדקו חדשות. מפו מזהי אפשרויות והפניות למבנה האוסף; status="live" הוא ערך בשדה מותאם ולא הוראת פרסום. logoUrl אינו ממופה.

// n8n Code node: Run Once for All Items
const existing = $('Get Webflow items').all().flatMap(i => i.json.items ?? []);
const byExternalId = new Map(existing.map(it => [it.fieldData['external-id'], it]));

const slugify = s => s.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');

const creates = [];
const updates = [];
for (const { json: p } of $input.all()) {
  const fieldData = {
    name: p.name,
    'external-id': String(p.id),
    category: p.category,
    description: p.description,
    status: p.status
  };
  const match = byExternalId.get(String(p.id));
  if (match) {
    updates.push({ id: match.id, fieldData });   // every match is queued, changed or not
  } else {
    creates.push({ fieldData: { ...fieldData, slug: slugify(p.name) } });
  }
}

return [{ json: { creates, updates } }];

צומת 5 — בקשת HTTP: יצירת פריטים חדשים (בשידור חי)

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

POST https://api.webflow.com/v2/collections/{COLLECTION_ID}/items/live
Authorization: Bearer {WEBFLOW_SITE_TOKEN}
Content-Type: application/json

Body (n8n expression):
{{ { "items": $json.creates.map(c => ({ isArchived: false, isDraft: false, fieldData: c.fieldData })) } }}
יצירה חיה תומכת באובייקט fieldData יחיד או במערך items שאינו ריק. בחרו מבנה גוף אחד ובדקו את מגבלות נקודת הקצה לפני הגדרת גודל האצווה.

צומת 6 — בקשת HTTP: עדכון פריטים תואמים בגרסה החיה

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

PATCH https://api.webflow.com/v2/collections/{COLLECTION_ID}/items/live
Authorization: Bearer {WEBFLOW_SITE_TOKEN}
Content-Type: application/json

Body (n8n expression, max 100 items per request):
{{ { "items": $json.updates.slice(0, 100).map(u => ({ id: u.id, fieldData: u.fieldData })) } }}

עבור פעולות מרוכזות (bulk), PATCH /items/live מעדכן עד 100 פריטים בקריאה אחת.

צומת 7 — (אופציונלי) פרסום — אם יצרת בשלבי טיוטה במקום פריטים חיים:

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

POST https://api.webflow.com/v2/collections/{COLLECTION_ID}/items/publish
Authorization: Bearer {WEBFLOW_SITE_TOKEN}
Content-Type: application/json

{
  "itemIds": ["{STAGED_ITEM_ID_1}", "{STAGED_ITEM_ID_2}"]
}

שכפל את צמתים 2–7 עבור אוסף ה- Changelog (או בצע פרמטריזציה באמצעות לולאה על פני שתי הגדרות האוסף).

חלק 3 — צינור לידים של HubSpot עם שיוך UTM

אפשר לשמור על עיצוב הטופס, לבחור מסלול שליחה אחד ל-n8n ולמפות את השדות לטופס מוגדר ב-HubSpot. שליחה דרך פעולת הטופס ו-webhook של Webflow הם מסלולים שונים: בחרו ובדקו מסלול אחד כדי שכל פנייה תישלח פעם אחת. הדוגמה הבאה אינה שומרת נתוני שיוך בעוגיות או ב-localStorage. היא משתמשת בנתוני UTM מהעמוד הנוכחי רק כשניתנה הסכמה למדידה.

שלב א — נתוני שיוך מהעמוד הנוכחי והקשר מבקר אופציונלי

הדוגמה המעודכנת מניחה ש-API ההסכמה של HubSpot כבר משולב במנהל ההסכמה בפועל. אם משתמשים ב-CMP אחר, יש למפות את מצב ההסכמה האמיתי למדידה; מצב לא ידוע או סירוב משאירים את נתוני השיוך האופציונליים ריקים. עוגייה קיימת אינה הסכמה. הוסיפו data-wff-attribution="true" רק לטופס הרצוי, עם השדות הנסתרים utm_source, utm_medium, utm_campaign, utm_term, utm_content, hubspotutk, analytics_consent, pageUri ו-pageName. מפו במפורש את השדות הגלויים email/firstname. הדוגמה לוכדת שיוך מהעמוד הנוכחי בלבד, ללא שמירת שיוך ראשון או מעבר בין עמודים.

<script>
document.addEventListener('DOMContentLoaded', () => {
  const form = document.querySelector('form[data-wff-attribution="true"]');
  if (!form) return;
  const params = new URLSearchParams(location.search);
  const consent = window.wffAnalyticsConsent === true; // set by your consent tool
  const set = (name, value) => {
    const input = form.querySelector(`input[name="${name}"]`);
    if (input) input.value = String(value ?? '').slice(0, 255);
  };
  set('analytics_consent', consent ? 'granted' : 'unknown');
  set('pageUri', location.origin + location.pathname);
  set('pageName', document.title);
  if (!consent) return; // no consent: optional attribution stays blank
  ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
    .forEach(key => set(key, params.get(key)));
  const hutk = document.cookie.match(/(?:^|;\s*)hubspotutk=([^;]+)/);
  set('hubspotutk', hutk ? decodeURIComponent(hutk[1]) : '');
});
</script>

שלב ב — שליחת פנייה אחת מטופס מאומת ל-n8n

בחרו מסלול אחד מ-Webflow ל-n8n: פעולת הטופס או webhook של שליחת טופס ב-Webflow. בדקו את גוף הבקשה בפועל ונרמלו אותו ל-email, firstname, חמשת שדות ה-UTM, analytics_consent, hubspotutk, pageUri ו-pageName. אמתו בשרת את מבנה האימייל, אורכי השדות וגודל הקלט; אפשרו pageUri רק מהדומיין ומהנתיב הציבוריים שלכם. שדות נסתרים נשלטים בידי הלקוח: analytics_consent מעביר מצב ואינו הוכחה עצמאית להסכמה. פעלו לפי ההגדרות האמיתיות של ה-CMP והטופס. אין להעביר את הבקשה המלאה, העוגיות או הכותרות. בדקו שפנייה אחת מעובדת פעם אחת.

שלב ג — בניית הנתונים לשליחה לטופס HubSpot

הגדירו בטופס HubSpot את email/firstname ואת חמשת מאפייני ה-UTM הרצויים. צומת הקוד הבא פועל במצב Run Once for Each Item ומניח שהשלב הקודם כבר נרמל ואימת את הקלט. הוא בונה נתונים בלבד ואינו שולח בקשת HTTP. בדיקת קיום אימייל אינה אימות מלא של כתובת אימייל.

// n8n Code node: Run Once for Each Item (builds data only, no HTTP request)
const s = $json;
if (!s.email) throw new Error('Missing email');

const consented = s.analytics_consent === 'granted';
const fields = [
  { name: 'email', value: s.email },
  { name: 'firstname', value: s.firstname ?? '' },
  ...['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content']
    .filter(k => consented && s[k])
    .map(k => ({ name: k, value: s[k] }))
];

const context = { pageUri: s.pageUri, pageName: s.pageName };
if (consented && s.hubspotutk) context.hutk = s.hubspotutk;

return { json: { fields, context } };

שלחו את אובייקט ה-JSON שנוצר מ-n8n ל-HubSpot דרך צומת HTTP Request נפרד: POST https://api.hsforms.com/submissions/v3/integration/submit/{PORTAL_ID}/{FORM_GUID}, עם Content-Type: application/json. השתמשו במזהי החשבון והטופס שהגדרתם. לנקודת הקצה המאומתת secure/submit יש דרישות אימות נפרדות. אין לחשוף פרטי גישה או להשתמש ב-skipValidation שהוצא משימוש. טפלו בשגיאות API במפורש.

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

הסכמה לעוגיות מדידה והסכמת הטופס לעיבוד מידע או לקבלת הודעות הן בחירות נפרדות. אין להסיק אחת מהשנייה. אם הטופס ב-HubSpot דורש legalConsentOptions, יש למפות את הבחירות שהמבקר ביצע בפועל ואת נוסח ההודעה המאושר לשדות המתאימים. אין לקבוע consentToProcess=true באופן קבוע, להמציא בסיס לעיבוד או להתייחס לעוגייה כהסכמה לדיוור. הדוגמה שלמעלה משמיטה legalConsentOptions ואינה שלמה עבור טופס שדורש אותו.

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

חלק 4 — התאמה אישית (אופציונלי)

החלף נקודות הוכחה בבאנר הראשי לפי קמפיין, באופן שקוף למשווק שעורך את הדף:

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

<script>
(() => {
  const industry = new URLSearchParams(location.search).get('industry');
  if (!industry) return;
  document.querySelectorAll('[data-industry]').forEach(el => {
    el.style.display = el.dataset.industry === industry ? '' : 'none';
  });
})();
</script>

תייג גרסאות של הבאנר הראשי עם data-industry="finance" וכו'; קמפיינים ממומנים מוסיפים ?industry=finance.

בעיות נפוצות וטיפול בשגיאות

  • מגבלות קצב. בדקו את המגבלות העדכניות של התוכנית ונקודת הקצה. עבדו באצוות נתמכות וטפלו בתשובות הגבלת קצב באמצעות ניסיונות חוזרים מוגבלים והמתנה הדרגתית.
  • התנגשויות ב-slug. לפני יצירה, ודאו שהכתובות אינן ריקות ושהן ייחודיות. שמרו כתובות קיימות בסנכרון רגיל ובדקו שגיאות אימות, בלי להניח שכל התנגשות מחזירה 409.
  • הרצות חוזרות. התאימו לפי external-id מאומת בשפה הנכונה לאחר שליפת כל הדפים. זהו מזהים כפולים ומנעו הרצות חופפות. דוגמת הקריאה והכתיבה אינה upsert אטומי ואינה מבטיחה מניעת כפילויות.
  • טיוטה מול גרסה חיה. יצירה דרך /items/live מפרסמת באופן מיידי. השתמשו ב- /items + /items/publish אם ברצונכם בבדיקת עריכה לפני הפרסום.
  • שפות. בחרו את cmsLocaleId הרצוי בקריאה ובכתיבה. ליצירת פריט בכמה שפות, השתמשו ביצירה בטיוטה ובבקשת הפרסום המתועדת לפי שפה. בדקו כל שפה בנפרד.
  • HubSpot יכול לעדכן איש קשר קיים לפי כתובת האימייל שנשלחה. כשניתנה הסכמה למדידה ועוגיית המבקר של HubSpot זמינה, השדה context.hutk יכול לעזור לקשר את הפנייה לפעילות המבקר. כשהערך אינו זמין, משמיטים אותו ולא ממציאים מזהה. זו אינה הבטחה למניעת כפילויות או שיוך שגוי של איש קשר. בדקו את הגדרות מניעת הכפילויות של הטופס ושליחות חוזרות עם אותה כתובת אימייל.

רשימת תיוג לאימות

  • אמתו את מזהי האוספים, סוגי השדות ושפת ה-CMS הרצויה.
  • בדקו נרמול נתוני מוצר ושליפה מלאה מ-Webflow, כולל יותר ממאה פריטים.
  • הריצו פעמיים בסביבת ניסוי ובדקו מזהים חיצוניים כפולים, כישלונות חלקיים והרצות חופפות. אפס פריטים חדשים בהרצה השנייה הוא תוצאת בדיקה רצויה ולא הבטחה כללית.
  • שנו רשומת מוצר אחת ובדקו את נתוני העדכון. צומת 4 ששוחזר מוסיף את כל ההתאמות; יש להוסיף השוואת שדות לפני שמצפים לעדכון יחיד.
  • בדקו שליחות חוזרות עם אותו אימייל, הסכמה עם עוגייה ובלעדיה, סירוב, מצב לא ידוע וביטול הסכמה. אמתו את דרישות הטופס והטיפול בשגיאות בפועל.
  • בדקו את ה-Hero עם ערך נתמך, ערך לא מוכר, ללא פרמטר ועם JavaScript כבוי; שמרו ברירת מחדל גלויה.

שאלות נפוצות

האם הסנכרון ייצור פריטים כפולים ב-CMS של Webflow שלי?

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

האם זה עובד רק עם HubSpot, או שאפשר להשתמש ב-Salesforce?

אפשר להתאים את מבנה החיבור למערכות CRM אחרות, אך האימות, כללי ההתאמה, השדות והטיפול בשגיאות שונים. הדוגמה משתמשת ב-Forms Submission API של HubSpot ובהתאמה לפי אימייל; נתוני מבקר אופציונליים עוזרים לקשר פעילות. חיבור ל-Salesforce דורש מיפוי ובדיקות משלו, ולא רק החלפה של כתובת ה-API. אינטגרציות CRM ו-HubSpot

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

‍ ת: הם יכולים לערוך כל שדה שהסנכרון לא מנהל. השאירו שדות אוטומטיים (שם, תיאור, סטטוס) מנוהלים על ידי ה-API של המוצר, ואל תכללו את השדות שבניהול השיווק (טקסט מותאם אישית, מתגי תצוגה, דריסות SEO) במטען הסנכרון כדי שלעולם לא יושפעו. החלוקה הזו היא חלק מהאופן שבו אנו מתכננים אתרי שיווק ב-Webflow עבור SaaS — אוטומטיים היכן שצריך, וניתנים לעריכה היכן שזה חשוב. ‍ שירותים קשורים: פיתוח Webflow · בינה מלאכותית ואוטומציה (Make / Zapier / n8n) · אינטגרציה של CRM ו-HubSpot · הגירה מ-WordPress ל-Webflow · תיאום ביקורת לאתר שיווק SaaS

Image of author
פבל ויינשטיין
מייסד Webflowforge | אתרי B2B ו-SaaS, אינטגרציית CRM ואוטומציית AI
פבל ויינשטיין ייסד את Webflowforge בקריית ביאליק. הוא עובד עם צוותי B2B ו-SaaS על עיצוב אתרים, פיתוח ב-Webflow וב-WordPress, אינטגרציה עם HubSpot CRM ואוטומציות AI עם n8n ו-Make. העבודה שלו מחברת בין אתרים לבין תפעול השיווק וההכנסות.