Poradniki
Aplikacje Navo na stronie klienta
Osadź na stronie śledzenie kontenerów, stawki frachtu, rozkłady rejsów i tryb AI, we własnej marce, jednym tagiem script i kluczem domenowym.
Możesz osadzić śledzenie kontenerów na własnej stronie klienta, razem ze stawkami frachtowymi i rozkładami rejsów. To te same aplikacje, które widzisz na przykładowej stronie spedytora: widget wyszukiwania na stronę główną oraz pełna strona dla każdej aplikacji. Każda z nich jest wyświetlana z nazwą, logo i kolorem klienta. Każdy widok ma własny link, więc odwiedzający może wysłać współpracownikowi jeden kontener, jedno wyszukiwanie stawki, jedną stawkę, jeden rejs, jeden statek albo jeden port, a link otworzy się na stronie klienta.
Po stronie klienta nie jest potrzebny żaden klucz API ani serwer. Klucz osadzania jest publiczny i działa tylko w domenach, które dla niego wskazujemy.
Co klient wysyła do nas
| Element | Przykład | Wymagane |
|---|---|---|
| Nazwa firmy widoczna dla odwiedzających | Acme Logistics | Tak |
| Domeny, w których będą działać aplikacje (produkcja, staging) | acme.com, www.acme.com, staging.acme.com | Tak |
| Logo, SVG lub PNG, znak kwadratowy albo poziomy | https://acme.com/logo.svg | Tak |
| Kolor marki, jedna wartość hex | #0e6ba8 | Tak |
| Dodatkowe kolory, fonty, zaokrąglenie rogów | zobacz Wygląd | Opcjonalnie |
| E-mail odbierający zapytania bookingowe | [email protected] | Dla stawek frachtowych |
| URL webhooka dla zapytań bookingowych (do ich CRM/TMS) | https://acme.com/hooks/navo | Opcjonalnie |
| Które aplikacje mają być dostępne | dowolne z: tracking, freight, schedules; tryb AI włączony lub wyłączony | Tak |
| Limit użycia na aplikację, miesięcznie lub rocznie | tracking: 300 unikalnych przesyłek miesięcznie | Tak |
| Strony, na których będzie działać każda aplikacja | /track, /rates, /schedules | Zalecane |
| “Powered by Navo” widoczne lub ukryte | widoczne | Domyślnie: widoczne |
Tworzymy klucz i odsyłamy poniższe fragmenty z uzupełnionym kluczem.
Co może obejmować jeden klucz
Klucz otwiera jedną albo kilka aplikacji, a tryb AI jest osobnym przełącznikiem:
| Pakiet | Aplikacje na kluczu | Co dostaje odwiedzający |
|---|---|---|
| Tylko tracking | tracking | Strona śledzenia; widget wyszukiwania pokazuje pole trackingu bez kart i bez przełącznika AI |
| Tracking z AI | tracking, ai | To samo, plus tryb AI w widgecie wyszukiwania i “Zapytaj AI” na przesyłkach |
| Stawki i rozkłady | freight, schedules | Dwie karty w widgecie wyszukiwania, strony stawek i rozkładów |
| Wszystko | tracking, freight, schedules, ai | Wszystkie trzy karty, tryb AI, wszystkie strony |
Widget jest budowany na podstawie klucza: karta, strona albo przycisk AI, których klucz nie otwiera, w ogóle nie są rysowane, a nasz serwer odrzuca ich dane nawet wtedy, gdy ktoś wymusi żądanie.
Limity użycia
Każda aplikacja na kluczu ma własny limit, na miesiąc kalendarzowy albo rok kalendarzowy (UTC). Co liczy się jako jedna jednostka:
| Aplikacja | Jedna jednostka | Bezpłatne powtórzenia |
|---|---|---|
tracking | Jedna unikalna przesyłka (numer kontenera, booking albo B/L) | Ta sama przesyłka do końca okresu |
freight | Jedno wyszukiwanie stawki (trasa i sprzęt) | To samo wyszukiwanie tego samego dnia |
schedules | Jedno wyszukiwanie rozkładu (trasa, statek albo port) | To samo wyszukiwanie tego samego dnia |
ai | Jedno pytanie do asystenta AI | Brak |
Przykład: tracking z limitem 300 unikalnych przesyłek miesięcznie. Odwiedzający stronę klienta mogą otwierać i odświeżać te 300 przesyłek dowolnie często przez cały miesiąc; przesyłka 301 zostanie odrzucona do 1. dnia następnego miesiąca. Gdy aplikacja osiągnie limit, odwiedzający zobaczą “Ta usługa jest obecnie wstrzymana na tej stronie. Skontaktuj się z
Instalacja
Umieść loader raz na każdej stronie, która wyświetla aplikację:
<script src="https://navo24.com/embed.js" async></script>
Następnie dodaj kontener w miejscu, w którym ma pojawić się aplikacja.
Widget wyszukiwania (hero na stronie głównej albo dowolna strona). Jedno pole z kartą dla każdej aplikacji na kluczu (tracking, rates, schedules) oraz trybem AI, jeśli klucz go ma. Przy jednej aplikacji nie ma kart:
<div
data-navo-app="search"
data-navo-key="nve_YOUR_KEY"
data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>
Z data-navo-pages widget wysyła odwiedzających na własne strony klienta. Bez tego wyniki otwierają się bezpośrednio w ramce widgetu.
Strona śledzenia (/track):
<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>
Strona stawek frachtowych (/rates):
<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>
Strona rozkładów rejsów (/schedules), z trzema kartami: według trasy, według statku, według portu:
<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>
Użyj tej samej wartości data-navo-pages w każdej aplikacji, aby linki między widokami (na przykład “Pokaż stawki” przy rejsie albo “Rozkład statku” przy przesyłce) prowadziły na właściwą stronę w serwisie klienta.
Opcje
| Atrybut | Co robi |
|---|---|
data-navo-app | search, tracking, freight albo schedules. |
data-navo-key | Klucz osadzania dla strony. |
data-navo-pages | Mapa JSON aplikacji na ścieżki stron w serwisie klienta. |
data-navo-height | Stała wysokość w px. Domyślnie ramka rośnie wraz z treścią; tracking to pełna mapa, 680 px. |
data-navo-sync | off pozostawia URL strony bez zmian, gdy odwiedzający klika w aplikacji. |
data-navo-theme | JSON z kolorami, fontami i rogami, zobacz Wygląd. |
Strony z Content Security Policy
Jeśli strona wysyła nagłówek Content-Security-Policy (albo odpowiednik <meta http-equiv>) z script-src lub frame-src, dodaj navo24.com do obu, w przeciwnym razie przeglądarka zablokuje loader albo ramkę, a kontener pozostanie pusty:
script-src ... https://navo24.com;
frame-src ... https://navo24.com;
Jeśli używane jest child-src zamiast frame-src, dodaj tam tę domenę. Nic więcej nie jest potrzebne: aplikacje ładują swoje dane, fonty i mapy wewnątrz ramki, pod naszą własną polityką. Konsola przeglądarki wskaże zablokowaną dyrektywę, jeśli którejś brakuje.
Zdarzenia dla analityki i CRM
Kontener emituje zdarzenia DOM, gdy odwiedzający wykona akcję, dzięki czemu strona może wysłać je do Google Analytics, menedżera tagów albo swojego CRM. Zdarzenia propagują się w górę, więc jeden listener na document łapie każdą aplikację na stronie.
| Zdarzenie | Kiedy | event.detail |
|---|---|---|
navo:search | Wyszukiwanie zwróciło wyniki | app (tracking, freight, schedules) oraz zapytanie: ref, albo origin, destination, container |
navo:booking | Wysłano zapytanie bookingowe | reference, origin, destination, container, quantity, carrier, price, currency |
navo:limit | Limit zatrzymał wyszukiwanie | app, code (na przykład 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>
Dane kontaktowe odwiedzającego nie są dostępne w zdarzeniach: trafiają tylko na e-mail bookingowy i do webhooka.
Wygląd
Domyślnie aplikacje pobierają kolor marki klienta z klucza. Aby lepiej dopasować je do strony, dodaj data-navo-theme do kontenera: kolory, fonty, zaokrąglenie rogów i tryb ciemny.
<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>
Każdy klucz jest opcjonalny. Nieprawidłowa wartość jest ignorowana, reszta nadal działa.
| Klucz | Co zmienia | Przykład |
|---|---|---|
accent | Przyciski, linki, aktywne karty, przełączniki, obrys fokusu. Odcienie hover i pressed są wyliczane na jego podstawie | "#e4002b" |
text | Tekst główny | "#1a1a1a" |
muted | Tekst drugorzędny: etykiety, podpowiedzi, daty | "#6b7280" |
heading | Nagłówki, nazwy przewoźników i statków, linie mapy | "#002f6c" |
background | Tło strony aplikacji. "transparent" pozwala pokazać własne tło klienta | "#ffffff" |
surface | Karty, pola input, pasy tabel | "#f5f7fa" |
border | Obramowania i separatory | "#e5e7eb" |
success | Stany pozytywne: dostarczono, na czas, najtaniej | "#15803d" |
radius | Zaokrąglenie rogów kart i paneli, px (0 do 40) | 8 |
buttonRadius | Zaokrąglenie rogów przycisków i pól input, px. 999 daje pigułki (domyślnie) | 6 |
font | Font tekstu. Każda rodzina Google Fonts jest ładowana automatycznie; "system" używa fontu systemowego odwiedzającego | "Inter" |
headingFont | Font nagłówków, te same zasady. Bez niego nagłówki używają font | "Playfair Display" |
fontCss | Własny arkusz fontów (https:// URL z regułami @font-face), dla fontów spoza Google Fonts. Wtedy font i headingFont wskazują rodziny z tego pliku | "https://acme.com/fonts/brand.css" |
mode | "dark" dla stron z ciemnym designem | "dark" |
Kolory są w formacie hex: #rgb, #rrggbb albo #rrggbbaa.
Gotowe punkty startowe:
<!-- 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"}'
Jeden motyw dla wszystkich stron. Możemy też zapisać motyw na kluczu. Wtedy każdy kontener na każdej stronie dostaje go bez atrybutu, a my możemy później go zmienić bez żadnych zmian na stronie klienta. data-navo-theme w kontenerze nadal ma pierwszeństwo przed motywem z klucza, klucz po kluczu.
Motyw dociera tylko do aplikacji wewnątrz ramki: nigdy nie zmienia własnej strony klienta.
React i Next.js, z indeksowaniem w wyszukiwarce
Użyj tego, gdy strona klienta jest zbudowana w React albo Next.js, a treść aplikacji ma być indeksowana jako strona klienta (na przykład strona dla każdej trasy, “Shanghai to Hamburg sailing schedule”).
Składa się to z dwóch części:
- Snapshot. Serwer klienta pobiera od nas dane trasy jako zwykły HTML (tabela rozkładu albo tabela stawek, nagłówek, jednozdaniowe podsumowanie i znaczniki schema.org) i wstawia je do własnej strony. Wyszukiwarki indeksują to jako treść klienta, pod URL klienta.
- Aplikacja. W przeglądarce interaktywna aplikacja montuje się nad nim, z wyszukiwaniem, filtrami, szczegółami i bookingiem. Snapshot zostaje na stronie jako zwijana tabela pod aplikacją, więc crawlery i odwiedzający widzą tę samą treść.
Endpoint snapshotu
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
Bez format=html odpowiedź jest w 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"
}
}
Użyj title i description dla <title> strony i meta description, a html dla body. Odpowiedź można cache’ować przez 30 minut (Cache-Control: max-age=1800). Snapshot liczy się jako jedno wyszukiwanie w limicie aplikacji; ta sama trasa tego samego dnia jest bezpłatna. Tracking nie ma snapshotu: przesyłki są prywatne dla odwiedzającego.
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>
)}
</>
);
}
Jak wygląda to dla wyszukiwarki: własny tytuł i opis strony, nagłówek oraz pełna tabela rejsów (albo stawek) w HTML, ze znacznikami Dataset. Jak wygląda to dla odwiedzającego: działająca aplikacja, od razu otwarta na tej trasie, z tymi samymi wynikami jako zwinięta tabela pod spodem. Odwiedzający z wyłączonym JavaScript widzą otwartą tabelę. Tabela jest zwinięta, nie ukryta, więc strona nie pokazuje crawlerom niczego, czego odwiedzający nie może otworzyć.
HTML snapshotu pochodzi z naszego serwera, a każda wartość jest escapowana, więc można go bezpiecznie wstawić. Jeśli tabela kiedykolwiek będzie widoczna, ostyluj ją klasami .navo-snapshot i .navo-snapshot-table.
Inne frameworki serwerowe (Remix, Astro, Nuxt, PHP, WordPress) działają tak samo: pobierz snapshot na serwerze, wypisz html na stronie, umieść kontener obok niego.
Zwykły React (bez renderowania po stronie serwera)
Gdy indeksowanie w wyszukiwarce nie ma znaczenia (strona trackingu za menu, intranet), wystarczy komponent bez snapshotu:
Loader działa tak samo w aplikacji jednostronicowej (React, Vue, Svelte): wyrenderuj kontener, a następnie wywołaj 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' }} />
W Next.js umieść go w komponencie klienckim ('use client').
Dlaczego ramka
Loader rysuje każdą aplikację w ramce z navo24.com. Tak działają Stripe Checkout, osadzenia Google Maps i odtwarzacze YouTube, z tych samych powodów:
- Blokada domeny. Sama przeglądarka odmawia pokazania aplikacji na stronie, której nie ma na liście klucza (
frame-ancestors). Komponentu skryptowego ładowanego na stronie klienta nie da się zablokować w ten sposób. - Brak konfliktów stylów. CSS klienta nie może popsuć aplikacji, a nasz CSS nie może dotknąć ich strony.
- Aktualizacje bez udziału klienta. Nowi przewoźnicy, poprawki i funkcje trafiają na wszystkie strony tego samego dnia; po stronie klienta nie ma nic do aktualizacji.
- Wyszukiwarki. Treść w ramce nie jest indeksowana jako strona klienta, tak samo jak przy każdym osadzeniu mapy albo wideo. Gdy ma to znaczenie, dodaj snapshot renderowany po stronie serwera, zobacz React i Next.js, z indeksowaniem w wyszukiwarce.
Odwiedzający nie logują się wewnątrz ramki, więc blokowanie ciasteczek firm trzecich przez przeglądarkę nie ma na nią wpływu.
Linki do jednego dokładnego widoku
Gdy odwiedzający pracuje w aplikacji, URL strony podąża za nim: ?navo_app=<app>&navo=<view>. Przyciski Kopiuj link w aplikacjach tworzą link tego samego typu. Przykłady na stronie klienta /rates:
| Widok | Link |
|---|---|
| Kontener | /track?navo_app=tracking&navo=ref%3DZMOU8956106 |
| Wyszukiwanie stawki na trasie | /rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC |
| Jedna stawka | wyszukiwanie powyżej plus %26quote%3D<id> |
| Wyszukiwanie rejsu na trasie | /schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM |
| Jeden rejs | wyszukiwanie powyżej plus %26sailing%3D<id> |
| Statek | /schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890 |
| Port | /schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN |
Udostępniona stawka albo rejs nadal się otwiera po zniknięciu z bieżących wyników; jest pokazana z datą pobrania danych.
Zapytania bookingowe
Zarezerwuj przy stawce otwiera formularz zapytania (kontakt, firma, e-mail, telefon, liczba kontenerów, data gotowości ładunku, ładunek, notatki). Po wysłaniu:
- e-mail trafia na adres bookingowy klienta, z trasą, sprzętem, przewoźnikiem, ceną widzianą przez odwiedzającego i danymi kontaktowymi odwiedzającego. Reply-To to odwiedzający, więc klient odpowiada bezpośrednio ze swojej skrzynki;
- jeśli ustawiono webhook, to samo zapytanie jest wysyłane do niego metodą POST jako 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" }
}
}
Odwiedzający widzi potwierdzenie z referencją. Nic nie jest pobierane i nie jest wykonywany żaden booking u przewoźnika: klient potwierdza miejsce i odpowiada.
Bez e-maila bookingowego albo webhooka formularz pozostaje demo i informuje o tym.
Co widzą odwiedzający, a czego nie widzą
- Nazwy i logo przewoźników, ceny, czasy tranzytu, ważność i to, co obejmuje stawka.
- Stawki bez nazwanego przewoźnika są pokazywane jako ”
Select”, z logo klienta. - Źródła stawek i platformy nigdy nie są pokazywane. Usuwamy je na naszym serwerze, zanim dane trafią do przeglądarki.
Bezpieczeństwo
Blokada domeny. Strony aplikacji odpowiadają nagłówkiem Content-Security-Policy: frame-ancestors, który zawiera tylko domeny klucza, więc przeglądarka odmawia pokazania ich gdziekolwiek indziej. Żądania danych niosą klucz i host strony nadrzędnej, a gdy hostu nie ma na liście, są odrzucane. Klucz skopiowany na inną stronę tam nie działa.
Limity. Każda aplikacja na kluczu ma własny limit miesięczny albo roczny (zobacz Limity użycia). Oprócz tego każdy klucz ma limit bezpieczeństwa 50,000 żądań miesięcznie, pułap 600 żądań na minutę dla całej strony (żeby skok ruchu jednej strony nie spowalniał aplikacji innym; podnoszone na życzenie) oraz limity per odwiedzający przeciwko nadużyciom skryptowym; po ich przekroczeniu aplikacja pokazuje krótką wiadomość “spróbuj ponownie” i emituje navo:limit.
Komunikaty. Ramka i loader komunikują się przez postMessage, a każda strona wysyła tylko do dokładnego originu drugiej strony: ramka do strony klienta, loader do navo24.com. Szczegóły wyszukiwania nigdy nie trafiają do *.
Rotacja. Jeśli klucz wycieknie albo strona zmieni właściciela, wydajemy nowy klucz, a stary od razu przestaje działać.
Testowanie przed startem
Wyślij nam domenę stagingową razem z produkcyjną albo localhost:<port> dla maszyny deweloperskiej. Obie mogą być na tym samym kluczu.
Checklist
- Klient wysyła nazwę, domeny, logo, kolor, e-mail bookingowy, aplikacje, które kupił (tryb AI włączony albo wyłączony), oraz limit dla każdej aplikacji (i opcjonalnie webhook, ścieżki stron).
- Tworzymy klucz i wysyłamy fragmenty.
- Klient dodaje
embed.jsi kontenery, najpierw na stagingu. - Klient sprawdza: wyszukiwanie → tracking, stawki → szczegóły → booking (przychodzi testowy e-mail), udostępniony link otwiera się na ich stronie. Przy restrykcyjnym CSP sprawdza konsolę przeglądarki pod kątem zablokowanego
navo24.com. - Klient dodaje domenę produkcyjną (jeśli nie ma jej jeszcze na liście) i uruchamia stronę produkcyjnie.