Οδηγοί
Οι εφαρμογές Navo στον ιστότοπο πελάτη
Ενσωματώστε tracking container στο site σας, μαζί με τιμές ναύλων, δρομολόγια και AI mode, με το brand σας, ένα script tag και domain-locked key.
Μπορείτε να ενσωματώσετε την παρακολούθηση container στον ιστότοπο του πελάτη, μαζί με ναύλους και προγράμματα αναχωρήσεων. Είναι οι ίδιες εφαρμογές που βλέπετε στο example forwarder site: ένα widget αναζήτησης για την αρχική σελίδα, συν μια πλήρη σελίδα για κάθε εφαρμογή. Κάθε εφαρμογή εμφανίζεται με το όνομα, το λογότυπο και το χρώμα του πελάτη. Κάθε προβολή έχει τον δικό της σύνδεσμο, ώστε ένας επισκέπτης να μπορεί να στείλει σε έναν συνάδελφο ένα container, μία αναζήτηση ναύλου, έναν ναύλο, ένα δρομολόγιο, ένα πλοίο ή ένα λιμάνι, και να ανοίξει στον ιστότοπο του πελάτη.
Δεν χρειάζεται API key ή server στην πλευρά του πελάτη. Το embed key είναι δημόσιο και λειτουργεί μόνο στα domains που δηλώνουμε για αυτό.
Τι μας στέλνει ο πελάτης
| Item | Example | Required |
|---|---|---|
| Επωνυμία εταιρείας όπως πρέπει να τη βλέπουν οι επισκέπτες | Acme Logistics | Yes |
| Domains όπου θα τρέχουν οι εφαρμογές (production, staging) | acme.com, www.acme.com, staging.acme.com | Yes |
| Λογότυπο, SVG ή PNG, τετράγωνο σήμα ή οριζόντιο | https://acme.com/logo.svg | Yes |
| Χρώμα brand, μία τιμή hex | #0e6ba8 | Yes |
| Περισσότερα χρώματα, γραμματοσειρές, στρογγύλεμα γωνιών | δείτε Look and feel | Optional |
| E-mail που λαμβάνει αιτήματα κράτησης | [email protected] | For freight rates |
| Webhook URL για αιτήματα κράτησης (προς το CRM/TMS τους) | https://acme.com/hooks/navo | Optional |
| Ποιες εφαρμογές θέλουν | οποιαδήποτε από tracking, freight, schedules, με AI mode ενεργό ή ανενεργό | Yes |
| Όριο χρήσης ανά εφαρμογή, ανά μήνα ή ανά έτος | tracking: 300 unique shipments a month | Yes |
| Σελίδες όπου θα βρίσκεται κάθε εφαρμογή | /track, /rates, /schedules | Recommended |
| “Powered by Navo” εμφανίζεται ή αποκρύπτεται | εμφανίζεται | Default: shown |
Δημιουργούμε το key και στέλνουμε πίσω τα παρακάτω snippets, με το key συμπληρωμένο.
Τι μπορεί να περιέχει ένα key
Ένα key ανοίγει μία εφαρμογή ή περισσότερες, και το AI mode είναι ξεχωριστή επιλογή:
| Package | Apps on the key | What the visitor gets |
|---|---|---|
| Μόνο tracking | tracking | Σελίδα tracking, το widget αναζήτησης δείχνει το πλαίσιο tracking χωρίς tabs και χωρίς AI switch |
| Tracking με AI | tracking, ai | Το ίδιο, συν AI mode στο widget αναζήτησης και “Ask AI” στα shipments |
| Rates και schedules | freight, schedules | Δύο tabs στο widget αναζήτησης, οι σελίδες rates και schedules |
| Όλα | tracking, freight, schedules, ai | Και τα τρία tabs, AI mode, όλες οι σελίδες |
Το widget χτίζεται από το key: ένα tab, μια σελίδα ή ένα AI button που δεν ανοίγει το key δεν σχεδιάζεται καθόλου, και ο server μας απορρίπτει τα δεδομένα του ακόμη κι αν κάποιος επιβάλει το request.
Όρια χρήσης
Κάθε εφαρμογή σε ένα key έχει το δικό της όριο, ανά ημερολογιακό μήνα ή ανά ημερολογιακό έτος (UTC). Τι μετράει ως μία μονάδα:
| App | One unit | Free 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η του επόμενου μήνα. Όταν μια εφαρμογή φτάσει το όριό της, οι επισκέπτες βλέπουν “Αυτή η υπηρεσία είναι προσωρινά σε παύση σε αυτόν τον ιστότοπο. Επικοινωνήστε με
Εγκατάσταση
Βάλτε τον 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) να οδηγούν στη σωστή σελίδα του ιστότοπου του πελάτη.
Επιλογές
| Attribute | What it does |
|---|---|
data-navo-app | search, tracking, freight ή schedules. |
data-navo-key | Το embed key του site. |
data-navo-pages | JSON map από app σε page path στον ιστότοπο του πελάτη. |
data-navo-height | Σταθερό ύψος σε px. Από προεπιλογή το frame μεγαλώνει με το περιεχόμενό του, το tracking είναι πλήρης χάρτης, 680 px. |
data-navo-sync | off κρατά το URL της σελίδας αμετάβλητο όσο ο επισκέπτης πλοηγείται. |
data-navo-theme | JSON με χρώματα, γραμματοσειρές και γωνίες, δείτε 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 πιάνει κάθε εφαρμογή στη σελίδα.
| Event | When | event.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 είναι προαιρετικό. Μια τιμή που δεν είναι έγκυρη αγνοείται, τα υπόλοιπα συνεχίζουν να εφαρμόζονται.
| Key | What it changes | Example |
|---|---|---|
accent | Κουμπιά, σύνδεσμοι, ενεργά tabs, switches, focus ring. Οι αποχρώσεις hover και pressed υπολογίζονται από αυτό | "#e4002b" |
text | Κύριο κείμενο | "#1a1a1a" |
muted | Δευτερεύον κείμενο: labels, hints, dates | "#6b7280" |
heading | Headings, ονόματα carrier και vessel, γραμμές χάρτη | "#002f6c" |
background | Page background της εφαρμογής. Το "transparent" αφήνει να φαίνεται το background του πελάτη | "#ffffff" |
surface | Cards, inputs, table stripes | "#f5f7fa" |
border | Borders και dividers | "#e5e7eb" |
success | Θετικές καταστάσεις: delivered, on time, cheapest | "#15803d" |
radius | Στρογγύλεμα γωνιών σε cards και panels, px (0 έως 40) | 8 |
buttonRadius | Στρογγύλεμα γωνιών σε buttons και inputs, px. Το 999 δίνει pills (η προεπιλογή) | 6 |
font | Body 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”).
Αποτελείται από δύο μέρη:
- Snapshot. Ο server του πελάτη παίρνει από εμάς τα δεδομένα του lane ως απλό HTML (schedule table ή rate table, heading, σύνοψη μίας γραμμής και schema.org markup) και τα βάζει στη δική του σελίδα. Οι μηχανές αναζήτησης το ευρετηριάζουν ως περιεχόμενο του πελάτη, στο URL του πελάτη.
- 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:
| View | Link |
|---|---|
| Ένα 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
- Ο πελάτης στέλνει όνομα, domains, λογότυπο, χρώμα, booking e-mail, τις εφαρμογές που αγόρασε (AI mode ενεργό ή ανενεργό) και το όριο για κάθε εφαρμογή (και προαιρετικά webhook, page paths).
- Δημιουργούμε το key και στέλνουμε τα snippets.
- Ο πελάτης προσθέτει το
embed.jsκαι τα containers, πρώτα σε staging. - Ο πελάτης ελέγχει: search → tracking, rates → details → booking (φτάνει ένα test e-mail), ένα shared link ανοίγει στο site του. Με αυστηρό CSP, ελέγξτε το browser console για μπλοκαρισμένο
navo24.com. - Ο πελάτης προσθέτει το production domain (αν δεν είναι ήδη στη λίστα) και κάνει go live.