Skip to content
Navo24Navo24

מדריכים

הטמעת אפליקציות Navo באתר לקוח

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

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

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

מה הלקוח שולח לנו

ItemExampleRequired
שם החברה כפי שמבקרים אמורים לראות אותוAcme Logisticsכן
הדומיינים שבהם האפליקציות ירוצו (production, staging)acme.com, www.acme.com, staging.acme.comכן
לוגו, SVG או PNG, סימן ריבועי או אופקיhttps://acme.com/logo.svgכן
צבע מותג, ערך hex אחד#0e6ba8כן
צבעים נוספים, פונטים, עיגול פינותראו מראה ותחושהאופציונלי
כתובת דואר שמקבלת בקשות הזמנה[email protected]עבור תעריפי שילוח
Webhook URL לבקשות הזמנה (אל ה-CRM/TMS שלהם)https://acme.com/hooks/navoאופציונלי
אילו אפליקציות הם רוציםכל שילוב של tracking, freight, schedules; מצב AI פעיל או כבויכן
מגבלת שימוש לכל אפליקציה, לחודש או לשנהtracking: 300 משלוחים ייחודיים בחודשכן
העמודים שבהם כל אפליקציה תופיע/track, /rates, /schedulesמומלץ
“מופעל על ידי Navo” מוצג או מוסתרמוצגברירת מחדל: מוצג

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

מה מפתח אחד יכול לכלול

מפתח פותח אפליקציה אחת או כמה אפליקציות, ומצב AI הוא מתג נפרד:

PackageApps on the keyWhat the visitor gets
Tracking בלבדtrackingעמוד מעקב; ווידג’ט החיפוש מציג את תיבת המעקב בלי טאבים ובלי מתג AI
Tracking עם AItracking, aiאותו הדבר, ובנוסף מצב AI בווידג’ט החיפוש ו-”שאל את ה-AI” במשלוחים
Rates and schedulesfreight, schedulesשני טאבים בווידג’ט החיפוש, עמודי התעריפים ולוחות ההפלגה
Everythingtracking, freight, schedules, aiכל שלושת הטאבים, מצב AI, כל העמודים

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

מגבלות שימוש

לכל אפליקציה במפתח יש מגבלה משלה, לפי חודש קלנדרי או שנה קלנדרית (UTC). מה נחשב יחידה אחת:

AppOne unitFree repeats
trackingמשלוח ייחודי אחד (מספר מכולה, הזמנה או B/L)אותו משלוח עד סוף התקופה
freightחיפוש תעריף אחד (lane וציוד)אותו חיפוש באותו יום
schedulesחיפוש לוח הפלגה אחד (מסלול, אונייה או נמל)אותו חיפוש באותו יום
aiשאלה אחת לעוזר ה-AIאין

דוגמה: tracking עם 300 משלוחים ייחודיים בחודש. המבקרים של הלקוח יכולים לפתוח ולרענן את אותם 300 משלוחים כמה פעמים שירצו לאורך כל החודש; משלוח 301 יידחה עד ה-1 בחודש הבא. כאשר אפליקציה מגיעה למגבלה שלה, המבקרים רואים “השירות הזה מושהה כרגע באתר הזה. אנא צרו קשר עם .” אפליקציות אחרות במפתח ממשיכות לעבוד. אנחנו רואים שימוש לפי אפליקציה ויכולים להגדיל מגבלה בכל רגע, בלי שינוי באתר הלקוח.

התקנה

שימו את ה-loader פעם אחת בכל עמוד שמציג אפליקציה:

<script src="https://navo24.com/embed.js" async></script>

ואז קונטיינר במקום שבו האפליקציה אמורה להופיע.

ווידג’ט חיפוש (hero בעמוד הבית, או כל עמוד אחר). תיבה אחת עם טאב לכל אפליקציה במפתח (tracking, rates, schedules), ומצב AI אם המפתח כולל אותו. כשיש אפליקציה אחת אין טאבים:

<div
  data-navo-app="search"
  data-navo-key="nve_YOUR_KEY"
  data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>

עם data-navo-pages הווידג’ט שולח מבקרים לעמודים של הלקוח עצמו. בלעדיו, התוצאה נפתחת ישירות בתוך המסגרת של הווידג’ט.

עמוד Tracking (/track):

<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>

עמוד תעריפי שילוח (/rates):

<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>

עמוד לוחות הפלגה (/schedules), עם שלושה טאבים: לפי מסלול, לפי אונייה, לפי נמל:

<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>

השתמשו באותו ערך data-navo-pages בכל אפליקציה כדי שקישורים פנימיים בין האפליקציות (לדוגמה “הצג תעריפים” בהפלגה, או “לוח הפלגות של האונייה” במשלוח) ינחתו בעמוד הנכון באתר הלקוח.

אפשרויות

AttributeWhat it does
data-navo-appsearch, tracking, freight או schedules.
data-navo-keyמפתח ההטמעה של האתר.
data-navo-pagesמפת JSON מאפליקציה לנתיב העמוד באתר הלקוח.
data-navo-heightגובה קבוע ב-px. כברירת מחדל המסגרת גדלה לפי התוכן שלה; tracking הוא מפה מלאה, 680 px.
data-navo-syncoff משאיר את ה-URL של העמוד ללא שינוי בזמן שהמבקר עובר בין תצוגות.
data-navo-themeJSON עם צבעים, פונטים ופינות, ראו מראה ותחושה.

אתרים עם Content Security Policy

אם האתר שולח כותרת Content-Security-Policy (או אחת דרך <meta http-equiv>) עם script-src או frame-src, הוסיפו את navo24.com לשניהם, אחרת הדפדפן יחסום את ה-loader או את המסגרת והקונטיינר יישאר ריק:

script-src ... https://navo24.com;
frame-src  ... https://navo24.com;

אם משתמשים ב-child-src במקום frame-src, הוסיפו אותו שם. לא צריך שום דבר נוסף: האפליקציות טוענות את הנתונים, הפונטים והמפות שלהן בתוך המסגרת, תחת המדיניות שלנו. קונסול הדפדפן מציין את הדירקטיבה שנחסמה אם משהו חסר.

אירועים לאנליטיקה ול-CRM

הקונטיינר משגר אירועי DOM כשמבקר עושה פעולה, כך שהאתר יכול לשלוח אותם אל Google Analytics, אל tag manager או אל ה-CRM שלו. הם עושים bubble, לכן listener אחד על document תופס כל אפליקציה בעמוד.

EventWhenevent.detail
navo:searchחיפוש החזיר תוצאותapp (tracking, freight, schedules) והשאילתה: ref, או origin, destination, container
navo:bookingבקשת הזמנה נשלחהreference, origin, destination, container, quantity, carrier, price, currency
navo:limitמגבלה עצרה חיפושapp, code (לדוגמה site_busy, rate_limited)
<script>
  document.addEventListener('navo:search', (e) => gtag('event', 'navo_search', e.detail));
  document.addEventListener('navo:booking', (e) => gtag('event', 'generate_lead', { value: e.detail.price, currency: e.detail.currency, transaction_id: e.detail.reference }));
</script>

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

מראה ותחושה

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

<div
  data-navo-app="freight"
  data-navo-key="nve_YOUR_KEY"
  data-navo-theme='{"accent":"#e4002b","text":"#1a1a1a","heading":"#002f6c","font":"Inter","radius":6,"buttonRadius":6}'
></div>

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

KeyWhat it changesExample
accentכפתורים, קישורים, טאבים פעילים, מתגים, טבעת focus. גוני hover ולחיצה מחושבים ממנו"#e4002b"
textטקסט ראשי"#1a1a1a"
mutedטקסט משני: תוויות, רמזים, תאריכים"#6b7280"
headingכותרות, שמות מובילים ואוניות, קווי מפה"#002f6c"
backgroundרקע העמוד של האפליקציה. "transparent" מאפשר לרקע של הלקוח להופיע דרכו"#ffffff"
surfaceכרטיסים, שדות קלט, פסי טבלאות"#f5f7fa"
borderגבולות ומפרידים"#e5e7eb"
successמצבים חיוביים: נמסר, בזמן, הזול ביותר"#15803d"
radiusעיגול פינות של כרטיסים ופאנלים, px (0 עד 40)8
buttonRadiusעיגול פינות של כפתורים ושדות קלט, px. 999 נותן צורת גלולה (ברירת המחדל)6
fontפונט גוף. כל משפחת Google Fonts נטענת עבורכם; "system" משתמש בפונט המערכת של המבקר"Inter"
headingFontפונט לכותרות, אותם כללים. אם לא מוגדר, כותרות משתמשות ב-font"Playfair Display"
fontCssגיליון סגנונות הפונט שלכם (https:// URL עם כללי @font-face), לפונטים שאינם ב-Google Fonts. לאחר מכן font ו-headingFont מציינים משפחות מתוך הקובץ הזה"https://acme.com/fonts/brand.css"
mode"dark" לאתרים עם עיצוב כהה"dark"

צבעים הם hex: #rgb, #rrggbb או #rrggbbaa.

נקודות פתיחה מוכנות:

<!-- Corporate: square corners, navy headings -->
data-navo-theme='{"accent":"#003a70","heading":"#003a70","font":"Source Sans 3","radius":2,"buttonRadius":2}'

<!-- Soft: rounded, light grey cards -->
data-navo-theme='{"accent":"#0f766e","surface":"#f3f4f6","font":"Nunito","radius":16,"buttonRadius":999}'

<!-- Dark site -->
data-navo-theme='{"mode":"dark","accent":"#f59e0b","background":"#0b1220","surface":"#111a2e","border":"#1f2a44","text":"#e5e7eb","muted":"#94a3b8"}'

<!-- Blend into the page: the app draws no background of its own -->
data-navo-theme='{"background":"transparent","font":"system"}'

ערכת נושא אחת לכל העמודים. אנחנו יכולים לשמור את ערכת הנושא גם על המפתח. כך כל קונטיינר בכל עמוד מקבל אותה בלי ה-attribute, ואנחנו יכולים לעדכן אותה מאוחר יותר בלי שינוי באתר הלקוח. data-navo-theme על קונטיינר עדיין גובר על ערכת הנושא של המפתח, מפתח אחר מפתח.

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

React ו-Next.js, עם אינדוקס חיפוש

השתמשו בזה כשהאתר של הלקוח בנוי עם React או Next.js, ותוכן האפליקציה צריך להיות מאונדקס כחלק מהעמוד של הלקוח (לדוגמה, עמוד לכל lane, “לוח הפלגות משנחאי להמבורג”).

זה מורכב משני חלקים:

  1. Snapshot. השרת של הלקוח מושך מאיתנו את נתוני ה-lane כ-HTML פשוט (טבלת לוחות הפלגה או טבלת תעריפים, כותרת, תקציר בשורה אחת וסימון schema.org) ומכניס אותם לעמוד שלו. מנועי חיפוש מאנדקסים את זה כתוכן של הלקוח, ב-URL של הלקוח.
  2. App. בדפדפן, האפליקציה האינטראקטיבית נטענת מעליו, עם חיפוש, פילטרים, פרטים והזמנה. ה-snapshot נשאר בעמוד כטבלה נפתחת מתחת לאפליקציה, כך ש-crawlers ומבקרים רואים את אותו תוכן.

נקודת קצה של Snapshot

GET https://api.navo24.com/v1/demo/embed/snapshot
    ?key=nve_YOUR_KEY
    &app=schedules            schedules | freight
    &origin=CNSHA             UN/LOCODE
    &destination=DEHAM        UN/LOCODE
    &container=40HC           freight only: 20GP | 40GP | 40HC
    &host=acme.com            the client's domain, must be on the key
    &format=html              optional: the HTML block only

בלי format=html התשובה היא JSON:

{
  "data": {
    "app": "schedules",
    "title": "Sailing schedule Shanghai to Hamburg",
    "description": "153 sailings from Shanghai (CNSHA) to Hamburg (DEHAM) in the next 6 weeks, 10 carriers, transit from 34 days.",
    "items": [{ "carrier": "Yang Ming", "vessel": "MSC OLIVIA", "voyage": "GL642W", "etd": "2026-10-24T00:00:00", "eta": "2026-12-03T00:00:00", "transit_days": 40, "direct": true }],
    "html": "<section class=\"navo-snapshot\">…</section>",
    "as_of": "2026-10-22T08:52:51Z"
  }
}

השתמשו ב-title וב-description עבור ה-<title> ותיאור המטא של העמוד, וב-html עבור הגוף. אפשר לשמור את התשובה ב-cache ל-30 דקות (Cache-Control: max-age=1800). Snapshot נספר כחיפוש אחד מול מגבלת האפליקציה; אותו lane באותו יום הוא בחינם. ל-tracking אין snapshot: משלוחים הם פרטיים למבקר.

Next.js (App Router)

// app/schedules/[lane]/page.tsx   e.g. /schedules/cnsha-deham
import NavoApp from './NavoApp';

const KEY = 'nve_YOUR_KEY';
const API = 'https://api.navo24.com/v1/demo/embed/snapshot';

async function snapshot(lane: string) {
  const [origin, destination] = lane.toUpperCase().split('-');
  const q = new URLSearchParams({ key: KEY, app: 'schedules', origin, destination, host: 'acme.com' });
  const r = await fetch(`${API}?${q}`, { next: { revalidate: 1800 } });
  return r.ok ? (await r.json()).data : null;
}

export async function generateMetadata({ params }: { params: { lane: string } }) {
  const s = await snapshot(params.lane);
  return s ? { title: `${s.title} | Acme Logistics`, description: s.description } : {};
}

export default async function Page({ params }: { params: { lane: string } }) {
  const s = await snapshot(params.lane);
  const [origin, destination] = params.lane.toUpperCase().split('-');
  return (
    <main>
      <NavoApp
        app="schedules"
        embedKey={KEY}
        view={{ origin, destination }}
        snapshotHtml={s?.html}
        theme={{ accent: '#e4002b', font: 'Inter' }}
      />
    </main>
  );
}
// app/schedules/[lane]/NavoApp.tsx
'use client';
import { useEffect, useRef, useState } from 'react';

const SRC = 'https://navo24.com/embed.js';

function loadNavo(): Promise<void> {
  const w = window as any;
  if (w.NavoEmbed) return Promise.resolve();
  return new Promise((ok) => {
    let s = document.querySelector<HTMLScriptElement>(`script[src="${SRC}"]`);
    if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
    s.addEventListener('load', () => ok(), { once: true });
  });
}

type Props = {
  app: 'search' | 'tracking' | 'freight' | 'schedules';
  embedKey: string;
  view?: Record<string, string>;          // opens this lane right away
  pages?: Record<string, string>;
  theme?: Record<string, string | number>;
  snapshotHtml?: string;                  // server-rendered data for search engines
};

export default function NavoApp({ app, embedKey, view, pages, theme, snapshotHtml }: Props) {
  const box = useRef<HTMLDivElement>(null);
  const [live, setLive] = useState(false); // until the app is up, the table is open
  useEffect(() => {
    if (view && !new URLSearchParams(location.search).get('navo')) {
      const u = new URL(location.href);
      u.searchParams.set('navo_app', app);
      u.searchParams.set('navo', new URLSearchParams(view).toString());
      history.replaceState(history.state, '', u);
    }
    loadNavo().then(() => { (window as any).NavoEmbed.mount(); setLive(true); });
  }, [app, embedKey]);
  return (
    <>
      <div
        ref={box}
        data-navo-app={app}
        data-navo-key={embedKey}
        data-navo-pages={pages ? JSON.stringify(pages) : undefined}
        data-navo-theme={theme ? JSON.stringify(theme) : undefined}
      />
      {snapshotHtml && (
        <details open={!live}>
          <summary>All results as a table</summary>
          <div dangerouslySetInnerHTML={{ __html: snapshotHtml }} />
        </details>
      )}
    </>
  );
}

כך זה נראה למנוע חיפוש: הכותרת והתיאור של העמוד עצמו, כותרת וטבלת הפלגות מלאה (או תעריפים) בתוך ה-HTML, עם סימון Dataset. כך זה נראה למבקר: האפליקציה החיה, כבר פתוחה על אותו lane, עם אותן תוצאות כטבלה מקופלת מתחתיה. מבקרים בלי JavaScript רואים את הטבלה פתוחה. הטבלה מקופלת, לא מוסתרת, כך שהעמוד לא מציג ל-crawlers שום דבר שמבקר לא יכול לפתוח.

ה-HTML של ה-snapshot מגיע מהשרת שלנו כשכל ערך escaped, לכן בטוח להכניס אותו. אם הוא מוצג, עצבו אותו עם המחלקות .navo-snapshot ו-.navo-snapshot-table.

מסגרות שרת אחרות (Remix, Astro, Nuxt, PHP, WordPress) עובדות באותה דרך: מושכים את ה-snapshot בשרת, מדפיסים את html לתוך העמוד, ושמים את הקונטיינר לידו.

React רגיל (ללא server rendering)

כשאינדוקס חיפוש לא חשוב (עמוד tracking מאחורי תפריט, אינטראנט), מספיק הרכיב בלי ה-snapshot:

ה-loader עובד באותה דרך באפליקציית single-page (React, Vue, Svelte): מרנדרים את הקונטיינר, ואז קוראים ל-window.NavoEmbed.mount().

import { useEffect } from 'react';

const SRC = 'https://navo24.com/embed.js';

function loadNavo() {
  if (window.NavoEmbed) return Promise.resolve();
  return new Promise((ok) => {
    let s = document.querySelector(`script[src="${SRC}"]`);
    if (!s) { s = document.createElement('script'); s.src = SRC; s.async = true; document.head.appendChild(s); }
    s.addEventListener('load', ok, { once: true });
  });
}

export function NavoApp({ app, embedKey, pages }) {
  useEffect(() => { loadNavo().then(() => window.NavoEmbed.mount()); }, [app, embedKey]);
  return (
    <div
      data-navo-app={app}
      data-navo-key={embedKey}
      data-navo-pages={pages ? JSON.stringify(pages) : undefined}
    />
  );
}

// <NavoApp app="tracking" embedKey="nve_YOUR_KEY" pages={{ tracking: '/track' }} />

ב-Next.js שימו אותו ב-client component ('use client').

למה מסגרת

ה-loader מצייר כל אפליקציה בתוך מסגרת מ-navo24.com. כך עובדים Stripe Checkout, הטמעות Google Maps ונגני YouTube, מאותן סיבות:

  • נעילת דומיין. הדפדפן עצמו מסרב להציג את האפליקציה באתר שאינו ברשימת המפתח (frame-ancestors). אי אפשר לנעול כך רכיב script שנטען לתוך עמוד הלקוח.
  • בלי התנגשויות סגנון. ה-CSS של הלקוח לא יכול לשבור את האפליקציה, וה-CSS שלנו לא יכול לגעת באתר שלו.
  • עדכונים בלי הלקוח. מובילים חדשים, תיקונים ופיצ’רים מגיעים לכל אתר באותו יום; אין מה לשדרג בצד הלקוח.
  • מנועי חיפוש. תוכן בתוך מסגרת לא מאונדקס כעמוד של הלקוח, בדיוק כמו בכל הטמעת מפה או וידאו. כשזה חשוב, הוסיפו את ה-snapshot המרונדר בשרת, ראו React ו-Next.js, עם אינדוקס חיפוש.

מבקרים לא מתחברים בתוך המסגרת, לכן חסימה של third-party cookies בדפדפן לא משפיעה עליה.

קישורים לתצוגה מדויקת אחת

בזמן שמבקר עובד באפליקציה, ה-URL של העמוד עוקב אחריו: ?navo_app=<app>&navo=<view>. כפתורי העתקת קישור בתוך האפליקציות מייצרים אותו סוג קישור. דוגמאות בעמוד לקוח /rates:

ViewLink
מכולה/track?navo_app=tracking&navo=ref%3DZMOU8956106
חיפוש תעריף ב-lane/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
תעריף אחדהחיפוש שלמעלה בתוספת %26quote%3D<id>
חיפוש הפלגה ב-lane/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
הפלגה אחתהחיפוש שלמעלה בתוספת %26sailing%3D<id>
אונייה/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
נמל/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

תעריף או הפלגה ששותפו ממשיכים להיפתח גם אחרי שכבר אינם חלק מהתוצאות החיות; הם מוצגים עם התאריך שבו הנתונים שלהם נלקחו.

בקשות הזמנה

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

  • דואר נשלח לכתובת ההזמנות של הלקוח, עם המסלול, הציוד, המוביל, המחיר שהמבקר ראה ופרטי הקשר של המבקר. Reply-To הוא המבקר, כך שהלקוח עונה ישירות מתיבת הדואר שלו;
  • אם מוגדר webhook, אותה בקשה נשלחת אליו ב-POST כ-JSON:
{
  "type": "booking.requested",
  "data": {
    "reference": "BR-261020-4F2A1",
    "received_at": "2026-10-20T14:05:11Z",
    "site": "acme.com",
    "contact": { "name": "…", "company": "…", "email": "…", "phone": "…" },
    "shipment": { "origin": "Shanghai (CNSHA)", "destination": "Hamburg (DEHAM)", "container": "40ft HC", "quantity": "2", "ready_date": "2026-11-03", "cargo": "…", "notes": "…" },
    "rate": { "id": "…", "carrier": "…", "price": 2140, "currency": "USD", "transit_days": 34, "departure": "2026-11-06", "valid_until": "2026-11-15" }
  }
}

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

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

מה מבקרים רואים, ומה לא

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

אבטחה

נעילת דומיין. עמודי האפליקציה עונים עם Content-Security-Policy: frame-ancestors שמפרט רק את הדומיינים של המפתח, כך שדפדפן מסרב להציג אותם בכל מקום אחר. בקשות נתונים כוללות את המפתח ואת ה-host של עמוד ההורה, ונדחות כשה-host אינו ברשימה. מפתח שהועתק לאתר אחר לא עובד שם.

מגבלות. לכל אפליקציה במפתח יש מגבלה חודשית או שנתית משלה (ראו מגבלות שימוש). נוסף על כך, לכל מפתח יש תקרת בטיחות של 50,000 בקשות בחודש, תקרה של 600 בקשות בדקה לכל האתר (כך שקפיצת תנועה באתר אחד לא תאט את האפליקציות עבור אחרים; ניתן להעלות לפי בקשה) ומגבלות קצב לכל מבקר נגד שימוש לרעה בסקריפטים; מעבר להן האפליקציה מציגה הודעת “נסה שוב” קצרה ומשגרת navo:limit.

הודעות. המסגרת וה-loader מדברים דרך postMessage, וכל צד שולח רק ל-origin המדויק של הצד השני: המסגרת לעמוד הלקוח, ה-loader אל navo24.com. פרטי חיפוש לעולם לא נשלחים אל *.

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

בדיקות לפני עלייה לאוויר

שלחו לנו את דומיין ה-staging יחד עם דומיין ה-production, או localhost:<port> למכונת פיתוח. שניהם יכולים לשבת על אותו מפתח.

Checklist

  1. הלקוח שולח שם, דומיינים, לוגו, צבע, דואר הזמנות, האפליקציות שרכש (מצב AI פעיל או כבוי) והמגבלה לכל אפליקציה (ואופציונלית webhook ונתיבי עמודים).
  2. אנחנו יוצרים את המפתח ושולחים את הקטעים.
  3. הלקוח מוסיף את embed.js ואת הקונטיינרים, קודם ב-staging.
  4. הלקוח בודק: חיפוש → tracking, תעריפים → פרטים → הזמנה (דואר בדיקה מגיע), קישור משותף נפתח באתר שלו. עם CSP מחמיר, בודקים בקונסול הדפדפן חסימות של navo24.com.
  5. הלקוח מוסיף את דומיין ה-production (אם עדיין לא ברשימה) ועולה לאוויר.