Zid Integration
Connect your Zid store to Orki so your AI agents can access your product catalog and assist customers with shopping in Arabic and English.
Path: Products > Sources > Zid
What is Zid?
Zid is a leading e-commerce platform in the Middle East and North Africa (MENA) region. It's particularly popular in Saudi Arabia and the Gulf countries, offering Arabic-first e-commerce solutions.
What This Integration Does
Once connected, your AI agents can:
- Search your Zid product catalog
- Recommend products in Arabic or English
- Send product carousels on WhatsApp
- Access real-time pricing and availability
Prerequisites
Before connecting Zid, ensure you have:
- A Zid store
- Access to the Zid Partner dashboard (partner.zid.sa)
- API access enabled in your Zid plan
Connecting Zid
The connection uses credentials you copy from the Zid Partner dashboard — there is no OAuth authorize step and no redirect to Zid.
Step 1: Open the Zid Source
Go to Products → Sources → Zid in the Orki sidebar and click "Add Integration". A stepper guides you through the process.
Step 2: Copy Your Credentials from Zid
In the Zid Partner dashboard (partner.zid.sa), go to Settings → API Integrations → Direct Integration Info and copy:
| Field | Description |
|---|---|
| Store ID | Your Zid store identifier |
| Store URL | Your store's URL |
| Manager Token | The API token used to read your catalog |
Step 3: Paste into Orki
Paste the Store ID, Store URL, and Manager Token into the Orki form and save the integration.
Step 4: Wait for Initial Sync
Orki will automatically begin syncing your products. This may take a few minutes depending on your catalog size.
Step 5: Test in Playground
Go to Playground and test product searches in both Arabic and English to verify the integration.
What Gets Synced
| Data | Synced | Notes |
|---|---|---|
| Product name (Arabic) | Yes | Primary language |
| Product name (English) | Yes | If available in Zid |
| Description (Arabic) | Yes | Full product description |
| Description (English) | Yes | If available in Zid |
| Price | Yes | In your store's currency (SAR, AED, etc.) |
| Images | Yes | All product images |
| Variants | Yes | Size, color, etc. |
| Inventory | Yes | Stock levels |
| SKU | Yes | If available |
| Categories | Yes | For organization |
Bilingual Support
Zid stores often have bilingual content, which Orki fully supports:
Arabic Content
- Product names and descriptions in Arabic sync correctly
- AI can respond in Arabic about products
- RTL (right-to-left) text is handled properly
English Content
- English translations sync if available in Zid
- AI can switch between Arabic and English based on customer language
Example Conversation (Arabic)
Customer: عندكم شنط جلد؟
AI: نعم! عندنا مجموعة متنوعة من الشنط الجلدية. تفضل بعض الخيارات: [Sends product carousel]
Example Conversation (English)
Customer: Do you have leather bags?
AI: Yes! We have a great selection of leather bags. Here are some options: [Sends product carousel]
Sync Behavior
Automatic Sync
Products sync automatically:
- When you first connect
- Periodically throughout the day
- When product changes are detected in Zid
Manual Sync
To force an immediate sync:
- Go to Products → Sources
- Find the Zid integration
- Click "Sync"
Managing Synced Products
Viewing Products
Zid products appear in your Products grid with:
- Source column showing "Zid"
- Arabic and English names (if available)
- All synced product information
Editing Products
Zid products are read-only in Orki. To update:
- Make changes in your Zid dashboard
- Wait for automatic sync, or trigger manual sync
- Updated data appears in Orki
Product Status
Control whether Zid products are available to AI:
- Active: AI can search and recommend this product
- Inactive: Hidden from AI searches
Toggle status directly in Orki — this doesn't affect your Zid store.
Managing the Integration
On Products → Sources, each Zid integration offers:
| Action | Description |
|---|---|
| Edit | Update the Store ID, Store URL, or Manager Token |
| Enable/Disable toggle | Temporarily turn the integration on or off |
| Sync | Trigger an immediate product sync |
| Delete Integration | Remove the integration — a warning explains that synced data is removed |
- Synced products are removed from Orki
- AI can no longer access Zid products
- Your Zid store is not affected
Troubleshooting
Products Not Appearing
- Verify the connection is active
- Check that products are published in Zid
- Try a manual sync
- Ensure products aren't hidden or draft status
Arabic Text Not Displaying
- Verify your browser supports Arabic text
- Check that product data exists in Arabic in Zid
- Clear browser cache and refresh
Connection Lost
If syncing stops working:
- Verify the Manager Token is still valid in the Zid Partner dashboard
- Use Edit to update the credentials if they changed
- Trigger a Sync and wait for products to sync again
Missing English Translations
English translations only appear if they exist in your Zid store. Add translations in Zid to have them sync to Orki.
Next Steps
- Products Overview — Learn about managing products
- Connect Shopify — Add another e-commerce platform
- AI Agents — Configure how agents recommend products