Skip to content
Navo24Navo24

Anleitungen

Navo-Apps auf der Kundenwebsite einbetten

Betten Sie Container-Tracking in Ihre Website ein, plus Frachtraten, Fahrpläne und KI-Modus, in Ihrer Marke mit einem Script-Tag und domaingebundenem Schlüssel.

Sie können Container-Tracking auf der Website eines Kunden einbetten, zusammen mit Frachtraten und Abfahrtsplänen. Es sind dieselben Apps, die Sie auf der Beispiel-Forwarder-Website sehen: ein Such-Widget für die Startseite sowie eine vollständige Seite für jede App. Jede App erscheint im Namen, Logo und Farbstil des Kunden. Jede Ansicht hat einen eigenen Link, sodass Besucher einem Kollegen genau einen Container, eine Ratensuche, eine Rate, eine Abfahrt, ein Schiff oder einen Hafen senden können, und der Link öffnet sich auf der Website des Kunden.

Auf Kundenseite sind weder API-Schlüssel noch Server erforderlich. Der Einbettungsschlüssel ist öffentlich und funktioniert nur auf den Domains, die wir dafür freigeben.

Was der Kunde uns sendet

ElementBeispielErforderlich
Unternehmensname, wie Besucher ihn sehen sollenAcme LogisticsJa
Domains, auf denen die Apps laufen werden (Produktion, Staging)acme.com, www.acme.com, staging.acme.comJa
Logo, SVG oder PNG, quadratische Marke oder horizontalhttps://acme.com/logo.svgJa
Markenfarbe, ein hex-Wert#0e6ba8Ja
Weitere Farben, Schriften, Eckenrundungsiehe Look and feelOptional
E-Mail-Adresse für Buchungsanfragen[email protected]Für Frachtraten
Webhook-URL für Buchungsanfragen (zum CRM/TMS)https://acme.com/hooks/navoOptional
Welche Apps gewünscht sindeine beliebige Kombination aus Tracking, Fracht, Fahrplänen; AI-Modus ein oder ausJa
Nutzungslimit pro App, pro Monat oder pro JahrTracking: 300 eindeutige Sendungen pro MonatJa
Seiten, auf denen die einzelnen Apps eingebunden werden/track, /rates, /schedulesEmpfohlen
“Bereitgestellt von Navo” angezeigt oder ausgeblendetangezeigtStandard: angezeigt

Wir erstellen den Schlüssel und senden die folgenden Snippets mit eingetragenem Schlüssel zurück.

Was ein Schlüssel enthalten kann

Ein Schlüssel öffnet eine oder mehrere Apps, und der AI-Modus ist ein separater Schalter:

PaketApps auf dem SchlüsselWas Besucher erhalten
Nur TrackingtrackingTracking-Seite; das Such-Widget zeigt das Tracking-Feld ohne Tabs und ohne AI-Schalter
Tracking mit AItracking, aiDasselbe, plus AI-Modus im Such-Widget und “AI fragen” bei Sendungen
Raten und Fahrplänefreight, schedulesZwei Tabs im Such-Widget, die Raten- und Fahrplanseiten
Allestracking, freight, schedules, aiAlle drei Tabs, AI-Modus, alle Seiten

Das Widget wird aus dem Schlüssel aufgebaut: Ein Tab, eine Seite oder ein AI-Button, die der Schlüssel nicht öffnet, wird gar nicht erst gerendert, und unser Server verweigert die Daten auch dann, wenn jemand die Anfrage erzwingt.

Nutzungslimits

Jede App auf einem Schlüssel hat ihr eigenes Limit, pro Kalendermonat oder pro Kalenderjahr (UTC). Was als eine Einheit zählt:

AppEine EinheitKostenlose Wiederholungen
trackingEine eindeutige Sendung (Container-, Buchungs- oder B/L-Nummer)Dieselbe Sendung für den Rest des Zeitraums
freightEine Ratensuche (Relation und Equipment)Dieselbe Suche am selben Tag
schedulesEine Fahrplansuche (Route, Schiff oder Hafen)Dieselbe Suche am selben Tag
aiEine Frage an den AI-AssistentenKeine

Beispiel: Tracking mit 300 eindeutigen Sendungen pro Monat. Die Besucher des Kunden können diese 300 Sendungen den ganzen Monat über beliebig oft öffnen und aktualisieren; Sendung 301 wird bis zum 1st des nächsten Monats verweigert. Wenn eine App ihr Limit erreicht, sehen Besucher “Dieser Dienst ist auf dieser Website derzeit pausiert. Bitte wenden Sie sich an .” Andere Apps auf dem Schlüssel funktionieren weiter. Wir sehen die Nutzung pro App und können ein Limit jederzeit erhöhen, ohne Änderung an der Website des Kunden.

Installation

Platzieren Sie den Loader einmal auf jeder Seite, die eine App anzeigt:

<script src="https://navo24.com/embed.js" async></script>

Dann einen Container an der Stelle, an der die App erscheinen soll.

Such-Widget (Hero-Bereich der Startseite oder jede andere Seite). Ein Feld mit einem Tab für jede App auf dem Schlüssel (Tracking, Raten, Fahrpläne) und AI-Modus, wenn der Schlüssel ihn enthält. Bei nur einer App gibt es keine Tabs:

<div
  data-navo-app="search"
  data-navo-key="nve_YOUR_KEY"
  data-navo-pages='{"tracking":"/track","freight":"/rates","schedules":"/schedules"}'
></div>

Mit data-navo-pages leitet das Widget Besucher auf die eigenen Seiten des Kunden weiter. Ohne dieses Attribut öffnet sich das Ergebnis direkt im Frame des Widgets.

Tracking-Seite (/track):

<div data-navo-app="tracking" data-navo-key="nve_YOUR_KEY"></div>

Frachtraten-Seite (/rates):

<div data-navo-app="freight" data-navo-key="nve_YOUR_KEY"></div>

Abfahrtsplan-Seite (/schedules), mit drei Tabs: nach Route, nach Schiff, nach Hafen:

<div data-navo-app="schedules" data-navo-key="nve_YOUR_KEY"></div>

Verwenden Sie auf jeder App denselben data-navo-pages-Wert, damit Querverweise (zum Beispiel “Raten anzeigen” auf einer Abfahrt oder “Schiffsfahrplan” auf einer Sendung) auf der richtigen Seite der Kundenwebsite landen.

Optionen

AttributFunktion
data-navo-appsearch, tracking, freight oder schedules.
data-navo-keyDer Einbettungsschlüssel der Website.
data-navo-pagesJSON-Zuordnung von App zu Seitenpfad auf der Website des Kunden.
data-navo-heightFeste Höhe in px. Standardmäßig wächst der Frame mit seinem Inhalt; Tracking ist eine vollständige Karte, 680 px.
data-navo-syncoff lässt die Seiten-URL unverändert, während Besucher durch die App klicken.
data-navo-themeJSON mit Farben, Schriften und Ecken, siehe Look and feel.

Websites mit Content Security Policy

Wenn die Website einen Content-Security-Policy-Header sendet (oder einen <meta http-equiv>-Eintrag) mit script-src oder frame-src, fügen Sie navo24.com zu beiden hinzu, andernfalls blockiert der Browser den Loader oder den Frame und der Container bleibt leer:

script-src ... https://navo24.com;
frame-src  ... https://navo24.com;

Wenn child-src statt frame-src verwendet wird, fügen Sie es dort hinzu. Mehr ist nicht nötig: Die Apps laden ihre Daten, Schriften und Karten innerhalb des Frames unter unserer eigenen Policy. In der Browserkonsole wird die blockierte Direktive genannt, falls eine fehlt.

Events für Analytics und CRM

Der Container feuert DOM-Events, wenn ein Besucher etwas tut, damit die Website sie an Google Analytics, einen Tag-Manager oder ihr CRM senden kann. Sie bubblen, daher erfasst ein einzelner Listener auf document jede App auf der Seite.

EventZeitpunktevent.detail
navo:searchEine Suche hat Ergebnisse zurückgegebenapp (tracking, freight, schedules) und die Anfrage: ref, oder origin, destination, container
navo:bookingEine Buchungsanfrage wurde gesendetreference, origin, destination, container, quantity, carrier, price, currency
navo:limitEin Limit hat eine Suche gestopptapp, code (zum Beispiel 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>

Kontaktdaten der Besucher stehen nicht in den Events: Sie gehen nur an die Buchungs-E-Mail und den Webhook.

Look and feel

Standardmäßig übernehmen die Apps die Markenfarbe des Kunden aus dem Schlüssel. Um die Website genauer zu treffen, fügen Sie data-navo-theme zum Container hinzu: Farben, Schriften, Eckenrundung und einen 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>

Jeder Schlüssel ist optional. Ein ungültiger Wert wird ignoriert, der Rest wird trotzdem angewendet.

SchlüsselWas geändert wirdBeispiel
accentButtons, Links, aktive Tabs, Schalter, Fokus-Ring. Hover- und Pressed-Abstufungen werden daraus berechnet"#e4002b"
textHaupttext"#1a1a1a"
mutedSekundärtext: Labels, Hinweise, Daten"#6b7280"
headingÜberschriften, Carrier- und Schiffsnamen, Kartenlinien"#002f6c"
backgroundSeitenhintergrund der App. "transparent" lässt den Hintergrund des Kunden durchscheinen"#ffffff"
surfaceCards, Eingabefelder, Tabellenstreifen"#f5f7fa"
borderRahmen und Trennlinien"#e5e7eb"
successPositive Zustände: zugestellt, pünktlich, günstigste Option"#15803d"
radiusEckenrundung von Cards und Panels, px (0 bis 40)8
buttonRadiusEckenrundung von Buttons und Eingabefeldern, px. 999 ergibt Pillen (Standard)6
fontSchrift für Fließtext. Jede Google Fonts-Familie wird automatisch geladen; "system" verwendet die Systemschrift des Besuchers"Inter"
headingFontSchrift für Überschriften, dieselben Regeln. Ohne diesen Wert verwenden Überschriften font"Playfair Display"
fontCssIhr eigenes Schrift-Stylesheet (https://-URL mit @font-face-Regeln), für Schriften, die nicht bei Google Fonts sind. Dann benennen font und headingFont Familien aus dieser Datei"https://acme.com/fonts/brand.css"
mode"dark" für Websites mit dunklem Design"dark"

Farben sind hex: #rgb, #rrggbb oder #rrggbbaa.

Fertige Ausgangspunkte:

<!-- 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"}'

Ein Theme für alle Seiten. Wir können das Theme auch auf dem Schlüssel speichern. Dann erhält jeder Container auf jeder Seite das Theme ohne Attribut, und wir können es später ohne Änderung an der Website des Kunden anpassen. data-navo-theme auf einem Container gewinnt weiterhin gegenüber dem Theme des Schlüssels, Schlüssel für Schlüssel.

Das Theme erreicht nur die App im Frame: Es verändert niemals die eigene Seite des Kunden.

React und Next.js, mit Suchindexierung

Verwenden Sie dies, wenn die Website des Kunden mit React oder Next.js gebaut ist und die Inhalte der App als Seite des Kunden indexiert werden sollen (zum Beispiel eine Seite pro Relation, “Shanghai to Hamburg sailing schedule”).

Es besteht aus zwei Teilen:

  1. Snapshot. Der Server des Kunden ruft die Daten der Relation bei uns als reines HTML ab (Fahrplantabelle oder Ratentabelle, eine Überschrift, eine einzeilige Zusammenfassung und schema.org-Markup) und fügt sie in die eigene Seite ein. Suchmaschinen indexieren sie als Inhalt des Kunden auf der URL des Kunden.
  2. App. Im Browser wird die interaktive App darüber gemountet, mit Suche, Filtern, Details und Buchung. Der Snapshot bleibt als einklappbare Tabelle unter der App auf der Seite, sodass Crawler und Besucher denselben Inhalt sehen.

Snapshot-Endpunkt

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

Ohne format=html ist die Antwort 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"
  }
}

Verwenden Sie title und description für das <title> der Seite und die Meta Description, html für den Body. Die Antwort kann 30 Minuten gecacht werden (Cache-Control: max-age=1800). Ein Snapshot zählt als eine Suche gegen das Limit der App; dieselbe Relation am selben Tag ist kostenlos. Für Tracking gibt es keinen Snapshot: Sendungen sind privat für den Besucher.

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>
      )}
    </>
  );
}

So sieht es für eine Suchmaschine aus: der eigene Titel und die eigene Beschreibung der Seite, eine Überschrift und eine vollständige Tabelle mit Abfahrten (oder Raten) im HTML, mit Dataset-Markup. So sieht es für Besucher aus: die Live-App, bereits auf dieser Relation geöffnet, mit denselben Ergebnissen als eingeklappte Tabelle darunter. Besucher ohne JavaScript sehen die geöffnete Tabelle. Die Tabelle ist eingeklappt, nicht versteckt, sodass die Seite Crawlern nichts zeigt, was ein Besucher nicht öffnen kann.

Das Snapshot-HTML kommt von unserem Server, wobei jeder Wert escaped ist, daher kann es sicher eingefügt werden. Stylen Sie es bei Bedarf mit den Klassen .navo-snapshot und .navo-snapshot-table, falls es angezeigt wird.

Andere Server-Frameworks (Remix, Astro, Nuxt, PHP, WordPress) funktionieren genauso: Snapshot auf dem Server abrufen, html in die Seite ausgeben, den Container daneben platzieren.

Plain React (ohne Server-Rendering)

Wenn Suchindexierung keine Rolle spielt (eine Tracking-Seite hinter einem Menü, ein Intranet), reicht die Komponente ohne Snapshot aus:

Der Loader funktioniert in einer Single-Page-App (React, Vue, Svelte) genauso: Container rendern, dann window.NavoEmbed.mount() aufrufen.

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' }} />

In Next.js platzieren Sie sie in einer Client-Komponente ('use client').

Warum ein Frame

Der Loader rendert jede App in einem Frame von navo24.com. So funktionieren auch Stripe Checkout, Google Maps-Einbettungen und YouTube-Player, aus denselben Gründen:

  • Domain-Lock. Der Browser selbst verweigert die Anzeige der App auf einer Website, die nicht in der Liste des Schlüssels steht (frame-ancestors). Eine Script-Komponente, die in die Seite des Kunden geladen wird, kann so nicht gesperrt werden.
  • Keine Style-Konflikte. Das CSS des Kunden kann die App nicht beschädigen, und unser CSS kann die Website des Kunden nicht beeinflussen.
  • Updates ohne den Kunden. Neue Carrier, Fixes und Funktionen erreichen jede Website am selben Tag; auf Kundenseite muss nichts aktualisiert werden.
  • Suchmaschinen. Inhalte in einem Frame werden nicht als Seite des Kunden indexiert, genau wie bei jeder Karten- oder Videoeinbettung. Wenn das wichtig ist, fügen Sie den serverseitig gerenderten Snapshot hinzu, siehe React und Next.js, mit Suchindexierung.

Besucher melden sich nicht im Frame an, daher hat das Blockieren von Third-Party-Cookies durch Browser keinen Einfluss darauf.

Während ein Besucher in einer App arbeitet, folgt ihm die Seiten-URL: ?navo_app=<app>&navo=<view>. Die Link kopieren-Buttons in den Apps erzeugen denselben Link-Typ. Beispiele auf einer Kundenseite /rates:

AnsichtLink
Ein Container/track?navo_app=tracking&navo=ref%3DZMOU8956106
Ratensuche auf einer Relation/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
Eine Ratedie obige Suche plus %26quote%3D<id>
Abfahrtssuche auf einer Relation/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
Eine Abfahrtdie obige Suche plus %26sailing%3D<id>
Ein Schiff/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
Ein Hafen/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

Eine geteilte Rate oder Abfahrt lässt sich auch dann weiter öffnen, wenn sie nicht mehr in den Live-Ergebnissen steht; sie wird mit dem Datum angezeigt, an dem ihre Daten übernommen wurden.

Buchungsanfragen

Buchen auf einer Rate öffnet ein Anfrageformular (Kontakt, Unternehmen, E-Mail, Telefon, Anzahl Container, Cargo-ready date, Ladung, Notizen). Beim Absenden:

  • Eine E-Mail geht an die Buchungsadresse des Kunden, mit Route, Equipment, Carrier, dem Preis, den der Besucher gesehen hat, und den Kontaktdaten des Besuchers. Reply-To ist der Besucher, sodass der Kunde direkt aus seinem Postfach antwortet;
  • wenn ein Webhook eingerichtet ist, wird dieselbe Anfrage als JSON per POST dorthin gesendet:
{
  "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" }
  }
}

Der Besucher sieht eine Bestätigung mit der Referenz. Es wird nichts berechnet und keine Carrier-Buchung ausgelöst: Der Kunde bestätigt den Platz und antwortet.

Ohne Buchungs-E-Mail oder Webhook bleibt das Formular eine Demo und weist darauf hin.

Was Besucher sehen und was nicht

  • Carrier-Namen und -Logos, Preise, Laufzeiten, Gültigkeit und was eine Rate enthält.
  • Raten ohne genannten Carrier werden als ” Select” angezeigt, mit dem Logo des Kunden.
  • Ratenquellen und Plattformen werden niemals angezeigt. Sie werden auf unserem Server entfernt, bevor Daten den Browser erreichen.

Sicherheit

Domain-Lock. Die App-Seiten antworten mit Content-Security-Policy: frame-ancestors, in der nur die Domains des Schlüssels aufgeführt sind, sodass ein Browser die Anzeige überall sonst verweigert. Datenanfragen enthalten den Schlüssel und den Host der übergeordneten Seite und werden verweigert, wenn der Host nicht auf der Liste steht. Ein Schlüssel, der in eine andere Website kopiert wird, funktioniert dort nicht.

Limits. Jede App auf einem Schlüssel hat ihr eigenes monatliches oder jährliches Limit (siehe Nutzungslimits). Zusätzlich hat jeder Schlüssel eine Sicherheitsgrenze von 50,000 Requests pro Monat, eine Obergrenze von 600 Requests pro Minute für die gesamte Website (damit ein Traffic-Spike einer Website die Apps für andere nicht verlangsamt; auf Anfrage erhöhbar) und Rate-Limits pro Besucher gegen Skript-Missbrauch; darüber hinaus zeigt die App eine kurze “Erneut versuchen”-Meldung und feuert navo:limit.

Nachrichten. Frame und Loader kommunizieren über postMessage, und jede Seite sendet nur an die exakte Origin der jeweils anderen Seite: der Frame an die Kundenseite, der Loader an navo24.com. Suchdetails gehen niemals an *.

Rotation. Wenn ein Schlüssel leakt oder eine Website den Besitzer wechselt, stellen wir einen neuen Schlüssel aus, und der alte funktioniert sofort nicht mehr.

Tests vor dem Launch

Senden Sie uns die Staging-Domain zusammen mit der Produktionsdomain oder localhost:<port> für einen Entwicklerrechner. Beide können auf demselben Schlüssel liegen.

Checkliste

  1. Der Kunde sendet Name, Domains, Logo, Farbe, Buchungs-E-Mail, die gekauften Apps (AI-Modus ein oder aus) und das Limit für jede App (sowie optional Webhook, Seitenpfade).
  2. Wir erstellen den Schlüssel und senden die Snippets.
  3. Der Kunde fügt embed.js und die Container hinzu, zuerst auf Staging.
  4. Der Kunde prüft: Suche → Tracking, Raten → Details → Buchung (eine Test-E-Mail kommt an), ein geteilter Link öffnet sich auf der eigenen Website. Bei strikter CSP die Browserkonsole auf blockiertes navo24.com prüfen.
  5. Der Kunde fügt die Produktionsdomain hinzu (falls noch nicht auf der Liste) und geht live.