Skip to content
Navo24Navo24

სახელმძღვანელოები

Navo-ს აპები კლიენტის საიტზე

ჩააშენეთ კონტეინერის ტრეკინგი საიტზე, ფრახტის ტარიფები, გემების განრიგები და AI რეჟიმი თქვენი ბრენდით, ერთი script tag-ით და დომენზე მიბმული გასაღებით.

კლიენტის საკუთარ ვებსაიტზე შეგიძლიათ ჩასვათ კონტეინერების თვალთვალი, ასევე სატვირთო ტარიფები და საზღვაო განრიგები. ეს იგივე აპებია, რომლებსაც სატესტო ფორვარდერის საიტზე ხედავთ: საძიებო ვიჯეტი მთავარი გვერდისთვის, და თითო აპისთვის სრული გვერდი. თითოეული ნაჩვენებია კლიენტის სახელით, ლოგოთი და ფერით. ყველა ხედს საკუთარი ბმული აქვს, ამიტომ ვიზიტორს შეუძლია კოლეგას გაუგზავნოს ერთი კონტეინერი, ერთი ტარიფის ძიება, ერთი ტარიფი, ერთი რეისი, ერთი გემი ან ერთი პორტი, და ის კლიენტის საიტზე გაიხსნება.

კლიენტის მხარეს API გასაღები ან სერვერი საჭირო არ არის. embed გასაღები საჯაროა და მუშაობს მხოლოდ იმ დომენებზე, რომლებსაც მისთვის მივუთითებთ.

რას გვიგზავნის კლიენტი

ItemExampleRequired
კომპანიის სახელი, როგორც ვიზიტორებმა უნდა დაინახონAcme LogisticsYes
დომენები, რომლებზეც აპები იმუშავებს (production, staging)acme.com, www.acme.com, staging.acme.comYes
ლოგო, SVG ან PNG, კვადრატული ნიშანი ან ჰორიზონტალურიhttps://acme.com/logo.svgYes
ბრენდის ფერი, ერთი hex მნიშვნელობა#0e6ba8Yes
დამატებითი ფერები, ფონტები, კუთხეების მომრგვალებაიხილეთ ვიზუალი და სტილიOptional
ელფოსტა, რომელიც ჯავშნის მოთხოვნებს მიიღებს[email protected]For freight rates
Webhook URL ჯავშნის მოთხოვნებისთვის (მათ CRM/TMS-ში)https://acme.com/hooks/navoOptional
რომელი აპები სურთნებისმიერი tracking, freight, schedules-დან; AI რეჟიმი ჩართული ან გამორთულიYes
გამოყენების ლიმიტი თითო აპზე, თვეში ან წელიწადშიtracking: 300 უნიკალური გადაზიდვა თვეშიYes
გვერდები, სადაც თითოეული აპი განთავსდება/track, /rates, /schedulesRecommended
"Powered by Navo" ნაჩვენებია თუ დამალულიანაჩვენებიაDefault: shown

ჩვენ ვქმნით გასაღებს და უკან ვაგზავნით ქვემოთ მოცემულ snippet-ებს, უკვე შევსებული გასაღებით.

რას ატარებს ერთი გასაღები

გასაღები ხსნის ერთ ან რამდენიმე აპს, ხოლო AI რეჟიმი ცალკე გადამრთველია:

PackageApps on the keyWhat the visitor gets
მხოლოდ TrackingtrackingTracking გვერდი; საძიებო ვიჯეტი აჩვენებს tracking ველს tab-ების და AI გადამრთველის გარეშე
Tracking AI-ითtracking, aiიგივე, დამატებით AI რეჟიმი საძიებო ვიჯეტში და “ჰკითხე AI-ს” გადაზიდვებზე
Rates და schedulesfreight, schedulesორი tab საძიებო ვიჯეტში, rates და schedules გვერდები
ყველაფერიtracking, freight, schedules, aiსამივე tab, AI რეჟიმი, ყველა გვერდი

ვიჯეტი გასაღებიდან იქმნება: tab, გვერდი ან AI ღილაკი, რომელსაც გასაღები არ ხსნის, საერთოდ არ იხატება, და ჩვენი სერვერი მის მონაცემებსაც უარყოფს, თუნდაც ვინმემ მოთხოვნა ხელით აიძულოს.

გამოყენების ლიმიტები

გასაღებზე თითო აპს საკუთარი ლიმიტი აქვს, კალენდარული თვის ან კალენდარული წლის მიხედვით (UTC). რა ითვლება ერთ ერთეულად:

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

AttributeWhat it does
data-navo-appsearch, tracking, freight ან schedules.
data-navo-keyსაიტის embed გასაღები.
data-navo-pagesJSON map, რომელიც აპს კლიენტის საიტზე გვერდის path-ს უკავშირებს.
data-navo-heightფიქსირებული სიმაღლე px-ში. ნაგულისხმევად frame იზრდება შიგთავსის მიხედვით; tracking არის სრული რუკა, 680 px.
data-navo-syncoff გვერდის URL-ს უცვლელად ტოვებს, სანამ ვიზიტორი აპში გადაადგილდება.
data-navo-themeJSON ფერებით, ფონტებით და კუთხეებით, იხილეთ ვიზუალი და სტილი.

საიტები 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 გვერდზე არსებულ ყველა აპს დაიჭერს.

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>

ვიზიტორის საკონტაქტო დეტალები 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 არასავალდებულოა. არასწორი მნიშვნელობა იგნორირდება, დანარჩენი მაინც გამოიყენება.

KeyWhat it changesExample
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"
surfaceCards, inputs, table stripes"#f5f7fa"
borderBorders და dividers"#e5e7eb"
successდადებითი მდგომარეობები: delivered, on time, cheapest"#15803d"
radiusCards და panels კუთხეების მომრგვალება, px (0-დან 40-მდე)8
buttonRadiusButtons და 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”).

ის ორი ნაწილისგან შედგება:

  1. Snapshot. კლიენტის სერვერი lane-ის მონაცემებს ჩვენგან plain HTML-ად იღებს (schedule table ან rate table, სათაური, ერთხაზიანი summary და schema.org markup) და საკუთარ გვერდში სვამს. საძიებო სისტემები მას კლიენტის კონტენტად, კლიენტის URL-ზე ინდექსავენ.
  2. 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:

ViewLink
კონტეინერი/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

  1. კლიენტი აგზავნის სახელს, დომენებს, ლოგოს, ფერს, booking ელფოსტას, ნაყიდ აპებს (AI რეჟიმი ჩართული ან გამორთული) და თითო აპის ლიმიტს (ასევე სურვილისამებრ webhook-ს, page paths-ს).
  2. ჩვენ ვქმნით გასაღებს და snippet-ებს ვაგზავნით.
  3. კლიენტი ამატებს embed.js-ს და კონტეინერებს, ჯერ staging-ზე.
  4. კლიენტი ამოწმებს: search → tracking, rates → details → booking (test ელფოსტა მოდის), shared link მათ საიტზე იხსნება. მკაცრი CSP-ის შემთხვევაში, browser console-ში ამოწმებს დაბლოკილ navo24.com-ს.
  5. კლიენტი ამატებს production დომენს (თუ ჯერ სიაში არ არის) და live-ზე გადის.