Skip to content
Navo24Navo24

Οδηγοί

Οι εφαρμογές Navo στον ιστότοπο πελάτη

Ενσωματώστε tracking container στο site σας, μαζί με τιμές ναύλων, δρομολόγια και AI mode, με το brand σας, ένα script tag και domain-locked key.

Μπορείτε να ενσωματώσετε την παρακολούθηση container στον ιστότοπο του πελάτη, μαζί με ναύλους και προγράμματα αναχωρήσεων. Είναι οι ίδιες εφαρμογές που βλέπετε στο example forwarder site: ένα widget αναζήτησης για την αρχική σελίδα, συν μια πλήρη σελίδα για κάθε εφαρμογή. Κάθε εφαρμογή εμφανίζεται με το όνομα, το λογότυπο και το χρώμα του πελάτη. Κάθε προβολή έχει τον δικό της σύνδεσμο, ώστε ένας επισκέπτης να μπορεί να στείλει σε έναν συνάδελφο ένα container, μία αναζήτηση ναύλου, έναν ναύλο, ένα δρομολόγιο, ένα πλοίο ή ένα λιμάνι, και να ανοίξει στον ιστότοπο του πελάτη.

Δεν χρειάζεται API key ή server στην πλευρά του πελάτη. Το embed key είναι δημόσιο και λειτουργεί μόνο στα domains που δηλώνουμε για αυτό.

Τι μας στέλνει ο πελάτης

ItemExampleRequired
Επωνυμία εταιρείας όπως πρέπει να τη βλέπουν οι επισκέπτεςAcme LogisticsYes
Domains όπου θα τρέχουν οι εφαρμογές (production, staging)acme.com, www.acme.com, staging.acme.comYes
Λογότυπο, SVG ή PNG, τετράγωνο σήμα ή οριζόντιοhttps://acme.com/logo.svgYes
Χρώμα brand, μία τιμή hex#0e6ba8Yes
Περισσότερα χρώματα, γραμματοσειρές, στρογγύλεμα γωνιώνδείτε Look and feelOptional
E-mail που λαμβάνει αιτήματα κράτησης[email protected]For freight rates
Webhook URL για αιτήματα κράτησης (προς το CRM/TMS τους)https://acme.com/hooks/navoOptional
Ποιες εφαρμογές θέλουνοποιαδήποτε από tracking, freight, schedules, με AI mode ενεργό ή ανενεργόYes
Όριο χρήσης ανά εφαρμογή, ανά μήνα ή ανά έτοςtracking: 300 unique shipments a monthYes
Σελίδες όπου θα βρίσκεται κάθε εφαρμογή/track, /rates, /schedulesRecommended
“Powered by Navo” εμφανίζεται ή αποκρύπτεταιεμφανίζεταιDefault: shown

Δημιουργούμε το key και στέλνουμε πίσω τα παρακάτω snippets, με το key συμπληρωμένο.

Τι μπορεί να περιέχει ένα key

Ένα key ανοίγει μία εφαρμογή ή περισσότερες, και το AI mode είναι ξεχωριστή επιλογή:

PackageApps on the keyWhat the visitor gets
Μόνο trackingtrackingΣελίδα tracking, το widget αναζήτησης δείχνει το πλαίσιο tracking χωρίς tabs και χωρίς AI switch
Tracking με AItracking, aiΤο ίδιο, συν AI mode στο widget αναζήτησης και “Ask AI” στα shipments
Rates και schedulesfreight, schedulesΔύο tabs στο widget αναζήτησης, οι σελίδες rates και schedules
Όλαtracking, freight, schedules, aiΚαι τα τρία tabs, AI mode, όλες οι σελίδες

Το widget χτίζεται από το key: ένα tab, μια σελίδα ή ένα AI button που δεν ανοίγει το key δεν σχεδιάζεται καθόλου, και ο server μας απορρίπτει τα δεδομένα του ακόμη κι αν κάποιος επιβάλει το request.

Όρια χρήσης

Κάθε εφαρμογή σε ένα key έχει το δικό της όριο, ανά ημερολογιακό μήνα ή ανά ημερολογιακό έτος (UTC). Τι μετράει ως μία μονάδα:

AppOne unitFree repeats
trackingΈνα μοναδικό shipment (container, booking ή B/L number)Το ίδιο shipment για το υπόλοιπο της περιόδου
freightΜία αναζήτηση ναύλου (lane και equipment)Η ίδια αναζήτηση την ίδια ημέρα
schedulesΜία αναζήτηση schedule (route, vessel ή port)Η ίδια αναζήτηση την ίδια ημέρα
aiΜία ερώτηση στον AI assistantΚαμία

Παράδειγμα: tracking σε 300 μοναδικά shipments τον μήνα. Οι επισκέπτες του πελάτη μπορούν να ανοίγουν και να ανανεώνουν αυτά τα 300 shipments όσο συχνά θέλουν όλο τον μήνα, το shipment 301 απορρίπτεται μέχρι την 1η του επόμενου μήνα. Όταν μια εφαρμογή φτάσει το όριό της, οι επισκέπτες βλέπουν “Αυτή η υπηρεσία είναι προσωρινά σε παύση σε αυτόν τον ιστότοπο. Επικοινωνήστε με .” Οι άλλες εφαρμογές στο key συνεχίζουν να λειτουργούν. Βλέπουμε τη χρήση ανά εφαρμογή και μπορούμε να αυξήσουμε ένα όριο ανά πάσα στιγμή, χωρίς αλλαγή στον ιστότοπο του πελάτη.

Εγκατάσταση

Βάλτε τον loader μία φορά σε κάθε σελίδα που εμφανίζει εφαρμογή:

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

Έπειτα, ένα container στο σημείο όπου πρέπει να εμφανιστεί η εφαρμογή.

Widget αναζήτησης (home page hero ή οποιαδήποτε σελίδα). Ένα πλαίσιο με tab για κάθε εφαρμογή στο key (tracking, rates, schedules) και AI mode αν το key το περιλαμβάνει. Με μία εφαρμογή δεν υπάρχουν tabs:

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

Με data-navo-pages το widget στέλνει τους επισκέπτες στις σελίδες του ίδιου του πελάτη. Χωρίς αυτό, το αποτέλεσμα ανοίγει μέσα στο frame του widget.

Σελίδα tracking (/track):

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

Σελίδα freight rates (/rates):

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

Σελίδα sailing schedules (/schedules), με τρία tabs: by route, by vessel, by port:

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

Χρησιμοποιήστε την ίδια τιμή data-navo-pages σε κάθε εφαρμογή, ώστε τα cross-links (για παράδειγμα “Show rates” σε ένα sailing ή “Vessel schedule” σε ένα shipment) να οδηγούν στη σωστή σελίδα του ιστότοπου του πελάτη.

Επιλογές

AttributeWhat it does
data-navo-appsearch, tracking, freight ή schedules.
data-navo-keyΤο embed key του site.
data-navo-pagesJSON map από app σε page path στον ιστότοπο του πελάτη.
data-navo-heightΣταθερό ύψος σε px. Από προεπιλογή το frame μεγαλώνει με το περιεχόμενό του, το tracking είναι πλήρης χάρτης, 680 px.
data-navo-syncoff κρατά το URL της σελίδας αμετάβλητο όσο ο επισκέπτης πλοηγείται.
data-navo-themeJSON με χρώματα, γραμματοσειρές και γωνίες, δείτε Look and feel.

Sites με Content Security Policy

Αν το site στέλνει header Content-Security-Policy (ή ένα <meta http-equiv>) με script-src ή frame-src, προσθέστε το navo24.com και στα δύο, διαφορετικά ο browser μπλοκάρει τον loader ή το frame και το container μένει κενό:

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

Με child-src αντί για frame-src, προσθέστε το εκεί. Δεν χρειάζεται τίποτα άλλο: οι εφαρμογές φορτώνουν τα δεδομένα, τις γραμματοσειρές και τους χάρτες τους μέσα στο frame, κάτω από τη δική μας πολιτική. Το browser console αναφέρει ποια οδηγία μπλοκαρίστηκε αν κάτι λείπει.

Events για analytics και CRM

Το container εκπέμπει DOM events όταν ένας επισκέπτης κάνει κάτι, ώστε το site να μπορεί να τα στείλει στο Google Analytics, σε tag manager ή στο CRM του. Τα events κάνουν bubble, άρα ένας listener στο document πιάνει κάθε εφαρμογή στη σελίδα.

EventWhenevent.detail
navo:searchΜια αναζήτηση επέστρεψε αποτελέσματαapp (tracking, freight, schedules) και το query: 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>

Τα στοιχεία επικοινωνίας του επισκέπτη δεν περιλαμβάνονται στα events: πηγαίνουν μόνο στο booking e-mail και στο webhook.

Εμφάνιση και αίσθηση

Από προεπιλογή, οι εφαρμογές παίρνουν το brand colour του πελάτη από το key. Για πιο ακριβή αντιστοίχιση με το site, προσθέστε data-navo-theme στο container: χρώματα, γραμματοσειρές, στρογγύλεμα γωνιών και dark mode.

<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>

Κάθε key είναι προαιρετικό. Μια τιμή που δεν είναι έγκυρη αγνοείται, τα υπόλοιπα συνεχίζουν να εφαρμόζονται.

KeyWhat it changesExample
accentΚουμπιά, σύνδεσμοι, ενεργά tabs, switches, focus ring. Οι αποχρώσεις hover και pressed υπολογίζονται από αυτό"#e4002b"
textΚύριο κείμενο"#1a1a1a"
mutedΔευτερεύον κείμενο: labels, hints, dates"#6b7280"
headingHeadings, ονόματα carrier και vessel, γραμμές χάρτη"#002f6c"
backgroundPage background της εφαρμογής. Το "transparent" αφήνει να φαίνεται το background του πελάτη"#ffffff"
surfaceCards, inputs, table stripes"#f5f7fa"
borderBorders και dividers"#e5e7eb"
successΘετικές καταστάσεις: delivered, on time, cheapest"#15803d"
radiusΣτρογγύλεμα γωνιών σε cards και panels, px (0 έως 40)8
buttonRadiusΣτρογγύλεμα γωνιών σε buttons και inputs, px. Το 999 δίνει pills (η προεπιλογή)6
fontBody font. Οποιαδήποτε οικογένεια Google Fonts φορτώνεται για εσάς, το "system" χρησιμοποιεί τη γραμματοσειρά συστήματος του επισκέπτη"Inter"
headingFontΓραμματοσειρά για headings, ίδιοι κανόνες. Χωρίς αυτό, τα headings χρησιμοποιούν το font"Playfair Display"
fontCssΤο δικό σας font stylesheet (https:// URL με κανόνες @font-face), για γραμματοσειρές που δεν είναι στο Google Fonts. Τότε τα font και headingFont ονομάζουν οικογένειες από αυτό το αρχείο"https://acme.com/fonts/brand.css"
mode"dark" για sites με dark design"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"}'

Ένα theme για όλες τις σελίδες. Μπορούμε επίσης να αποθηκεύσουμε το theme στο key. Τότε κάθε container σε κάθε σελίδα το παίρνει χωρίς το attribute, και μπορούμε να το προσαρμόσουμε αργότερα χωρίς αλλαγή στον ιστότοπο του πελάτη. Το data-navo-theme σε ένα container εξακολουθεί να υπερισχύει του theme του key, key προς key.

Το theme φτάνει μόνο στην εφαρμογή μέσα στο frame: δεν αλλάζει ποτέ τη σελίδα του ίδιου του πελάτη.

React και Next.js, με search indexing

Χρησιμοποιήστε αυτό όταν ο ιστότοπος του πελάτη έχει χτιστεί με React ή Next.js και το περιεχόμενο της εφαρμογής πρέπει να ευρετηριαστεί ως σελίδα του πελάτη (για παράδειγμα, μία σελίδα ανά lane, “Shanghai to Hamburg sailing schedule”).

Αποτελείται από δύο μέρη:

  1. Snapshot. Ο server του πελάτη παίρνει από εμάς τα δεδομένα του lane ως απλό HTML (schedule table ή rate table, heading, σύνοψη μίας γραμμής και schema.org markup) και τα βάζει στη δική του σελίδα. Οι μηχανές αναζήτησης το ευρετηριάζουν ως περιεχόμενο του πελάτη, στο URL του πελάτη.
  2. App. Στον browser η διαδραστική εφαρμογή γίνεται mount από πάνω, με αναζήτηση, filters, details και booking. Το snapshot μένει στη σελίδα ως collapsible table κάτω από την εφαρμογή, ώστε crawlers και επισκέπτες να βλέπουν το ίδιο περιεχόμενο.

Snapshot endpoint

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> της σελίδας και το meta description, και html για το body. Η απάντηση μπορεί να γίνει cache για 30 λεπτά (Cache-Control: max-age=1800). Ένα snapshot μετράει ως μία αναζήτηση στο όριο της εφαρμογής, το ίδιο lane την ίδια ημέρα είναι δωρεάν. Το tracking δεν έχει snapshot: τα shipments είναι ιδιωτικά για τον επισκέπτη.

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>
      )}
    </>
  );
}

Πώς φαίνεται αυτό σε μια μηχανή αναζήτησης: ο τίτλος και η περιγραφή της ίδιας της σελίδας, ένα heading και ένας πλήρης πίνακας sailings (ή rates) στο HTML, με Dataset markup. Πώς φαίνεται σε έναν επισκέπτη: η live εφαρμογή, ήδη ανοιχτή σε εκείνο το lane, με τα ίδια αποτελέσματα ως διπλωμένο table από κάτω. Οι επισκέπτες με JavaScript κλειστό βλέπουν το ανοιχτό table. Το table είναι διπλωμένο, όχι κρυμμένο, ώστε η σελίδα να μη δείχνει στους crawlers κάτι που ένας επισκέπτης δεν μπορεί να ανοίξει.

Το snapshot HTML έρχεται από τον server μας με κάθε τιμή escaped, άρα είναι ασφαλές να εισαχθεί. Κάντε το styling με τις κλάσεις .navo-snapshot και .navo-snapshot-table αν εμφανιστεί ποτέ.

Άλλα server frameworks (Remix, Astro, Nuxt, PHP, WordPress) λειτουργούν με τον ίδιο τρόπο: κάντε fetch το snapshot στον server, εκτυπώστε το html στη σελίδα, βάλτε το container δίπλα του.

Απλό React (χωρίς server rendering)

Όταν το search indexing δεν έχει σημασία (μια σελίδα tracking πίσω από menu, ένα intranet), το component χωρίς snapshot αρκεί:

Ο loader λειτουργεί το ίδιο σε single-page app (React, Vue, Svelte): κάντε render το container και μετά καλέστε 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').

Γιατί frame

Ο loader σχεδιάζει κάθε εφαρμογή μέσα σε frame από το navo24.com. Έτσι λειτουργούν το Stripe Checkout, τα Google Maps embeds και οι YouTube players, για τους ίδιους λόγους:

  • Domain lock. Ο ίδιος ο browser αρνείται να εμφανίσει την εφαρμογή σε site που δεν βρίσκεται στη λίστα του key (frame-ancestors). Ένα script component που φορτώνεται στη σελίδα του πελάτη δεν μπορεί να κλειδωθεί με αυτόν τον τρόπο.
  • Χωρίς συγκρούσεις στυλ. Το CSS του πελάτη δεν μπορεί να χαλάσει την εφαρμογή και το δικό μας CSS δεν μπορεί να αγγίξει το site του.
  • Ενημερώσεις χωρίς τον πελάτη. Νέοι carriers, διορθώσεις και δυνατότητες φτάνουν σε κάθε site την ίδια ημέρα, δεν υπάρχει τίποτα για αναβάθμιση στην πλευρά του πελάτη.
  • Μηχανές αναζήτησης. Το περιεχόμενο μέσα σε frame δεν ευρετηριάζεται ως σελίδα του πελάτη, όπως και με κάθε map ή video embed. Όταν αυτό έχει σημασία, προσθέστε το server-rendered snapshot, δείτε React and Next.js, with search indexing.

Οι επισκέπτες δεν κάνουν log in μέσα στο frame, άρα το μπλοκάρισμα third-party cookies από τον browser δεν το επηρεάζει.

Σύνδεσμοι προς μία ακριβή προβολή

Όσο ένας επισκέπτης δουλεύει σε μια εφαρμογή, το URL της σελίδας τον ακολουθεί: ?navo_app=<app>&navo=<view>. Τα κουμπιά Copy link μέσα στις εφαρμογές παράγουν τον ίδιο τύπο συνδέσμου. Παραδείγματα σε σελίδα πελάτη /rates:

ViewLink
Ένα container/track?navo_app=tracking&navo=ref%3DZMOU8956106
Αναζήτηση ναύλου σε lane/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
Ένας ναύλοςη παραπάνω αναζήτηση συν %26quote%3D<id>
Αναζήτηση sailing σε lane/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
Ένα sailingη παραπάνω αναζήτηση συν %26sailing%3D<id>
Ένα vessel/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
Ένα port/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

Ένας κοινόχρηστος ναύλος ή sailing συνεχίζει να ανοίγει αφού φύγει από τα live results, εμφανίζεται με την ημερομηνία από την οποία ελήφθησαν τα δεδομένα του.

Αιτήματα κράτησης

Το Book σε έναν ναύλο ανοίγει μια φόρμα αιτήματος (contact, company, e-mail, phone, number of containers, cargo-ready date, cargo, notes). Κατά την υποβολή:

  • ένα e-mail πηγαίνει στη διεύθυνση booking του πελάτη, με το route, το equipment, τον carrier, την τιμή που είδε ο επισκέπτης και τα στοιχεία επικοινωνίας του επισκέπτη. Το Reply-To είναι ο επισκέπτης, ώστε ο πελάτης να απαντά απευθείας από το mailbox του,
  • αν έχει οριστεί 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" }
  }
}

Ο επισκέπτης βλέπει επιβεβαίωση με το reference. Δεν γίνεται χρέωση και δεν δημιουργείται carrier booking: ο πελάτης επιβεβαιώνει τη διαθεσιμότητα και απαντά.

Χωρίς booking e-mail ή webhook, η φόρμα παραμένει demo και το αναφέρει.

Τι βλέπουν οι επισκέπτες και τι δεν βλέπουν

  • Ονόματα και λογότυπα carrier, τιμές, transit times, validity και τι περιλαμβάνει ένας ναύλος.
  • Οι ναύλοι χωρίς carrier named εμφανίζονται ως ” Select”, με το λογότυπο του πελάτη.
  • Rate sources και platforms δεν εμφανίζονται ποτέ. Αφαιρούνται στον server μας πριν τα δεδομένα φτάσουν στον browser.

Ασφάλεια

Domain lock. Οι σελίδες της εφαρμογής απαντούν με Content-Security-Policy: frame-ancestors που απαριθμεί μόνο τα domains του key, άρα ο browser αρνείται να τις εμφανίσει οπουδήποτε αλλού. Τα data requests μεταφέρουν το key και το host της parent page και απορρίπτονται όταν το host δεν είναι στη λίστα. Ένα key που αντιγράφεται σε άλλο site δεν λειτουργεί εκεί.

Όρια. Κάθε εφαρμογή σε ένα key έχει το δικό της μηνιαίο ή ετήσιο όριο (δείτε Usage limits). Επιπλέον, κάθε key έχει safety cap 50,000 requests τον μήνα, ανώτατο όριο 600 requests το λεπτό για ολόκληρο το site (ώστε ένα traffic spike ενός site να μην επιβραδύνει τις εφαρμογές για άλλους, αυξάνεται κατόπιν αιτήματος) και per-visitor rate limits απέναντι σε scripted abuse, πάνω από αυτά η εφαρμογή δείχνει ένα σύντομο μήνυμα “try again” και εκπέμπει navo:limit.

Μηνύματα. Το frame και ο loader επικοινωνούν μέσω postMessage, και κάθε πλευρά στέλνει μόνο στο ακριβές origin της άλλης: το frame στη σελίδα του πελάτη, ο loader στο navo24.com. Τα στοιχεία αναζήτησης δεν πηγαίνουν ποτέ σε *.

Rotation. Αν ένα key διαρρεύσει ή ένα site αλλάξει ιδιοκτησία, εκδίδουμε νέο key και το παλιό σταματά να λειτουργεί αμέσως.

Δοκιμές πριν το launch

Στείλτε μας το staging domain μαζί με το production, ή localhost:<port> για μηχάνημα developer. Και τα δύο μπορούν να βρίσκονται στο ίδιο key.

Checklist

  1. Ο πελάτης στέλνει όνομα, domains, λογότυπο, χρώμα, booking e-mail, τις εφαρμογές που αγόρασε (AI mode ενεργό ή ανενεργό) και το όριο για κάθε εφαρμογή (και προαιρετικά webhook, page paths).
  2. Δημιουργούμε το key και στέλνουμε τα snippets.
  3. Ο πελάτης προσθέτει το embed.js και τα containers, πρώτα σε staging.
  4. Ο πελάτης ελέγχει: search → tracking, rates → details → booking (φτάνει ένα test e-mail), ένα shared link ανοίγει στο site του. Με αυστηρό CSP, ελέγξτε το browser console για μπλοκαρισμένο navo24.com.
  5. Ο πελάτης προσθέτει το production domain (αν δεν είναι ήδη στη λίστα) και κάνει go live.