Skip to content
Navo24Navo24

الأدلة

تضمين تطبيقات Navo في موقع العميل

ضمّن تتبع الحاويات في موقعك، مع أسعار الشحن، جداول الإبحار ووضع AI، بعلامتك التجارية عبر وسم script واحد ومفتاح مقيد بالنطاق.

يمكنك تضمين تتبّع الحاويات على موقع العميل نفسه، إلى جانب أسعار الشحن وجداول الإبحار. هذه هي التطبيقات نفسها التي تراها على موقع وكيل الشحن التجريبي: ويدجت بحث للصفحة الرئيسية، وصفحة كاملة لكل تطبيق. يظهر كل تطبيق باسم العميل وشعاره ولونه. لكل عرض رابط خاص به، بحيث يستطيع الزائر إرسال حاوية واحدة، أو بحث سعر واحد، أو سعر واحد، أو رحلة إبحار واحدة، أو سفينة واحدة، أو ميناء واحد إلى زميل، ويفتح الرابط على موقع العميل.

لا يحتاج جانب العميل إلى API key أو خادم. مفتاح التضمين علني، ولا يعمل إلا على النطاقات التي ندرجها له.

ما يرسله العميل إلينا

ItemExampleRequired
اسم الشركة كما ينبغي أن يراه الزوارAcme LogisticsYes
النطاقات التي ستعمل عليها التطبيقات، الإنتاج والاختبار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
التطبيقات التي يريدونهاأي من التتبّع، الشحن، الجداول، مع تشغيل وضع AI أو إيقافهYes
حد الاستخدام لكل تطبيق، شهرياً أو سنوياًالتتبّع: 300 شحنة فريدة شهرياًYes
الصفحات التي سيظهر فيها كل تطبيق/track, /rates, /schedulesRecommended
عرض “مدعوم من Navo” أو إخفاؤهظاهرDefault: shown

ننشيء المفتاح ونرسل المقاطع أدناه بعد تعبئة المفتاح فيها.

ما يمكن أن يحمله مفتاح واحد

يفتح المفتاح تطبيقاً واحداً أو عدة تطبيقات، ووضع AI مفتاح تشغيل منفصل:

PackageApps on the keyWhat the visitor gets
التتبّع فقطtrackingصفحة التتبّع، ويعرض ويدجت البحث مربع التتبّع دون تبويبات ودون مفتاح AI
التتبّع مع AItracking, aiالشيء نفسه، بالإضافة إلى وضع AI في ويدجت البحث و”اسأل AI” على الشحنات
الأسعار والجداولfreight, schedulesتبويبان في ويدجت البحث، وصفحتا الأسعار والجداول
كل شيءtracking, freight, schedules, aiالتبويبات الثلاثة كلها، وضع AI، كل الصفحات

يتم بناء الويدجت من المفتاح: أي تبويب أو صفحة أو زر AI لا يفتحه المفتاح لا يتم رسمه أصلاً، ويرفض خادمنا بياناته حتى لو حاول شخص فرض الطلب.

حدود الاستخدام

لكل تطبيق على المفتاح حد خاص به، لكل شهر تقويمي أو لكل سنة تقويمية (UTC). ما يُحسب كوحدة واحدة:

AppOne unitFree repeats
trackingشحنة فريدة واحدة، رقم حاوية أو حجز أو B/Lالشحنة نفسها لبقية الفترة
freightبحث سعر واحد، المسار والمعدةالبحث نفسه في اليوم نفسه
schedulesبحث جدول واحد، مسار أو سفينة أو ميناءالبحث نفسه في اليوم نفسه
aiسؤال واحد إلى مساعد AIلا يوجد

مثال: التتبّع عند 300 شحنة فريدة شهرياً. يستطيع زوار العميل فتح تلك الشحنات الـ 300 وتحديثها كما يشاؤون طوال الشهر، وتُرفض الشحنة 301 حتى اليوم 1 من الشهر التالي. عندما يصل تطبيق إلى حده، يرى الزوار “هذه الخدمة متوقفة مؤقتاً على هذا الموقع حالياً. يرجى التواصل مع <اسم العميل>.” وتستمر التطبيقات الأخرى على المفتاح بالعمل. نرى الاستخدام لكل تطبيق ويمكننا رفع الحد في أي لحظة، من دون أي تغيير على موقع العميل.

التثبيت

ضع المحمّل مرة واحدة على كل صفحة تعرض تطبيقاً:

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

ثم ضع حاوية في المكان الذي ينبغي أن يظهر فيه التطبيق.

ويدجت البحث، في واجهة الصفحة الرئيسية أو أي صفحة. مربع واحد مع تبويب لكل تطبيق على المفتاح، التتبّع والأسعار والجداول، ووضع AI إذا كان المفتاح يتضمنه. مع تطبيق واحد لا توجد تبويبات:

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

مع data-navo-pages يرسل الويدجت الزوار إلى صفحات العميل نفسها. ومن دونه، تفتح النتيجة داخل إطار الويدجت مباشرة.

صفحة التتبّع (/track):

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

صفحة أسعار الشحن (/rates):

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

صفحة جداول الإبحار (/schedules)، مع ثلاثة تبويبات: حسب المسار، حسب السفينة، حسب الميناء:

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

استخدم قيمة data-navo-pages نفسها على كل تطبيق حتى تصل الروابط المتقاطعة، مثل “عرض الأسعار” على رحلة إبحار، أو “جدول السفينة” على شحنة، إلى الصفحة الصحيحة على موقع العميل.

الخيارات

AttributeWhat it does
data-navo-appsearch, tracking, freight أو schedules.
data-navo-keyمفتاح التضمين الخاص بالموقع.
data-navo-pagesخريطة JSON من التطبيق إلى مسار الصفحة على موقع العميل.
data-navo-heightارتفاع ثابت بالبكسل. افتراضياً يكبر الإطار مع محتواه، والتتبّع خريطة كاملة، 680 px.
data-navo-syncoff يبقي URL الصفحة من دون تغيير أثناء تنقّل الزائر.
data-navo-themeJSON للألوان والخطوط والزوايا، راجع الشكل والإحساس.

المواقع التي تستخدم Content Security Policy

إذا كان الموقع يرسل ترويسة Content-Security-Policy، أو ترويسة <meta http-equiv>، مع script-src أو frame-src، أضف navo24.com إلى كليهما، وإلا فسيحظر المتصفح المحمّل أو الإطار وتبقى الحاوية فارغة:

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

إذا كان الموقع يستخدم child-src بدلاً من frame-src، فأضفه هناك. لا يلزم أي شيء آخر: تحمّل التطبيقات بياناتها وخطوطها وخرائطها داخل الإطار، وفق سياستنا الخاصة. تعرض وحدة تحكم المتصفح اسم التوجيه المحظور إذا كان أحدها ناقصاً.

أحداث التحليلات و CRM

تطلق الحاوية أحداث DOM عندما يفعل الزائر شيئاً، حتى يتمكن الموقع من إرسالها إلى Google Analytics أو مدير وسوم أو CRM لديه. تتصاعد الأحداث، لذلك يلتقط مستمع واحد على document كل تطبيق على الصفحة.

EventWhenevent.detail
navo:searchأعاد بحث نتائجapp (tracking, freight, schedules) والاستعلام: 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>

تفاصيل اتصال الزائر ليست ضمن الأحداث: تذهب فقط إلى بريد الحجز الإلكتروني و webhook.

الشكل والإحساس

افتراضياً تأخذ التطبيقات لون علامة العميل التجارية من المفتاح. لمطابقة الموقع بشكل أدق، أضف data-navo-theme إلى الحاوية: الألوان، الخطوط، تدوير الزوايا، والوضع الداكن.

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

كل مفتاح اختياري. إذا كانت قيمة غير صالحة، يتم تجاهلها ويستمر تطبيق الباقي.

KeyWhat it changesExample
accentالأزرار، الروابط، التبويبات النشطة، المفاتيح، حلقة التركيز. يتم حساب ظلال التحويم والضغط منه"#e4002b"
textالنص الرئيسي"#1a1a1a"
mutedالنص الثانوي: التسميات، التلميحات، التواريخ"#6b7280"
headingالعناوين، أسماء الناقلين والسفن، خطوط الخريطة"#002f6c"
backgroundخلفية صفحة التطبيق. "transparent" يسمح بظهور خلفية العميل نفسها"#ffffff"
surfaceالبطاقات، المدخلات، خطوط الجداول المتناوبة"#f5f7fa"
borderالحدود والفواصل"#e5e7eb"
successالحالات الإيجابية: تم التسليم، في الموعد، الأرخص"#15803d"
radiusتدوير زوايا البطاقات واللوحات، px (0 إلى 40)8
buttonRadiusتدوير زوايا الأزرار والمدخلات، px. 999 يعطي شكلاً كبسولياً، وهو الافتراضي6
fontخط النص الأساسي. يتم تحميل أي عائلة من Google Fonts لك، و "system" يستخدم خط نظام الزائر"Inter"
headingFontخط العناوين، بالقواعد نفسها. من دونه تستخدم العناوين font"Playfair Display"
fontCssملف تنسيق الخط الخاص بك، URL يبدأ بـ https:// ويحتوي قواعد @font-face، للخطوط غير الموجودة على Google Fonts. بعدها تسمي font و headingFont العائلات من ذلك الملف"https://acme.com/fonts/brand.css"
mode"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"}'

سمة واحدة لكل الصفحات. يمكننا أيضاً تخزين السمة على المفتاح. عندها تحصل كل حاوية على كل صفحة عليها من دون السمة، ويمكننا تعديلها لاحقاً من دون أي تغيير على موقع العميل. تظل data-navo-theme على الحاوية أعلى أولوية من سمة المفتاح، مفتاحاً بمفتاح.

تصل السمة فقط إلى التطبيق داخل الإطار: لا تغيّر صفحة العميل نفسها أبداً.

React و Next.js، مع فهرسة البحث

استخدم هذا عندما يكون موقع العميل مبنياً باستخدام React أو Next.js وينبغي فهرسة محتوى التطبيق كصفحة للعميل، مثلاً صفحة لكل مسار، “Shanghai to Hamburg sailing schedule”.

يتكوّن من جزأين:

  1. لقطة. يجلب خادم العميل بيانات المسار منا بصيغة HTML عادية، جدول جداول إبحار أو جدول أسعار، عنوان، ملخص من سطر واحد، وترميز schema.org، ثم يضعها داخل صفحته. تفهرسها محركات البحث كمحتوى للعميل، على URL الخاص بالعميل.
  2. التطبيق. في المتصفح يتم تركيب التطبيق التفاعلي فوقها، مع البحث والفلاتر والتفاصيل والحجز. تبقى اللقطة على الصفحة كجدول قابل للطي تحت التطبيق، بحيث يرى الزواحف والزوار المحتوى نفسه.

نقطة نهاية اللقطة

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 للصفحة، و html للنص. يمكن تخزين الإجابة مؤقتاً لمدة 30 دقيقة (Cache-Control: max-age=1800). تُحسب اللقطة كبحث واحد من حد التطبيق، والمسار نفسه في اليوم نفسه مجاني. لا يملك التتبّع لقطة: الشحنات خاصة بالزائر.

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

كيف يبدو ذلك لمحرك بحث: عنوان الصفحة ووصفها الخاصان، عنوان وجدول كامل لرحلات الإبحار، أو الأسعار، في HTML، مع ترميز Dataset. وكيف يبدو للزائر: التطبيق الحي، مفتوح مسبقاً على ذلك المسار، مع النتائج نفسها كجدول مطوي تحته. يرى الزوار الذين أوقفوا JavaScript الجدول مفتوحاً. الجدول مطوي وليس مخفياً، لذلك لا تعرض الصفحة للزواحف شيئاً لا يستطيع الزائر فتحه.

تأتي HTML اللقطة من خادمنا وكل قيمة فيها escaped، لذلك فهي آمنة للإدراج. نسقها باستخدام الصنفين .navo-snapshot و .navo-snapshot-table إذا ظهرت في أي وقت.

تعمل أطر الخادم الأخرى، مثل Remix و Astro و Nuxt و PHP و WordPress، بالطريقة نفسها: اجلب اللقطة على الخادم، اطبع html داخل الصفحة، وضع الحاوية بجانبها.

React عادي، من دون تصيير خادمي

عندما لا تهم فهرسة البحث، مثل صفحة تتبّع خلف قائمة أو intranet، يكفي المكوّن من دون اللقطة:

يعمل المحمّل بالطريقة نفسها في تطبيق أحادي الصفحة، React أو Vue أو Svelte: اعرض الحاوية، ثم استدع 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 ضعه في مكوّن عميل ('use client').

لماذا نستخدم إطاراً

يرسم المحمّل كل تطبيق داخل إطار من navo24.com. هذه هي طريقة عمل Stripe Checkout وتضمينات Google Maps ومشغلات YouTube، للأسباب نفسها:

  • قفل النطاق. يرفض المتصفح نفسه عرض التطبيق على موقع غير موجود في قائمة المفتاح (frame-ancestors). لا يمكن قفل مكوّن script محمّل داخل صفحة العميل بهذه الطريقة.
  • لا تضارب في التنسيقات. لا يمكن لـ CSS الخاص بالعميل أن يكسر التطبيق، ولا يمكن لـ CSS الخاص بنا أن يمس موقعهم.
  • تحديثات من دون العميل. تصل الناقلات الجديدة والإصلاحات والميزات إلى كل موقع في اليوم نفسه، ولا يوجد شيء يرقّيه العميل من جهته.
  • محركات البحث. لا تتم فهرسة المحتوى داخل إطار كصفحة للعميل، كما هو الحال مع أي تضمين خريطة أو فيديو. عندما يكون ذلك مهماً، أضف اللقطة المصيّرة على الخادم، راجع React و Next.js، مع فهرسة البحث.

لا يسجل الزوار الدخول داخل الإطار، لذلك لا يؤثر حظر المتصفح لملفات تعريف ارتباط الطرف الثالث عليه.

روابط إلى عرض محدد تماماً

بينما يعمل الزائر داخل تطبيق، يتبعه URL الصفحة: ?navo_app=<app>&navo=<view>. تنتج أزرار نسخ الرابط داخل التطبيقات النوع نفسه من الروابط. أمثلة على صفحة عميل /rates:

ViewLink
حاوية/track?navo_app=tracking&navo=ref%3DZMOU8956106
بحث سعر على مسار/rates?navo_app=freight&navo=origin%3DCNSHA%26destination%3DDEHAM%26container%3D40HC
سعر واحدالبحث أعلاه مع %26quote%3D<id>
بحث إبحار على مسار/schedules?navo_app=schedules&navo=origin%3DCNSHA%26destination%3DDEHAM
رحلة إبحار واحدةالبحث أعلاه مع %26sailing%3D<id>
سفينة/schedules?navo_app=schedules&navo=by%3Dvessel%26imo%3D9893890
ميناء/schedules?navo_app=schedules&navo=by%3Dport%26port%3DSGSIN

يستمر فتح سعر أو رحلة إبحار تمت مشاركتها حتى بعد خروجها من النتائج الحية، وتُعرض مع تاريخ أخذ بياناتها.

طلبات الحجز

يفتح احجز على السعر نموذج طلب، بيانات الاتصال، الشركة، البريد الإلكتروني، الهاتف، عدد الحاويات، تاريخ جاهزية البضاعة، البضاعة، الملاحظات. عند الإرسال:

  • يذهب بريد إلكتروني إلى عنوان الحجز لدى العميل، مع المسار، والمعدة، والناقل، والسعر الذي رآه الزائر، وتفاصيل اتصال الزائر. Reply-To هو الزائر، لذلك يرد العميل مباشرة من صندوق بريده;
  • إذا تم إعداد webhook، يتم إرسال الطلب نفسه إليه عبر POST بصيغة 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" }
  }
}

يرى الزائر تأكيداً مع المرجع. لا يتم تحصيل أي مبلغ ولا يتم إنشاء حجز لدى الناقل: يؤكد العميل المساحة ويرد.

من دون بريد حجز إلكتروني أو webhook يبقى النموذج عرضاً تجريبياً ويقول ذلك.

ما يراه الزوار وما لا يرونه

  • أسماء الناقلين وشعاراتهم، الأسعار، أزمنة العبور، الصلاحية وما يشمله السعر.
  • الأسعار التي لا يظهر معها اسم ناقل تُعرض باسم “اختيار <اسم العميل>”، مع شعار العميل.
  • مصادر الأسعار والمنصات لا تُعرض أبداً. تتم إزالتها على خادمنا قبل أن تصل البيانات إلى المتصفح.

الأمان

قفل النطاق. ترد صفحات التطبيق مع Content-Security-Policy: frame-ancestors التي تدرج نطاقات المفتاح فقط، لذلك يرفض المتصفح عرضها في أي مكان آخر. تحمل طلبات البيانات المفتاح ومضيف الصفحة الأب، ويتم رفضها عندما لا يكون المضيف في القائمة. إذا نُسخ مفتاح إلى موقع آخر فلن يعمل هناك.

الحدود. لكل تطبيق على المفتاح حد شهري أو سنوي خاص به، راجع حدود الاستخدام. بالإضافة إلى ذلك، لكل مفتاح سقف أمان قدره 50,000 طلب شهرياً، وسقف قدره 600 طلب في الدقيقة للموقع كله، حتى لا تؤدي طفرة حركة في موقع واحد إلى إبطاء التطبيقات للآخرين، ويمكن رفعه عند الطلب، وحدود معدل لكل زائر ضد إساءة الاستخدام البرمجية. عند تجاوزها يعرض التطبيق رسالة “حاول مرة أخرى” قصيرة ويطلق navo:limit.

الرسائل. يتواصل الإطار والمحمّل عبر postMessage، ويرسل كل طرف فقط إلى الأصل الدقيق للطرف الآخر: الإطار إلى صفحة العميل، والمحمّل إلى navo24.com. لا تذهب تفاصيل البحث أبداً إلى *.

التدوير. إذا تسرّب مفتاح أو تغيّرت ملكية موقع، نصدر مفتاحاً جديداً ويتوقف القديم فوراً عن العمل.

الاختبار قبل الإطلاق

أرسل إلينا نطاق الاختبار مع نطاق الإنتاج، أو localhost:<port> لجهاز المطوّر. يمكن أن يكون كلاهما على المفتاح نفسه.

قائمة التحقق

  1. يرسل العميل الاسم، النطاقات، الشعار، اللون، بريد الحجز الإلكتروني، التطبيقات التي اشتراها، مع تشغيل وضع AI أو إيقافه، والحد لكل تطبيق، واختيارياً webhook ومسارات الصفحات.
  2. ننشيء المفتاح ونرسل المقاطع.
  3. يضيف العميل embed.js والحاويات، أولاً على بيئة الاختبار.
  4. يتحقق العميل: البحث ← التتبّع، الأسعار ← التفاصيل ← الحجز، يصل بريد اختبار، ويفتح رابط مشترك على موقعه. مع CSP صارمة، تحقق من وحدة تحكم المتصفح بحثاً عن navo24.com المحظور.
  5. يضيف العميل نطاق الإنتاج، إذا لم يكن موجوداً في القائمة بعد، وينتقل إلى التشغيل الفعلي.