Skip to content
Navo24Navo24

คู่มือ

ฝังแอป Navo ในเว็บไซต์ลูกค้า

ฝังการติดตามตู้คอนเทนเนอร์บนเว็บไซต์ของคุณ พร้อมราคาค่าขนส่ง ตารางเดินเรือ และโหมด AI ในแบรนด์คุณเอง ด้วย script tag เดียวและคีย์ล็อกโดเมน

คุณสามารถฝังระบบติดตามตู้คอนเทนเนอร์บนเว็บไซต์ของลูกค้าเอง พร้อมกับค่าระวางและตารางเดินเรือได้ แอปเหล่านี้คือแอปเดียวกับที่เห็นใน เว็บไซต์ตัวอย่างของ forwarder: วิดเจ็ตค้นหาสำหรับหน้าแรก และหน้าเต็มสำหรับแต่ละแอป ทุกแอปแสดงด้วยชื่อ โลโก้ และสีของลูกค้าเอง แต่ละมุมมองมีลิงก์ของตัวเอง ดังนั้นผู้เข้าชมสามารถส่งให้เพื่อนร่วมงานดูตู้คอนเทนเนอร์หนึ่งรายการ การค้นหาราคาหนึ่งรายการ ราคาหนึ่งรายการ เที่ยวเรือหนึ่งรายการ เรือหนึ่งลำ หรือท่าเรือหนึ่งแห่ง และลิงก์จะเปิดบนเว็บไซต์ของลูกค้า

ฝั่งลูกค้าไม่ต้องใช้ API key หรือเซิร์ฟเวอร์ใด ๆ embed key เป็นแบบ public และใช้ได้เฉพาะบนโดเมนที่เราระบุไว้ให้เท่านั้น

สิ่งที่ลูกค้าส่งให้เรา

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 modeYes
ขีดจำกัดการใช้งานต่อแอป ต่อเดือนหรือต่อปีtracking: 300 unique shipments a monthYes
หน้าที่แต่ละแอปจะอยู่/track, /rates, /schedulesRecommended
แสดงหรือซ่อน “ขับเคลื่อนโดย Navo”shownDefault: shown

เราจะสร้าง key แล้วส่ง snippet ด้านล่างกลับไป โดยใส่ key ให้เรียบร้อย

หนึ่ง key รองรับอะไรได้บ้าง

หนึ่ง key เปิดแอปเดียวหรือหลายแอปได้ และ AI mode เป็นสวิตช์แยกต่างหาก:

PackageApps on the keyWhat the visitor gets
Tracking onlytrackingหน้า tracking, วิดเจ็ตค้นหาแสดงกล่อง tracking โดยไม่มีแท็บและไม่มีสวิตช์ AI
Tracking with AItracking, aiเหมือนด้านบน พร้อม AI mode ในวิดเจ็ตค้นหาและ “ถาม AI” บน shipment
Rates and schedulesfreight, schedulesสองแท็บในวิดเจ็ตค้นหา, หน้า rates และ schedules
Everythingtracking, freight, schedules, aiครบทั้งสามแท็บ, AI mode, ทุกหน้า

วิดเจ็ตสร้างจาก key: แท็บ หน้า หรือปุ่ม AI ที่ key ไม่ได้เปิดสิทธิ์ไว้จะไม่ถูกวาดขึ้นมาเลย และเซิร์ฟเวอร์ของเราจะปฏิเสธข้อมูลของส่วนนั้นแม้มีคนพยายามบังคับส่ง request เข้ามา

ขีดจำกัดการใช้งาน

แต่ละแอปบน key มีขีดจำกัดของตัวเอง ต่อเดือนปฏิทินหรือต่อปีปฏิทิน (UTC) สิ่งที่นับเป็นหนึ่งหน่วย:

AppOne unitFree repeats
trackingหนึ่ง shipment ที่ไม่ซ้ำ (หมายเลขตู้คอนเทนเนอร์ booking หรือ B/L)shipment เดิมตลอดช่วงเวลานั้น
freightหนึ่งการค้นหาราคา (lane และ equipment)การค้นหาเดิมในวันเดียวกัน
schedulesหนึ่งการค้นหาตารางเดินเรือ (route, vessel หรือ port)การค้นหาเดิมในวันเดียวกัน
aiหนึ่งคำถามถึง AI assistantNone

ตัวอย่าง: tracking จำกัดที่ 300 unique shipments ต่อเดือน ผู้เข้าชมของลูกค้าสามารถเปิดและรีเฟรช shipment 300 รายการนั้นกี่ครั้งก็ได้ตลอดทั้งเดือน, shipment ที่ 301 จะถูกปฏิเสธจนถึงวันที่ 1 ของเดือนถัดไป เมื่อแอปใดถึงขีดจำกัด ผู้เข้าชมจะเห็น “บริการนี้ถูกพักไว้บนไซต์นี้ชั่วคราว โปรดติดต่อ ” แอปอื่น ๆ บน key เดียวกันยังใช้งานได้ตามปกติ เราเห็นการใช้งานแยกตามแอปและสามารถเพิ่มขีดจำกัดได้ทุกเมื่อ โดยไม่ต้องเปลี่ยนอะไรบนเว็บไซต์ของลูกค้า

การติดตั้ง

ใส่ loader หนึ่งครั้งในทุกหน้าที่แสดงแอป:

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

จากนั้นใส่ container ในตำแหน่งที่ต้องการให้แอปแสดง

วิดเจ็ตค้นหา (hero ของหน้าแรก หรือหน้าใดก็ได้) กล่องเดียวพร้อมแท็บสำหรับแต่ละแอปบน key (tracking, rates, schedules) และ AI mode ถ้า key มีสิทธิ์นี้ ถ้ามีแอปเดียวจะไม่มีแท็บ:

<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) พร้อมสามแท็บ: ตาม route, ตาม vessel, ตาม port:

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

ใช้ค่า data-navo-pages เดียวกันบนทุกแอป เพื่อให้ cross-link (เช่น “แสดงราคา” บน sailing หรือ “ตารางเรือ” บน shipment) ไปยังหน้าที่ถูกต้องบนเว็บไซต์ของลูกค้า

ตัวเลือก

AttributeWhat it does
data-navo-appsearch, tracking, freight หรือ schedules
data-navo-keyembed key ของไซต์
data-navo-pagesJSON map จากแอปไปยัง page path บนเว็บไซต์ของลูกค้า
data-navo-heightความสูงคงที่เป็น px โดยค่าเริ่มต้น frame จะขยายตามเนื้อหา, tracking เป็นแผนที่เต็ม, 680 px
data-navo-syncoff ทำให้ URL ของหน้าไม่เปลี่ยนขณะผู้เข้าชมคลิกไปมา
data-navo-themeJSON พร้อมสี ฟอนต์ และมุม ดู รูปลักษณ์และความรู้สึก

ไซต์ที่มี Content Security Policy

ถ้าไซต์ส่ง header Content-Security-Policy (หรือ <meta http-equiv> แบบเดียวกัน) พร้อม script-src หรือ frame-src ให้เพิ่ม navo24.com เข้าไปในทั้งสอง directive ไม่เช่นนั้น browser จะบล็อก loader หรือ frame และ container จะว่างเปล่า:

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

ถ้าใช้ child-src แทน frame-src ให้เพิ่มไว้ตรงนั้น ไม่ต้องตั้งค่าอื่นเพิ่มเติม: แอปโหลด data, fonts และ maps ภายใน frame ภายใต้นโยบายของเราเอง browser console จะระบุ directive ที่ถูกบล็อกถ้าขาดรายการใดรายการหนึ่ง

Events สำหรับ analytics และ CRM

container จะ fire DOM events เมื่อผู้เข้าชมทำบางอย่าง เพื่อให้ไซต์ส่งต่อไปยัง Google Analytics, tag manager หรือ CRM ของตัวเองได้ event เหล่านี้ bubble ดังนั้น listener ตัวเดียวบน document จะจับทุกแอปบนหน้านั้นได้

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>

รายละเอียดการติดต่อของผู้เข้าชมไม่ได้อยู่ใน events: ข้อมูลเหล่านั้นจะส่งไปเฉพาะอีเมล booking และ webhook เท่านั้น

รูปลักษณ์และความรู้สึก

โดยค่าเริ่มต้น แอปจะใช้สีแบรนด์ของลูกค้าจาก key หากต้องการให้เข้ากับไซต์มากขึ้น ให้เพิ่ม data-navo-theme ใน container: สี ฟอนต์ ความโค้งของมุม และ 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 เป็น optional หากค่าใดไม่ถูกต้อง ค่านั้นจะถูกละเว้น ส่วนที่เหลือยังทำงานต่อไป

KeyWhat it changesExample
accentปุ่ม ลิงก์ แท็บที่ active สวิตช์ focus ring โดย shade ตอน hover และ pressed จะคำนวณจากค่านี้"#e4002b"
textข้อความหลัก"#1a1a1a"
mutedข้อความรอง: label, hint, วันที่"#6b7280"
headingheading, ชื่อ carrier และ vessel, เส้นบนแผนที่"#002f6c"
backgroundพื้นหลังหน้าของแอป ค่า "transparent" ทำให้เห็นพื้นหลังของลูกค้าเอง"#ffffff"
surfacecard, input, stripe ใน table"#f5f7fa"
borderเส้นขอบและ divider"#e5e7eb"
successสถานะเชิงบวก: delivered, on time, cheapest"#15803d"
radiusความโค้งมุมของ card และ panel, px (0 ถึง 40)8
buttonRadiusความโค้งมุมของปุ่มและ input, px ค่า 999 ทำให้เป็นทรง pill (ค่าเริ่มต้น)6
fontฟอนต์ body โหลด family ใดก็ได้จาก Google Fonts ให้โดยอัตโนมัติ, "system" ใช้ฟอนต์ระบบของผู้เข้าชม"Inter"
headingFontฟอนต์สำหรับ heading, ใช้กฎเดียวกัน หากไม่มีจะใช้ font สำหรับ heading"Playfair Display"
fontCssstylesheet ฟอนต์ของคุณเอง (https:// URL พร้อมกฎ @font-face) สำหรับฟอนต์ที่ไม่ได้อยู่บน Google Fonts จากนั้น font และ headingFont จะอ้างชื่อ family จากไฟล์นั้น"https://acme.com/fonts/brand.css"
mode"dark" สำหรับไซต์ที่ออกแบบแบบ 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 ไว้บน key ได้เช่นกัน จากนั้น container ทุกตัวบนทุกหน้าจะได้ theme นั้นโดยไม่ต้องใส่ attribute และเราสามารถปรับภายหลังได้โดยไม่ต้องเปลี่ยนอะไรบนเว็บไซต์ของลูกค้า data-navo-theme บน container ยังมีสิทธิ์เหนือกว่า theme ของ key ทีละ key

theme มีผลเฉพาะกับแอปภายใน frame เท่านั้น: จะไม่เปลี่ยนหน้าของลูกค้าเอง

React และ Next.js พร้อม search indexing

ใช้ส่วนนี้เมื่อเว็บไซต์ของลูกค้าสร้างด้วย React หรือ Next.js และต้องการให้เนื้อหาของแอปถูก index เป็นหน้าของลูกค้า (เช่น หน้าต่อ lane, “Shanghai to Hamburg sailing schedule”)

มี 2 ส่วน:

  1. Snapshot เซิร์ฟเวอร์ของลูกค้าดึงข้อมูล lane จากเราเป็น HTML ธรรมดา (ตาราง schedule หรือ rate, heading, summary หนึ่งบรรทัด และ schema.org markup) แล้วใส่ไว้ในหน้าของตัวเอง Search engine จะ index เป็นเนื้อหาของลูกค้า บน URL ของลูกค้า
  2. App ใน browser แอปแบบ interactive จะ mount อยู่เหนือ snapshot พร้อม search, filter, detail และ booking snapshot ยังอยู่บนหน้าเป็นตารางแบบพับได้ใต้แอป เพื่อให้ crawler และผู้เข้าชมเห็นเนื้อหาเดียวกัน

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 คำตอบสามารถ cache ได้ 30 นาที (Cache-Control: max-age=1800) snapshot นับเป็นหนึ่งการค้นหาต่อขีดจำกัดของแอป, lane เดิมในวันเดียวกันไม่คิดเพิ่ม Tracking ไม่มี snapshot: shipment เป็นข้อมูลส่วนตัวของผู้เข้าชม

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

หน้าตานี้สำหรับ search engine: title และ description ของหน้าเอง, heading และตาราง sailings (หรือ rates) เต็มรูปแบบใน HTML พร้อม Dataset markup หน้าตาสำหรับผู้เข้าชม: แอปแบบ live ที่เปิดบน lane นั้นไว้แล้ว พร้อมผลลัพธ์เดียวกันเป็นตารางแบบพับไว้ด้านล่าง ผู้เข้าชมที่ปิด JavaScript จะเห็นตารางแบบเปิด ตารางถูกพับ ไม่ใช่ซ่อน ดังนั้นหน้าจึงไม่แสดงอะไรให้ crawler เห็นที่ผู้เข้าชมเปิดดูไม่ได้

Snapshot HTML มาจากเซิร์ฟเวอร์ของเราโดย escape ทุกค่าแล้ว จึงปลอดภัยที่จะ insert เข้าไป หากตารางถูกแสดง ให้ style ด้วย class .navo-snapshot และ .navo-snapshot-table

server framework อื่น ๆ (Remix, Astro, Nuxt, PHP, WordPress) ทำงานแบบเดียวกัน: fetch snapshot บนเซิร์ฟเวอร์, print html ลงในหน้า, วาง container ไว้ข้างกัน

Plain React (ไม่มี server rendering)

เมื่อ search indexing ไม่สำคัญ (หน้า tracking หลังเมนู, intranet) ใช้ component ที่ไม่มี snapshot ก็เพียงพอ:

loader ทำงานแบบเดียวกันใน single-page app (React, Vue, Svelte): render container แล้วเรียก 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 วาดแต่ละแอปไว้ภายใน frame จาก navo24.com วิธีนี้เป็นแบบเดียวกับ Stripe Checkout, Google Maps embeds และ YouTube players ด้วยเหตุผลเดียวกัน:

  • Domain lock browser เองจะปฏิเสธการแสดงแอปบนไซต์ที่ไม่ได้อยู่ในรายการของ key (frame-ancestors) script component ที่โหลดเข้าไปในหน้าของลูกค้าไม่สามารถ lock แบบนี้ได้
  • ไม่มี style clashes CSS ของลูกค้าจะไม่ทำให้แอปพัง และ CSS ของเราจะไม่แตะไซต์ของลูกค้า
  • อัปเดตโดยไม่ต้องรอลูกค้า carrier ใหม่ การแก้ไข และฟีเจอร์ใหม่ไปถึงทุกไซต์ในวันเดียวกัน, ฝั่งลูกค้าไม่ต้องอัปเกรดอะไร
  • Search engines เนื้อหาภายใน frame จะไม่ถูก index เป็นหน้าของลูกค้า เหมือนกับ map หรือ video embed ทั่วไป หากเรื่องนี้สำคัญ ให้เพิ่ม snapshot แบบ server-rendered ดู React และ Next.js พร้อม search indexing

ผู้เข้าชมไม่ได้ log in ภายใน frame ดังนั้นการบล็อก third-party cookies ของ browser จึงไม่มีผล

ลิงก์ไปยังมุมมองเฉพาะหนึ่งรายการ

ขณะผู้เข้าชมใช้งานแอป 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 แล้ว โดยจะแสดงพร้อมวันที่ที่ดึงข้อมูลนั้นมา

คำขอจอง

Book บน rate จะเปิดฟอร์มคำขอ (contact, company, e-mail, phone, number of containers, cargo-ready date, cargo, notes) เมื่อ submit:

  • อีเมลจะส่งไปยัง booking address ของลูกค้า พร้อม route, equipment, carrier, ราคาที่ผู้เข้าชมเห็น และรายละเอียดการติดต่อของผู้เข้าชม Reply-To คือผู้เข้าชม เพื่อให้ลูกค้าตอบกลับจาก mailbox ของตัวเองได้โดยตรง;
  • หากตั้ง webhook ไว้ คำขอเดียวกันจะถูก POST ไปยัง webhook เป็น 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" }
  }
}

ผู้เข้าชมจะเห็นข้อความยืนยันพร้อม reference ไม่มีการเรียกเก็บเงินและไม่มีการจองกับ carrier: ลูกค้าเป็นผู้ยืนยัน space และตอบกลับเอง

หากไม่มี booking e-mail หรือ webhook ฟอร์มจะยังเป็น demo และจะแจ้งให้ทราบ

สิ่งที่ผู้เข้าชมเห็น และสิ่งที่ไม่เห็น

  • ชื่อและโลโก้ carrier, ราคา, transit time, validity และสิ่งที่ rate รวมไว้
  • Rate ที่ไม่ระบุชื่อ carrier จะแสดงเป็น ” Select” พร้อมโลโก้ของลูกค้า
  • Rate sources และ platforms จะไม่ถูกแสดงเด็ดขาด ข้อมูลเหล่านี้ถูกลบออกบนเซิร์ฟเวอร์ของเราก่อนข้อมูลถึง browser

ความปลอดภัย

Domain lock หน้าแอปตอบกลับด้วย Content-Security-Policy: frame-ancestors ที่ระบุเฉพาะโดเมนของ key เท่านั้น ดังนั้น browser จะปฏิเสธการแสดงผลที่อื่น Data requests จะส่ง key และ host ของ parent page มาด้วย และจะถูกปฏิเสธเมื่อ host ไม่อยู่ในรายการ key ที่ถูกคัดลอกไปใส่อีกไซต์จะใช้งานที่นั่นไม่ได้

Limits แต่ละแอปบน key มีขีดจำกัดรายเดือนหรือรายปีของตัวเอง (ดู ขีดจำกัดการใช้งาน) นอกจากนี้ ทุก key ยังมี safety cap ที่ 50,000 requests ต่อเดือน, เพดาน 600 requests ต่อนาทีสำหรับทั้งไซต์ (เพื่อให้ traffic spike ของไซต์หนึ่งไม่ทำให้แอปช้าลงสำหรับไซต์อื่น, เพิ่มได้เมื่อร้องขอ) และ per-visitor rate limits เพื่อป้องกัน scripted abuse, เมื่อเกินขีดจำกัดเหล่านี้ แอปจะแสดงข้อความ “ลองอีกครั้ง” สั้น ๆ และ fire navo:limit

Messages frame และ loader คุยกันผ่าน postMessage และแต่ละฝั่งส่งเฉพาะไปยัง exact origin ของอีกฝั่งเท่านั้น: frame ไปยังหน้าของลูกค้า, loader ไปยัง navo24.com รายละเอียดการค้นหาไม่เคยส่งไปที่ *

Rotation หาก key รั่วหรือไซต์เปลี่ยนเจ้าของ เราจะออก key ใหม่และ key เก่าจะหยุดทำงานทันที

การทดสอบก่อน launch

ส่ง staging domain มาให้เราพร้อมกับ production domain หรือ localhost:<port> สำหรับเครื่อง developer ทั้งสองสามารถอยู่บน key เดียวกันได้

Checklist

  1. ลูกค้าส่งชื่อ, domains, logo, colour, booking e-mail, แอปที่ซื้อ (เปิดหรือปิด AI mode) และ limit ของแต่ละแอป (รวมถึง webhook, page paths หากมี)
  2. เราสร้าง key และส่ง snippets
  3. ลูกค้าเพิ่ม embed.js และ containers โดยเริ่มบน staging ก่อน
  4. ลูกค้าตรวจสอบ: search → tracking, rates → details → booking (อีเมลทดสอบมาถึง), shared link เปิดบนไซต์ของลูกค้า หากมี CSP ที่เข้มงวด ให้ตรวจ browser console ว่ามี navo24.com ถูกบล็อกหรือไม่
  5. ลูกค้าเพิ่ม production domain (ถ้ายังไม่อยู่ในรายการ) แล้ว go live