1. Introduction
Sanal AI
  • Introduction
    • 💬 Sanal AI Integration
    • 🤝 Overview
    • 🚀 Getting Started
    • 🛠️ Integration Flow
    • ✅ Checklist
    • 🔌 Bridge Protocol
  • Data Sync
    • 🛠️ Data Sync
    • 📐 Data Layout
    • 🏪 Merchants
    • 📂 Categories
    • 🏷️ Items
    • 🛒 Products
    • 📦 Inventory
    • 👤 Customers
    • 🧾 Orders
    • 🧾 Variants & Combinations
  • API Requirements
    • 🔌 API Requirements
    • API: `syncMerchants`
    • API: `syncCategories`
    • API: `syncItems`
    • API: `syncProducts`
    • API: `syncInventory`
    • API: `syncCustomers`
    • API: `syncOrders`
  1. Introduction

🚀 Getting Started

🔍 Before you begin#

Your app must already have:
1.
Authenticated with the Sanal platform and hold a valid user ID and auth token (JWT or session token) to use for embedding Chat AI widget.
2.
Products Listing — items, quantities, variants, and the active merchant ID, these are standard features in your app.
3.
App navigation — checkout, product detail, merchant detail, and delivery addresses.
The widget does not show a login screen. It uses the credentials you send after load.

🔗 Sanal AI Widget URL#

Use the URL provided to integrate with widget in your environment:
https://widget.sanal.ai/widget?mode=embedded&lang=en
Query paramValuesDescription
modeembeddedEmbedded / host-app mode
langen, arUI language

🔄 How to embed our Widget#

You can load our widget using the URL in:
1.
A WebView for Flutter, React Native or
2.
An iframe for Web
See the Integration Flow on more details after the widget loads.
Previous
🤝 Overview
Next
🛠️ Integration Flow
Built with