Skip to content
Navo24Navo24

Hướng dẫn

Nhúng ứng dụng Navo vào website khách hàng

Nhúng theo dõi container vào website của bạn, kèm giá cước, lịch tàu và chế độ AI theo thương hiệu riêng, chỉ với một thẻ script và khóa giới hạn theo miền.

Bạn có thể nhúng tính năng theo dõi container trên website riêng của khách hàng, kèm theo giá cước vận tải và lịch tàu. Đây chính là các ứng dụng bạn thấy trên website forwarder mẫu: một widget tìm kiếm cho trang chủ, cùng với một trang đầy đủ cho từng ứng dụng. Mỗi ứng dụng hiển thị theo tên, logo và màu thương hiệu của khách hàng. Mỗi màn hình đều có liên kết riêng, nên khách truy cập có thể gửi cho đồng nghiệp một container, một lượt tìm kiếm giá, một giá cước, một chuyến tàu, một tàu hoặc một cảng, và liên kết sẽ mở ngay trên website của khách hàng.

Không cần API key hoặc server ở phía khách hàng. Embed key là công khai và chỉ hoạt động trên các domain mà chúng tôi khai báo cho key đó.

Khách hàng cần gửi cho chúng tôi

MụcVí dụBắt buộc
Tên công ty như khách truy cập sẽ nhìn thấyAcme LogisticsCó
Các domain sẽ chạy ứng dụng (production, staging)acme.com, www.acme.com, staging.acme.comCó
Logo, SVG hoặc PNG, dạng biểu tượng vuông hoặc nganghttps://acme.com/logo.svgCó
Màu thương hiệu, một giá trị hex#0e6ba8Có
Màu bổ sung, font, bo gócxem Giao diệnKhông bắt buộc
E-mail nhận yêu cầu đặt chỗ[email protected]Cho giá cước
Webhook URL cho yêu cầu đặt chỗ (tới CRM/TMS của họ)https://acme.com/hooks/navoKhông bắt buộc
Ứng dụng họ muốn dùngbất kỳ trong tracking, freight, schedules; bật hoặc tắt chế độ AICó
Giới hạn sử dụng theo từng ứng dụng, theo tháng hoặc theo nămtracking: 300 lô hàng duy nhất mỗi thángCó
Các trang nơi từng ứng dụng sẽ được đặt/track, /rates, /schedulesKhuyến nghị
Hiển thị hoặc ẩn “Được hỗ trợ bởi Navo”hiển thịMặc định: hiển thị

Chúng tôi tạo key và gửi lại các đoạn mã bên dưới, trong đó key đã được điền sẵn.

Một key có thể bao gồm những gì

Một key có thể mở một hoặc nhiều ứng dụng, và chế độ AI là một công tắc riêng:

GóiỨng dụng trên keyKhách truy cập nhận được
Chỉ trackingtrackingTrang tracking; widget tìm kiếm hiển thị ô tracking, không có tab và không có công tắc AI
Tracking với AItracking, aiTương tự, cộng thêm chế độ AI trong widget tìm kiếm và “Hỏi AI” trên lô hàng
Giá cước và lịch tàufreight, schedulesHai tab trong widget tìm kiếm, các trang giá cước và lịch tàu
Tất cảtracking, freight, schedules, aiCả ba tab, chế độ AI, tất cả các trang

Widget được dựng từ key: tab, trang hoặc nút AI nào key không mở thì hoàn toàn không được vẽ ra, và server của chúng tôi sẽ từ chối dữ liệu tương ứng ngay cả khi có người cố ép request.

Giới hạn sử dụng

Mỗi ứng dụng trên một key có giới hạn riêng, theo tháng dương lịch hoặc năm dương lịch (UTC). Một đơn vị được tính như sau:

Ứng dụngMột đơn vịLượt lặp miễn phí
trackingMột lô hàng duy nhất (số container, booking hoặc B/L)Cùng lô hàng đó trong phần còn lại của kỳ
freightMột lượt tìm kiếm giá (tuyến và loại thiết bị)Cùng lượt tìm kiếm trong cùng ngày
schedulesMột lượt tìm kiếm lịch tàu (tuyến, tàu hoặc cảng)Cùng lượt tìm kiếm trong cùng ngày
aiMột câu hỏi tới trợ lý AIKhông có

Ví dụ: tracking ở mức 300 lô hàng duy nhất mỗi tháng. Khách truy cập của khách hàng có thể mở và refresh 300 lô hàng đó bao nhiêu lần tùy ý trong cả tháng; lô hàng thứ 301 sẽ bị từ chối cho đến ngày 1 của tháng tiếp theo. Khi một ứng dụng đạt giới hạn, khách truy cập sẽ thấy “Dịch vụ này hiện đang tạm dừng trên website này. Vui lòng liên hệ <tên khách hàng>.” Các ứng dụng khác trên key vẫn tiếp tục hoạt động. Chúng tôi thấy mức sử dụng theo từng ứng dụng và có thể tăng giới hạn bất cứ lúc nào, không cần thay đổi gì trên website của khách hàng.

Cài đặt

Đặt loader một lần trên mọi trang có hiển thị ứng dụng:

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

Sau đó thêm một container tại vị trí ứng dụng cần xuất hiện.

Widget tìm kiếm (hero trang chủ, hoặc bất kỳ trang nào). Một ô với một tab cho mỗi ứng dụng trên key (tracking, rates, schedules) và chế độ AI nếu key có. Nếu chỉ có một ứng dụng thì không có tab:

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

Với data-navo-pages, widget sẽ đưa khách truy cập tới các trang riêng của khách hàng. Nếu không có thuộc tính này, kết quả sẽ mở ngay bên trong frame của widget.

Trang tracking (/track):

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

Trang giá cước vận tải (/rates):

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

Trang lịch tàu (/schedules), với ba tab: theo tuyến, theo tàu, theo cảng:

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

Dùng cùng một giá trị data-navo-pages trên mọi ứng dụng để các liên kết chéo (ví dụ “Hiển thị giá cước” trên một chuyến tàu, hoặc “Lịch tàu” trên một lô hàng) đi đúng trang trên website của khách hàng.

Tùy chọn

Thuộc tínhTác dụng
data-navo-appsearch, tracking, freight hoặc schedules.
data-navo-keyEmbed key của website.
data-navo-pagesBản đồ JSON từ ứng dụng tới đường dẫn trang trên website của khách hàng.
data-navo-heightChiều cao cố định theo px. Mặc định frame tự tăng theo nội dung; tracking là bản đồ đầy đủ, 680 px.
data-navo-syncoff giữ URL của trang không đổi khi khách truy cập thao tác.
data-navo-themeJSON chứa màu, font và bo góc, xem Giao diện.

Website có Content Security Policy

Nếu website gửi header Content-Security-Policy (hoặc một thẻ <meta http-equiv>) với script-src hoặc frame-src, hãy thêm navo24.com vào cả hai, nếu không trình duyệt sẽ chặn loader hoặc frame và container sẽ trống:

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

Nếu dùng child-src thay cho frame-src, hãy thêm vào đó. Không cần gì thêm: các ứng dụng tải dữ liệu, font và bản đồ bên trong frame, theo policy riêng của chúng tôi. Console của trình duyệt sẽ nêu tên directive bị chặn nếu thiếu directive nào đó.

Sự kiện cho analytics và CRM

Container phát DOM event khi khách truy cập thực hiện thao tác, để website có thể gửi chúng tới Google Analytics, tag manager hoặc CRM. Các event này bubble, nên chỉ cần một listener trên document là bắt được mọi ứng dụng trên trang.

EventKhi nàoevent.detail
navo:searchMột lượt tìm kiếm trả về kết quảapp (tracking, freight, schedules) và truy vấn: ref, hoặc origin, destination, container
navo:bookingMột yêu cầu đặt chỗ đã được gửireference, origin, destination, container, quantity, carrier, price, currency
navo:limitMột giới hạn đã chặn lượt tìm kiếmapp, code (ví dụ 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>

Thông tin liên hệ của khách truy cập không nằm trong các event: chúng chỉ được gửi tới e-mail đặt chỗ và webhook.

Giao diện

Mặc định, ứng dụng lấy màu thương hiệu của khách hàng từ key. Để khớp website sát hơn, thêm data-navo-theme vào container: màu, font, bo góc và chế độ tối.

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

Mọi key đều không bắt buộc. Giá trị không hợp lệ sẽ bị bỏ qua, các giá trị còn lại vẫn được áp dụng.

KeyThay đổi gìVí dụ
accentNút, liên kết, tab đang active, công tắc, focus ring. Sắc độ hover và pressed được tính từ màu này"#e4002b"
textVăn bản chính"#1a1a1a"
mutedVăn bản phụ: nhãn, gợi ý, ngày tháng"#6b7280"
headingHeading, tên hãng vận tải và tên tàu, đường trên bản đồ"#002f6c"
backgroundNền trang của ứng dụng. "transparent" cho phép nền riêng của khách hàng hiển thị xuyên qua"#ffffff"
surfaceCard, input, sọc trong bảng"#f5f7fa"
borderViền và đường phân cách"#e5e7eb"
successTrạng thái tích cực: đã giao, đúng giờ, rẻ nhất"#15803d"
radiusBo góc của card và panel, px (0 tới 40)8
buttonRadiusBo góc của nút và input, px. 999 tạo dạng pill (mặc định)6
fontFont thân bài. Bất kỳ family nào từ Google Fonts sẽ được tải sẵn cho bạn; "system" dùng font hệ thống của khách truy cập"Inter"
headingFontFont cho heading, cùng quy tắc. Nếu không có, heading dùng font"Playfair Display"
fontCssStylesheet font của bạn (https:// URL với các rule @font-face), dành cho font không có trên Google Fonts. Khi đó font và headingFont đặt tên family từ file này"https://acme.com/fonts/brand.css"
mode"dark" cho các website có thiết kế tối"dark"

Màu là hex: #rgb, #rrggbb hoặc #rrggbbaa.

Các điểm khởi đầu có sẵn:

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

Một theme cho mọi trang. Chúng tôi cũng có thể lưu theme trên key. Khi đó mọi container trên mọi trang sẽ nhận theme đó mà không cần thuộc tính, và chúng tôi có thể điều chỉnh về sau mà không cần thay đổi gì trên website của khách hàng. data-navo-theme trên một container vẫn được ưu tiên hơn theme của key, theo từng key.

Theme chỉ đi tới ứng dụng bên trong frame: nó không bao giờ thay đổi chính trang của khách hàng.

React và Next.js, với lập chỉ mục tìm kiếm

Dùng phần này khi website của khách hàng được xây bằng React hoặc Next.js và nội dung của ứng dụng cần được lập chỉ mục như trang của khách hàng (ví dụ, một trang cho mỗi tuyến, “Shanghai to Hamburg sailing schedule”).

Gồm hai phần:

  1. Snapshot. Server của khách hàng lấy dữ liệu của tuyến từ chúng tôi dưới dạng HTML thuần (bảng lịch tàu hoặc bảng giá, một heading, một dòng tóm tắt và markup schema.org) rồi đưa vào trang của họ. Công cụ tìm kiếm lập chỉ mục nội dung đó như nội dung của khách hàng, trên URL của khách hàng.
  2. Ứng dụng. Trong trình duyệt, ứng dụng tương tác được mount phía trên, với tìm kiếm, bộ lọc, chi tiết và đặt chỗ. Snapshot vẫn nằm trên trang dưới dạng bảng có thể thu gọn bên dưới ứng dụng, để crawler và khách truy cập thấy cùng một nội dung.

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

Nếu không có format=html, phản hồi là 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"
  }
}

Dùng title và description cho <title> và meta description của trang, html cho body. Phản hồi có thể được cache trong 30 phút (Cache-Control: max-age=1800). Một snapshot được tính là một lượt tìm kiếm vào giới hạn của ứng dụng; cùng một tuyến trong cùng ngày thì miễn phí. Tracking không có snapshot: lô hàng là thông tin riêng của khách truy cập.

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

Cách công cụ tìm kiếm nhìn thấy trang: title và description riêng của trang, một heading và một bảng đầy đủ các chuyến tàu (hoặc giá cước) trong HTML, với markup Dataset. Cách khách truy cập nhìn thấy: ứng dụng live, đã mở sẵn đúng tuyến đó, với cùng kết quả dưới dạng một bảng được gập bên dưới. Khách truy cập tắt JavaScript sẽ thấy bảng đang mở. Bảng được gập chứ không bị ẩn, nên trang không hiển thị cho crawler bất kỳ nội dung nào mà khách truy cập không thể mở.

Snapshot HTML đến từ server của chúng tôi với mọi giá trị đã được escape, nên có thể chèn an toàn. Nếu bảng từng được hiển thị, hãy style bằng các class .navo-snapshot và .navo-snapshot-table.

Các framework server khác (Remix, Astro, Nuxt, PHP, WordPress) hoạt động theo cùng cách: fetch snapshot trên server, in html vào trang, đặt container bên cạnh.

React thuần (không server rendering)

Khi việc lập chỉ mục tìm kiếm không quan trọng (một trang tracking nằm sau menu, intranet), component không có snapshot là đủ:

Loader hoạt động tương tự trong ứng dụng single-page (React, Vue, Svelte): render container, sau đó gọi 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' }} />

Trong Next.js, đặt nó trong client component ('use client').

Vì sao dùng frame

Loader vẽ từng ứng dụng bên trong một frame từ navo24.com. Đây là cách Stripe Checkout, Google Maps embed và YouTube player hoạt động, vì cùng những lý do:

  • Khóa domain. Chính trình duyệt từ chối hiển thị ứng dụng trên website không nằm trong danh sách của key (frame-ancestors). Một script component được tải vào trang của khách hàng không thể bị khóa theo cách này.
  • Không xung đột style. CSS của khách hàng không thể làm hỏng ứng dụng và CSS của chúng tôi không thể chạm vào website của họ.
  • Cập nhật không cần khách hàng thao tác. Hãng vận tải mới, bản sửa lỗi và tính năng mới đến mọi website trong cùng ngày; phía khách hàng không cần nâng cấp gì.
  • Công cụ tìm kiếm. Nội dung bên trong frame không được lập chỉ mục như trang của khách hàng, giống như mọi map hoặc video embed khác. Khi điều đó quan trọng, hãy thêm snapshot server-rendered, xem React và Next.js, với lập chỉ mục tìm kiếm.

Khách truy cập không đăng nhập bên trong frame, nên việc trình duyệt chặn cookie bên thứ ba không ảnh hưởng đến nó.

Liên kết tới đúng một màn hình

Khi khách truy cập làm việc trong ứng dụng, URL của trang đi theo họ: ?navo_app=<app>&navo=<view>. Các nút Sao chép liên kết bên trong ứng dụng tạo ra cùng kiểu liên kết. Ví dụ trên trang khách hàng /rates:

Màn hìnhLiên kết
Một container/track?navo_app=tracking&navo=ref%3DZMOU8956106
Tìm kiếm giá trên một tuyến/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
Một giá cướclượt tìm kiếm ở trên cộng thêm %26quote%3D<id>
Tìm kiếm lịch tàu trên một tuyến/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
Một chuyến tàulượt tìm kiếm ở trên cộng thêm %26sailing%3D<id>
Một tàu/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
Một cảng/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

Một giá cước hoặc chuyến tàu được chia sẻ vẫn mở được sau khi đã rời khỏi kết quả live; nó được hiển thị cùng ngày dữ liệu được lấy.

Yêu cầu đặt chỗ

Đặt chỗ trên một giá cước mở form yêu cầu (liên hệ, công ty, e-mail, điện thoại, số lượng container, ngày hàng sẵn sàng, hàng hóa, ghi chú). Khi submit:

  • một e-mail được gửi tới địa chỉ đặt chỗ của khách hàng, kèm tuyến, thiết bị, hãng vận tải, mức giá khách truy cập đã thấy và thông tin liên hệ của khách truy cập. Reply-To là khách truy cập, nên khách hàng có thể trả lời trực tiếp từ mailbox của họ;
  • nếu webhook được thiết lập, cùng yêu cầu đó được POST tới webhook dưới dạng 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" }
  }
}

Khách truy cập thấy xác nhận kèm mã tham chiếu. Không có khoản phí nào được thu và không có booking nào được tạo với hãng vận tải: khách hàng xác nhận chỗ và phản hồi.

Nếu không có e-mail đặt chỗ hoặc webhook, form vẫn ở chế độ demo và sẽ nói rõ như vậy.

Khách truy cập thấy gì, và không thấy gì

  • Tên và logo hãng vận tải, giá, thời gian vận chuyển, hiệu lực và những gì giá cước bao gồm.
  • Giá cước không có tên hãng vận tải được hiển thị là “<Tên khách hàng> Select”, với logo của khách hàng.
  • Nguồn giá cước và nền tảng không bao giờ được hiển thị. Chúng được loại bỏ trên server của chúng tôi trước khi dữ liệu tới trình duyệt.

Bảo mật

Khóa domain. Các trang ứng dụng trả về Content-Security-Policy: frame-ancestors chỉ liệt kê các domain của key, nên trình duyệt từ chối hiển thị chúng ở bất kỳ nơi nào khác. Các request dữ liệu mang theo key và host của trang cha, và bị từ chối khi host không nằm trong danh sách. Một key bị sao chép sang website khác sẽ không hoạt động ở đó.

Giới hạn. Mỗi ứng dụng trên một key có giới hạn theo tháng hoặc theo năm riêng (xem Giới hạn sử dụng). Ngoài ra, mọi key đều có mức trần an toàn 50,000 request mỗi tháng, mức trần 600 request mỗi phút cho toàn bộ website (để một đợt tăng traffic của một website không làm chậm ứng dụng cho các website khác; có thể tăng theo yêu cầu) và giới hạn tốc độ theo từng khách truy cập để chống lạm dụng bằng script; vượt các mức này, ứng dụng hiển thị thông báo ngắn “thử lại” và phát navo:limit.

Thông điệp. Frame và loader giao tiếp qua postMessage, và mỗi bên chỉ gửi tới đúng origin của bên kia: frame gửi tới trang của khách hàng, loader gửi tới navo24.com. Chi tiết tìm kiếm không bao giờ được gửi tới *.

Luân chuyển. Nếu key bị lộ hoặc website đổi chủ, chúng tôi cấp key mới và key cũ ngừng hoạt động ngay lập tức.

Kiểm thử trước khi ra mắt

Gửi cho chúng tôi domain staging cùng với domain production, hoặc localhost:<port> cho máy của lập trình viên. Cả hai có thể nằm trên cùng một key.

Checklist

  1. Khách hàng gửi tên, domain, logo, màu, e-mail đặt chỗ, các ứng dụng họ đã mua (bật hoặc tắt chế độ AI) và giới hạn cho từng ứng dụng (và tùy chọn webhook, đường dẫn trang).
  2. Chúng tôi tạo key và gửi các đoạn mã.
  3. Khách hàng thêm embed.js và các container, trước tiên trên staging.
  4. Khách hàng kiểm tra: tìm kiếm → tracking, rates → chi tiết → đặt chỗ (một e-mail test được gửi đến), một liên kết chia sẻ mở trên website của họ. Với CSP nghiêm ngặt, kiểm tra console của trình duyệt để xem navo24.com có bị chặn không.
  5. Khách hàng thêm domain production (nếu chưa có trong danh sách) và go live.