სახელმძღვანელოები
Navo-ს აპები კლიენტის საიტზე
ჩააშენეთ კონტეინერის ტრეკინგი საიტზე, ფრახტის ტარიფები, გემების განრიგები და AI რეჟიმი თქვენი ბრენდით, ერთი script tag-ით და დომენზე მიბმული გასაღებით.
კლიენტის საკუთარ ვებსაიტზე შეგიძლიათ ჩასვათ კონტეინერების თვალთვალი, ასევე სატვირთო ტარიფები და საზღვაო განრიგები. ეს იგივე აპებია, რომლებსაც სატესტო ფორვარდერის საიტზე ხედავთ: საძიებო ვიჯეტი მთავარი გვერდისთვის, და თითო აპისთვის სრული გვერდი. თითოეული ნაჩვენებია კლიენტის სახელით, ლოგოთი და ფერით. ყველა ხედს საკუთარი ბმული აქვს, ამიტომ ვიზიტორს შეუძლია კოლეგას გაუგზავნოს ერთი კონტეინერი, ერთი ტარიფის ძიება, ერთი ტარიფი, ერთი რეისი, ერთი გემი ან ერთი პორტი, და ის კლიენტის საიტზე გაიხსნება.
კლიენტის მხარეს API გასაღები ან სერვერი საჭირო არ არის. embed გასაღები საჯაროა და მუშაობს მხოლოდ იმ დომენებზე, რომლებსაც მისთვის მივუთითებთ.
რას გვიგზავნის კლიენტი
| Item | Example | Required |
|---|---|---|
| კომპანიის სახელი, როგორც ვიზიტორებმა უნდა დაინახონ | Acme Logistics | Yes |
| დომენები, რომლებზეც აპები იმუშავებს (production, staging) | acme.com, www.acme.com, staging.acme.com | Yes |
| ლოგო, SVG ან PNG, კვადრატული ნიშანი ან ჰორიზონტალური | https://acme.com/logo.svg | Yes |
| ბრენდის ფერი, ერთი hex მნიშვნელობა | #0e6ba8 | Yes |
| დამატებითი ფერები, ფონტები, კუთხეების მომრგვალება | იხილეთ ვიზუალი და სტილი | Optional |
| ელფოსტა, რომელიც ჯავშნის მოთხოვნებს მიიღებს | [email protected] | For freight rates |
| Webhook URL ჯავშნის მოთხოვნებისთვის (მათ CRM/TMS-ში) | https://acme.com/hooks/navo | Optional |
| რომელი აპები სურთ | ნებისმიერი tracking, freight, schedules-დან; AI რეჟიმი ჩართული ან გამორთული | Yes |
| გამოყენების ლიმიტი თითო აპზე, თვეში ან წელიწადში | tracking: 300 უნიკალური გადაზიდვა თვეში | Yes |
| გვერდები, სადაც თითოეული აპი განთავსდება | /track, /rates, /schedules | Recommended |
"Powered by Navo" ნაჩვენებია თუ დამალულია | ნაჩვენებია | Default: shown |
ჩვენ ვქმნით გასაღებს და უკან ვაგზავნით ქვემოთ მოცემულ snippet-ებს, უკვე შევსებული გასაღებით.
რას ატარებს ერთი გასაღები
გასაღები ხსნის ერთ ან რამდენიმე აპს, ხოლო AI რეჟიმი ცალკე გადამრთველია:
| Package | Apps on the key | What the visitor gets |
|---|---|---|
| მხოლოდ Tracking | tracking | Tracking გვერდი; საძიებო ვიჯეტი აჩვენებს tracking ველს tab-ების და AI გადამრთველის გარეშე |
| Tracking AI-ით | tracking, ai | იგივე, დამატებით AI რეჟიმი საძიებო ვიჯეტში და “ჰკითხე AI-ს” გადაზიდვებზე |
| Rates და schedules | freight, schedules | ორი tab საძიებო ვიჯეტში, rates და schedules გვერდები |
| ყველაფერი | tracking, freight, schedules, ai | სამივე tab, AI რეჟიმი, ყველა გვერდი |
ვიჯეტი გასაღებიდან იქმნება: tab, გვერდი ან AI ღილაკი, რომელსაც გასაღები არ ხსნის, საერთოდ არ იხატება, და ჩვენი სერვერი მის მონაცემებსაც უარყოფს, თუნდაც ვინმემ მოთხოვნა ხელით აიძულოს.
გამოყენების ლიმიტები
გასაღებზე თითო აპს საკუთარი ლიმიტი აქვს, კალენდარული თვის ან კალენდარული წლის მიხედვით (UTC). რა ითვლება ერთ ერთეულად:
| App | One unit | Free repeats |
|---|---|---|
tracking | ერთი უნიკალური გადაზიდვა (კონტეინერი, booking ან B/L ნომერი) | იგივე გადაზიდვა პერიოდის ბოლომდე |
freight | ერთი ტარიფის ძიება (მარშრუტი და equipment) | იგივე ძიება იმავე დღეს |
schedules | ერთი განრიგის ძიება (მარშრუტი, გემი ან პორტი) | იგივე ძიება იმავე დღეს |
ai | ერთი კითხვა AI ასისტენტთან | None |
მაგალითი: tracking, თვეში 300 უნიკალური გადაზიდვა. კლიენტის ვიზიტორებს შეუძლიათ ეს 300 გადაზიდვა მთელი თვის განმავლობაში რამდენჯერაც სურთ გახსნან და განაახლონ; 301-ე გადაზიდვა უარყოფილი იქნება შემდეგი თვის 1 რიცხვამდე. როცა აპი ლიმიტს მიაღწევს, ვიზიტორები ხედავენ “ეს სერვისი ამ საიტზე დროებით შეჩერებულია. გთხოვთ, დაუკავშირდეთ
ინსტალაცია
ჩასვით loader ერთხელ ყველა გვერდზე, სადაც აპი უნდა გამოჩნდეს:
<script src="https://navo24.com/embed.js" async></script>
შემდეგ დაამატეთ კონტეინერი იმ ადგილას, სადაც აპი უნდა გამოჩნდეს.
საძიებო ვიჯეტი (მთავარი გვერდის hero სექცია, ან ნებისმიერი გვერდი). ერთი ველი tab-ით გასაღებზე არსებული თითო აპისთვის (tracking, rates, schedules) და AI რეჟიმით, თუ გასაღებს ის აქვს. ერთი აპის შემთხვევაში tab-ები არ არის:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
data-navo-pages-ით ვიჯეტი ვიზიტორებს კლიენტის საკუთარ გვერდებზე აგზავნის. მის გარეშე შედეგი პირდაპირ ვიჯეტის frame-ში იხსნება.
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), სამი tab-ით: მარშრუტით, გემით, პორტით:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
გამოიყენეთ იგივე data-navo-pages მნიშვნელობა ყველა აპზე, რათა cross-link-ები (მაგალითად “ტარიფების ჩვენება” sailing-ზე, ან “გემის განრიგი” გადაზიდვაზე) კლიენტის საიტის სწორ გვერდზე გადავიდეს.
Options
| Attribute | What it does |
|---|---|
data-navo-app | search, tracking, freight ან schedules. |
data-navo-key | საიტის embed გასაღები. |
data-navo-pages | JSON map, რომელიც აპს კლიენტის საიტზე გვერდის path-ს უკავშირებს. |
data-navo-height | ფიქსირებული სიმაღლე px-ში. ნაგულისხმევად frame იზრდება შიგთავსის მიხედვით; tracking არის სრული რუკა, 680 px. |
data-navo-sync | off გვერდის URL-ს უცვლელად ტოვებს, სანამ ვიზიტორი აპში გადაადგილდება. |
data-navo-theme | JSON ფერებით, ფონტებით და კუთხეებით, იხილეთ ვიზუალი და სტილი. |
საიტები Content Security Policy-ით
თუ საიტი აგზავნის Content-Security-Policy header-ს (ან <meta http-equiv>-ს) script-src ან frame-src-ით, ორივეში დაამატეთ navo24.com, წინააღმდეგ შემთხვევაში ბრაუზერი დაბლოკავს loader-ს ან frame-ს და კონტეინერი ცარიელი დარჩება:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
თუ frame-src-ის ნაცვლად child-src გამოიყენება, იქ დაამატეთ. მეტი არაფერი არის საჭირო: აპები საკუთარ მონაცემებს, ფონტებს და რუკებს frame-ის შიგნით ტვირთავს, ჩვენი საკუთარი policy-ის ქვეშ. თუ რამე აკლია, ბრაუზერის console დაბლოკილ directive-ს მიუთითებს.
Events ანალიტიკისა და CRM-ისთვის
როცა ვიზიტორი რამეს აკეთებს, კონტეინერი DOM event-ებს უშვებს, ამიტომ საიტს შეუძლია ისინი Google Analytics-ში, tag manager-ში ან საკუთარ CRM-ში გაგზავნოს. ისინი bubble-დება, ამიტომ document-ზე ერთი listener გვერდზე არსებულ ყველა აპს დაიჭერს.
| 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>
ვიზიტორის საკონტაქტო დეტალები event-ებში არ არის: ისინი მხოლოდ booking ელფოსტასა და webhook-ში მიდის.
ვიზუალი და სტილი
ნაგულისხმევად აპები კლიენტის ბრენდის ფერს გასაღებიდან იღებს. საიტთან უფრო ზუსტად დასამთხვევად კონტეინერს დაამატეთ data-navo-theme: ფერები, ფონტები, კუთხეების მომრგვალება და 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 | ღილაკები, ბმულები, active tab-ები, switches, focus ring. Hover და pressed ჩრდილები მისგან გამოითვლება | "#e4002b" |
text | ძირითადი ტექსტი | "#1a1a1a" |
muted | მეორეული ტექსტი: labels, hints, dates | "#6b7280" |
heading | სათაურები, carrier და vessel სახელები, map lines | "#002f6c" |
background | აპის გვერდის ფონი. "transparent" კლიენტის საკუთარ ფონს აჩენს | "#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 pill ფორმას იძლევა (ნაგულისხმევი) | 6 |
font | ძირითადი ტექსტის ფონტი. ნებისმიერი Google Fonts family ავტომატურად ჩაიტვირთება; "system" ვიზიტორის სისტემურ ფონტს იყენებს | "Inter" |
headingFont | სათაურების ფონტი, იგივე წესებით. თუ არ არის მითითებული, სათაურები font-ს იყენებს | "Playfair Display" |
fontCss | თქვენი საკუთარი font stylesheet (https:// URL @font-face წესებით), ისეთი ფონტებისთვის, რომლებიც Google Fonts-ზე არ არის. შემდეგ font და headingFont ამ ფაილიდან family-ების სახელებს მიუთითებს | "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"}'
ერთი theme ყველა გვერდისთვის. theme შეგვიძლია გასაღებზეც შევინახოთ. ამ შემთხვევაში ყველა გვერდის ყველა კონტეინერი მას attribute-ის გარეშე მიიღებს, და მოგვიანებით შეგვიძლია მისი შეცვლა კლიენტის საიტზე ცვლილების გარეშე. კონტეინერზე მითითებული data-navo-theme მაინც უპირატესია გასაღების theme-ზე, key-by-key.
theme მხოლოდ frame-ის შიგნით არსებულ აპამდე მიდის: ის კლიენტის საკუთარ გვერდს არასდროს ცვლის.
React და Next.js, search indexing-ით
გამოიყენეთ ეს, როცა კლიენტის საიტი React-ით ან Next.js-ით არის აწყობილი და აპის კონტენტი კლიენტის გვერდად უნდა დაინდექსდეს (მაგალითად, გვერდი თითო lane-ზე, “Shanghai to Hamburg sailing schedule”).
ის ორი ნაწილისგან შედგება:
- Snapshot. კლიენტის სერვერი lane-ის მონაცემებს ჩვენგან plain HTML-ად იღებს (schedule table ან rate table, სათაური, ერთხაზიანი summary და schema.org markup) და საკუთარ გვერდში სვამს. საძიებო სისტემები მას კლიენტის კონტენტად, კლიენტის URL-ზე ინდექსავენ.
- App. ბრაუზერში interactive app მის ზემოთ mount-დება, search-ით, filters-ით, details-ით და booking-ით. Snapshot გვერდზე რჩება collapsible table-ად აპის ქვეშ, ამიტომ crawlers და visitors ერთსა და იმავე კონტენტს ხედავენ.
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-სთვის. პასუხი შეიძლება 30 წუთით დაიქეშოს (Cache-Control: max-age=1800). Snapshot ითვლება ერთ ძიებად აპის ლიმიტში; იგივე lane იმავე დღეს უფასოა. Tracking-ს snapshot არ აქვს: გადაზიდვები ვიზიტორისთვის private-ია.
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>
)}
</>
);
}
როგორ ჩანს ეს საძიებო სისტემისთვის: გვერდის საკუთარი title და description, heading და sailings-ის (ან rates-ის) სრული table HTML-ში, Dataset markup-ით. როგორ ჩანს ვიზიტორისთვის: live app, უკვე გახსნილი იმ lane-ზე, იგივე შედეგებით folded table-ად მის ქვეშ. JavaScript გამორთული ვიზიტორები ღია table-ს ხედავენ. Table folded არის, არა hidden, ამიტომ გვერდი crawlers-ს არ აჩვენებს არაფერს, რასაც ვიზიტორი ვერ გახსნის.
Snapshot HTML ჩვენი სერვერიდან მოდის ყველა მნიშვნელობით escaped, ამიტომ მისი ჩასმა უსაფრთხოა. თუ ოდესმე გამოჩნდება, დაასტილეთ .navo-snapshot და .navo-snapshot-table კლასებით.
სხვა server framework-ებიც (Remix, Astro, Nuxt, PHP, WordPress) იგივე პრინციპით მუშაობს: snapshot სერვერზე წამოიღეთ, html გვერდში დაბეჭდეთ, კონტეინერი მის გვერდით ჩასვით.
Plain React (server rendering-ის გარეშე)
როცა search indexing მნიშვნელოვანი არ არის (tracking გვერდი მენიუს მიღმა, intranet), snapshot-ის გარეშე component საკმარისია:
Loader იგივე მუშაობს single-page app-ში (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').
რატომ frame
Loader თითო აპს navo24.com-იდან frame-ის შიგნით ხატავს. ასე მუშაობს Stripe Checkout, Google Maps embeds და YouTube players, იგივე მიზეზებით:
- Domain lock. ბრაუზერი თავად უარს ამბობს აპის ჩვენებაზე საიტზე, რომელიც გასაღების სიაში არ არის (
frame-ancestors). კლიენტის გვერდში ჩატვირთულ script component-ს ასე ვერ ჩავკეტავთ. - სტილებთან კონფლიქტი არ არის. კლიენტის CSS აპს ვერ გააფუჭებს და ჩვენი CSS მათ საიტს ვერ შეეხება.
- განახლებები კლიენტის ჩარევის გარეშე. ახალი carriers, fixes და features ყველა საიტამდე იმავე დღეს მიდის; კლიენტის მხარეს არაფერია გასაახლებელი.
- საძიებო სისტემები. Frame-ის შიგნით კონტენტი კლიენტის გვერდად არ ინდექსდება, ისევე როგორც ნებისმიერი map ან video embed. როცა ეს მნიშვნელოვანია, დაამატეთ server-rendered snapshot, იხილეთ React და Next.js, search indexing-ით.
ვიზიტორები frame-ის შიგნით არ შედიან ანგარიშში, ამიტომ third-party cookies-ის ბრაუზერული დაბლოკვა მასზე არ მოქმედებს.
ბმულები ზუსტ ხედზე
როცა ვიზიტორი აპში მუშაობს, გვერდის URL მას მიყვება: ?navo_app=<app>&navo=<view>. აპებში არსებული Copy link ღილაკები იგივე ტიპის ბმულს ქმნის. მაგალითები კლიენტის გვერდზე /rates:
| View | Link |
|---|---|
| კონტეინერი | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| ტარიფის ძიება lane-ზე | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| ერთი ტარიფი | ზემოთ მოცემული search პლუს %26quote%3D<id> |
| sailing ძიება lane-ზე | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| ერთი sailing | ზემოთ მოცემული search პლუს %26sailing%3D<id> |
| გემი | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| პორტი | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
გაზიარებული rate ან sailing გახსნას აგრძელებს მას შემდეგაც, რაც live results-იდან გაქრება; ის ნაჩვენებია იმ თარიღით, როცა მისი მონაცემები აღებულია.
Booking requests
Book rate-ზე ხსნის request form-ს (contact, company, e-mail, phone, number of containers, cargo-ready date, cargo, notes). გაგზავნისას:
- ელფოსტა მიდის კლიენტის booking მისამართზე, route-ით, equipment-ით, carrier-ით, იმ ფასით, რომელიც ვიზიტორმა ნახა, და ვიზიტორის საკონტაქტო დეტალებით. Reply-To არის ვიზიტორი, ამიტომ კლიენტი პირდაპირ საკუთარი mailbox-იდან პასუხობს;
- თუ webhook დაყენებულია, იგივე მოთხოვნა მას JSON-ად POST-დება:
{
"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 არ იქმნება: კლიენტი ადასტურებს space-ს და პასუხობს.
booking ელფოსტის ან webhook-ის გარეშე form demo-დ რჩება და ამას ამბობს.
რას ხედავენ ვიზიტორები და რას არა
- Carrier სახელები და ლოგოები, ფასები, transit times, validity და რა შედის rate-ში.
- Rates, სადაც carrier დასახელებული არ არის, ნაჩვენებია როგორც ”
Select”, კლიენტის ლოგოთი. - Rate sources და platforms არასდროს ჩანს. ისინი ჩვენი სერვერიდან იშლება, სანამ მონაცემები ბრაუზერამდე მივა.
უსაფრთხოება
Domain lock. აპის გვერდები პასუხობს Content-Security-Policy: frame-ancestors-ით, სადაც მხოლოდ გასაღების დომენებია ჩამოთვლილი, ამიტომ ბრაუზერი მათ სხვაგან ჩვენებაზე უარს ამბობს. Data requests თან ატარებს გასაღებს და parent page-ის host-ს, და უარყოფილია, როცა host სიაში არ არის. სხვა საიტში დაკოპირებული გასაღები იქ არ იმუშავებს.
Limits. გასაღებზე თითო აპს საკუთარი თვიური ან წლიური ლიმიტი აქვს (იხილეთ გამოყენების ლიმიტები). ამას გარდა, თითოეულ გასაღებს აქვს safety cap, 50,000 request თვეში, 600 request წუთში მთელ საიტზე ceiling (რათა ერთი საიტის traffic spike-მა სხვებისთვის აპები არ შეანელოს; მოთხოვნით იზრდება) და per-visitor rate limits scripted abuse-ის წინააღმდეგ; გადაჭარბებისას აპი მოკლე “სცადეთ თავიდან” შეტყობინებას აჩვენებს და navo:limit-ს უშვებს.
Messages. Frame და loader ერთმანეთს postMessage-ით ელაპარაკება, და თითოეული მხარე აგზავნის მხოლოდ მეორე მხარის ზუსტ origin-ზე: frame კლიენტის გვერდზე, loader navo24.com-ზე. Search details არასდროს მიდის *-ზე.
Rotation. თუ გასაღები გაჟონა ან საიტს მფლობელი შეეცვალა, ახალ გასაღებს გამოვცემთ და ძველი დაუყოვნებლივ წყვეტს მუშაობას.
ტესტირება გაშვებამდე
production დომენთან ერთად გამოგვიგზავნეთ staging დომენიც, ან localhost:<port> დეველოპერის მანქანისთვის. ორივე შეიძლება ერთ გასაღებზე იყოს.
Checklist
- კლიენტი აგზავნის სახელს, დომენებს, ლოგოს, ფერს, booking ელფოსტას, ნაყიდ აპებს (AI რეჟიმი ჩართული ან გამორთული) და თითო აპის ლიმიტს (ასევე სურვილისამებრ webhook-ს, page paths-ს).
- ჩვენ ვქმნით გასაღებს და snippet-ებს ვაგზავნით.
- კლიენტი ამატებს
embed.js-ს და კონტეინერებს, ჯერ staging-ზე. - კლიენტი ამოწმებს: search → tracking, rates → details → booking (test ელფოსტა მოდის), shared link მათ საიტზე იხსნება. მკაცრი CSP-ის შემთხვევაში, browser console-ში ამოწმებს დაბლოკილ
navo24.com-ს. - კლიენტი ამატებს production დომენს (თუ ჯერ სიაში არ არის) და live-ზე გადის.