คู่มือ
ฝังแอป Navo ในเว็บไซต์ลูกค้า
ฝังการติดตามตู้คอนเทนเนอร์บนเว็บไซต์ของคุณ พร้อมราคาค่าขนส่ง ตารางเดินเรือ และโหมด AI ในแบรนด์คุณเอง ด้วย script tag เดียวและคีย์ล็อกโดเมน
คุณสามารถฝังระบบติดตามตู้คอนเทนเนอร์บนเว็บไซต์ของลูกค้าเอง พร้อมกับค่าระวางและตารางเดินเรือได้ แอปเหล่านี้คือแอปเดียวกับที่เห็นใน เว็บไซต์ตัวอย่างของ forwarder: วิดเจ็ตค้นหาสำหรับหน้าแรก และหน้าเต็มสำหรับแต่ละแอป ทุกแอปแสดงด้วยชื่อ โลโก้ และสีของลูกค้าเอง แต่ละมุมมองมีลิงก์ของตัวเอง ดังนั้นผู้เข้าชมสามารถส่งให้เพื่อนร่วมงานดูตู้คอนเทนเนอร์หนึ่งรายการ การค้นหาราคาหนึ่งรายการ ราคาหนึ่งรายการ เที่ยวเรือหนึ่งรายการ เรือหนึ่งลำ หรือท่าเรือหนึ่งแห่ง และลิงก์จะเปิดบนเว็บไซต์ของลูกค้า
ฝั่งลูกค้าไม่ต้องใช้ API key หรือเซิร์ฟเวอร์ใด ๆ embed key เป็นแบบ public และใช้ได้เฉพาะบนโดเมนที่เราระบุไว้ให้เท่านั้น
สิ่งที่ลูกค้าส่งให้เรา
| Item | Example | Required |
|---|---|---|
| ชื่อบริษัทตามที่ต้องการให้ผู้เข้าชมเห็น | Acme Logistics | Yes |
| โดเมนที่แอปจะทำงาน (production, staging) | acme.com, www.acme.com, staging.acme.com | Yes |
| โลโก้, SVG หรือ PNG, แบบสัญลักษณ์สี่เหลี่ยมหรือแนวนอน | https://acme.com/logo.svg | Yes |
| สีแบรนด์, ค่า hex หนึ่งค่า | #0e6ba8 | Yes |
| สีเพิ่มเติม ฟอนต์ ความโค้งของมุม | ดู รูปลักษณ์และความรู้สึก | Optional |
| อีเมลที่รับคำขอจอง | [email protected] | For freight rates |
| Webhook URL สำหรับคำขอจอง (ไปยัง CRM/TMS ของลูกค้า) | https://acme.com/hooks/navo | Optional |
| แอปที่ต้องการ | อย่างใดอย่างหนึ่งของ tracking, freight, schedules, เปิดหรือปิด AI mode | Yes |
| ขีดจำกัดการใช้งานต่อแอป ต่อเดือนหรือต่อปี | tracking: 300 unique shipments a month | Yes |
| หน้าที่แต่ละแอปจะอยู่ | /track, /rates, /schedules | Recommended |
| แสดงหรือซ่อน “ขับเคลื่อนโดย Navo” | shown | Default: shown |
เราจะสร้าง key แล้วส่ง snippet ด้านล่างกลับไป โดยใส่ key ให้เรียบร้อย
หนึ่ง key รองรับอะไรได้บ้าง
หนึ่ง key เปิดแอปเดียวหรือหลายแอปได้ และ AI mode เป็นสวิตช์แยกต่างหาก:
| Package | Apps on the key | What the visitor gets |
|---|---|---|
| Tracking only | tracking | หน้า tracking, วิดเจ็ตค้นหาแสดงกล่อง tracking โดยไม่มีแท็บและไม่มีสวิตช์ AI |
| Tracking with AI | tracking, ai | เหมือนด้านบน พร้อม AI mode ในวิดเจ็ตค้นหาและ “ถาม AI” บน shipment |
| Rates and schedules | freight, schedules | สองแท็บในวิดเจ็ตค้นหา, หน้า rates และ schedules |
| Everything | tracking, freight, schedules, ai | ครบทั้งสามแท็บ, AI mode, ทุกหน้า |
วิดเจ็ตสร้างจาก key: แท็บ หน้า หรือปุ่ม AI ที่ key ไม่ได้เปิดสิทธิ์ไว้จะไม่ถูกวาดขึ้นมาเลย และเซิร์ฟเวอร์ของเราจะปฏิเสธข้อมูลของส่วนนั้นแม้มีคนพยายามบังคับส่ง request เข้ามา
ขีดจำกัดการใช้งาน
แต่ละแอปบน key มีขีดจำกัดของตัวเอง ต่อเดือนปฏิทินหรือต่อปีปฏิทิน (UTC) สิ่งที่นับเป็นหนึ่งหน่วย:
| App | One unit | Free repeats |
|---|---|---|
tracking | หนึ่ง shipment ที่ไม่ซ้ำ (หมายเลขตู้คอนเทนเนอร์ booking หรือ B/L) | shipment เดิมตลอดช่วงเวลานั้น |
freight | หนึ่งการค้นหาราคา (lane และ equipment) | การค้นหาเดิมในวันเดียวกัน |
schedules | หนึ่งการค้นหาตารางเดินเรือ (route, vessel หรือ port) | การค้นหาเดิมในวันเดียวกัน |
ai | หนึ่งคำถามถึง AI assistant | None |
ตัวอย่าง: tracking จำกัดที่ 300 unique shipments ต่อเดือน ผู้เข้าชมของลูกค้าสามารถเปิดและรีเฟรช shipment 300 รายการนั้นกี่ครั้งก็ได้ตลอดทั้งเดือน, shipment ที่ 301 จะถูกปฏิเสธจนถึงวันที่ 1 ของเดือนถัดไป เมื่อแอปใดถึงขีดจำกัด ผู้เข้าชมจะเห็น “บริการนี้ถูกพักไว้บนไซต์นี้ชั่วคราว โปรดติดต่อ
การติดตั้ง
ใส่ 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) ไปยังหน้าที่ถูกต้องบนเว็บไซต์ของลูกค้า
ตัวเลือก
| Attribute | What it does |
|---|---|
data-navo-app | search, tracking, freight หรือ schedules |
data-navo-key | embed key ของไซต์ |
data-navo-pages | JSON map จากแอปไปยัง page path บนเว็บไซต์ของลูกค้า |
data-navo-height | ความสูงคงที่เป็น px โดยค่าเริ่มต้น frame จะขยายตามเนื้อหา, tracking เป็นแผนที่เต็ม, 680 px |
data-navo-sync | off ทำให้ URL ของหน้าไม่เปลี่ยนขณะผู้เข้าชมคลิกไปมา |
data-navo-theme | JSON พร้อมสี ฟอนต์ และมุม ดู รูปลักษณ์และความรู้สึก |
ไซต์ที่มี 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 จะจับทุกแอปบนหน้านั้นได้
| Event | When | event.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 หากค่าใดไม่ถูกต้อง ค่านั้นจะถูกละเว้น ส่วนที่เหลือยังทำงานต่อไป
| Key | What it changes | Example |
|---|---|---|
accent | ปุ่ม ลิงก์ แท็บที่ active สวิตช์ focus ring โดย shade ตอน hover และ pressed จะคำนวณจากค่านี้ | "#e4002b" |
text | ข้อความหลัก | "#1a1a1a" |
muted | ข้อความรอง: label, hint, วันที่ | "#6b7280" |
heading | heading, ชื่อ carrier และ vessel, เส้นบนแผนที่ | "#002f6c" |
background | พื้นหลังหน้าของแอป ค่า "transparent" ทำให้เห็นพื้นหลังของลูกค้าเอง | "#ffffff" |
surface | card, 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" |
fontCss | stylesheet ฟอนต์ของคุณเอง (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 ส่วน:
- Snapshot เซิร์ฟเวอร์ของลูกค้าดึงข้อมูล lane จากเราเป็น HTML ธรรมดา (ตาราง schedule หรือ rate, heading, summary หนึ่งบรรทัด และ schema.org markup) แล้วใส่ไว้ในหน้าของตัวเอง Search engine จะ index เป็นเนื้อหาของลูกค้า บน URL ของลูกค้า
- 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:
| View | Link |
|---|---|
| ตู้คอนเทนเนอร์หนึ่งรายการ | /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
- ลูกค้าส่งชื่อ, domains, logo, colour, booking e-mail, แอปที่ซื้อ (เปิดหรือปิด AI mode) และ limit ของแต่ละแอป (รวมถึง webhook, page paths หากมี)
- เราสร้าง key และส่ง snippets
- ลูกค้าเพิ่ม
embed.jsและ containers โดยเริ่มบน staging ก่อน - ลูกค้าตรวจสอบ: search → tracking, rates → details → booking (อีเมลทดสอบมาถึง), shared link เปิดบนไซต์ของลูกค้า หากมี CSP ที่เข้มงวด ให้ตรวจ browser console ว่ามี
navo24.comถูกบล็อกหรือไม่ - ลูกค้าเพิ่ม production domain (ถ้ายังไม่อยู่ในรายการ) แล้ว go live