Skip to content
Navo24Navo24

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

ElementPrzykładWymagane
Nazwa firmy widoczna dla odwiedzającychAcme LogisticsTak
Domeny, w których będą działać aplikacje (produkcja, staging)acme.com, www.acme.com, staging.acme.comTak
Logo, SVG lub PNG, znak kwadratowy albo poziomyhttps://acme.com/logo.svgTak
Kolor marki, jedna wartość hex#0e6ba8Tak
Dodatkowe kolory, fonty, zaokrąglenie rogówzobacz WyglądOpcjonalnie
E-mail odbierający zapytania bookingowe[email protected]Dla stawek frachtowych
URL webhooka dla zapytań bookingowych (do ich CRM/TMS)https://acme.com/hooks/navoOpcjonalnie
Które aplikacje mają być dostępnedowolne z: tracking, freight, schedules; tryb AI włączony lub wyłączonyTak
Limit użycia na aplikację, miesięcznie lub rocznietracking: 300 unikalnych przesyłek miesięcznieTak
Strony, na których będzie działać każda aplikacja/track, /rates, /schedulesZalecane
“Powered by Navo” widoczne lub ukrytewidoczneDomyś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:

PakietAplikacje na kluczuCo dostaje odwiedzający
Tylko trackingtrackingStrona śledzenia; widget wyszukiwania pokazuje pole trackingu bez kart i bez przełącznika AI
Tracking z AItracking, aiTo samo, plus tryb AI w widgecie wyszukiwania i “Zapytaj AI” na przesyłkach
Stawki i rozkładyfreight, schedulesDwie karty w widgecie wyszukiwania, strony stawek i rozkładów
Wszystkotracking, freight, schedules, aiWszystkie 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:

AplikacjaJedna jednostkaBezpłatne powtórzenia
trackingJedna unikalna przesyłka (numer kontenera, booking albo B/L)Ta sama przesyłka do końca okresu
freightJedno wyszukiwanie stawki (trasa i sprzęt)To samo wyszukiwanie tego samego dnia
schedulesJedno wyszukiwanie rozkładu (trasa, statek albo port)To samo wyszukiwanie tego samego dnia
aiJedno pytanie do asystenta AIBrak

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 .” Pozostałe aplikacje na kluczu nadal działają. Widzimy użycie per aplikacja i możemy podnieść limit w dowolnym momencie, bez żadnych zmian na stronie klienta.

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

AtrybutCo robi
data-navo-appsearch, tracking, freight albo schedules.
data-navo-keyKlucz osadzania dla strony.
data-navo-pagesMapa JSON aplikacji na ścieżki stron w serwisie klienta.
data-navo-heightStała wysokość w px. Domyślnie ramka rośnie wraz z treścią; tracking to pełna mapa, 680 px.
data-navo-syncoff pozostawia URL strony bez zmian, gdy odwiedzający klika w aplikacji.
data-navo-themeJSON 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.

ZdarzenieKiedyevent.detail
navo:searchWyszukiwanie zwróciło wynikiapp (tracking, freight, schedules) oraz zapytanie: ref, albo origin, destination, container
navo:bookingWysłano zapytanie bookingowereference, origin, destination, container, quantity, carrier, price, currency
navo:limitLimit zatrzymał wyszukiwanieapp, 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.

KluczCo zmieniaPrzykład
accentPrzyciski, linki, aktywne karty, przełączniki, obrys fokusu. Odcienie hover i pressed są wyliczane na jego podstawie"#e4002b"
textTekst główny"#1a1a1a"
mutedTekst drugorzędny: etykiety, podpowiedzi, daty"#6b7280"
headingNagłówki, nazwy przewoźników i statków, linie mapy"#002f6c"
backgroundTło strony aplikacji. "transparent" pozwala pokazać własne tło klienta"#ffffff"
surfaceKarty, pola input, pasy tabel"#f5f7fa"
borderObramowania i separatory"#e5e7eb"
successStany pozytywne: dostarczono, na czas, najtaniej"#15803d"
radiusZaokrąglenie rogów kart i paneli, px (0 do 40)8
buttonRadiusZaokrąglenie rogów przycisków i pól input, px. 999 daje pigułki (domyślnie)6
fontFont tekstu. Każda rodzina Google Fonts jest ładowana automatycznie; "system" używa fontu systemowego odwiedzającego"Inter"
headingFontFont nagłówków, te same zasady. Bez niego nagłówki używają font"Playfair Display"
fontCssWł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:

  1. 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.
  2. 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:

WidokLink
Kontener/track?navo_app=tracking&navo=ref%3DZMOU8956106
Wyszukiwanie stawki na trasie/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
Jedna stawkawyszukiwanie powyżej plus %26quote%3D<id>
Wyszukiwanie rejsu na trasie/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
Jeden rejswyszukiwanie 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

  1. 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).
  2. Tworzymy klucz i wysyłamy fragmenty.
  3. Klient dodaje embed.js i kontenery, najpierw na stagingu.
  4. 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.
  5. Klient dodaje domenę produkcyjną (jeśli nie ma jej jeszcze na liście) i uruchamia stronę produkcyjnie.