Integration Documentation

1. Shopify Integration
2. WordPress Integration
3. WhatsApp Business Integration
4. Instagram DMs Integration
5. Inventory Systems Integration
6. CSV Import
7. URL Import
8. Custom Store Integration

Connect your Shopify store to Towasal for seamless inventory sync, automated product updates, and unified commerce across WhatsApp and Instagram.

Why Connect Shopify?

If you're selling on Shopify, Towasal brings your entire catalog to WhatsApp and Instagram—where your customers already are.

• Automatic sync: Products, prices, variants, and inventory levels update automatically
• Real-time accuracy: Customers never see out-of-stock items—inventory syncs hourly (Gold) or daily (Silver)
• Unified commerce: Manage inventory in Shopify, sell everywhere through Towasal
• No manual work: Set it once, and your catalog stays in sync
• Multi-channel sales: Sell on Shopify, WhatsApp, and Instagram from one inventory source

How It Works

1. Connect Your Store

In your Towasal dashboard, go to Integrations → Shopify. Click "Connect Shopify" and authorize Towasal to access your store data. The connection is secure and uses Shopify's official API.

2. Sync Your Products

Once connected, Towasal automatically imports your products, variants, prices, images, and descriptions. The initial sync typically completes in minutes, depending on catalog size.

3. Automatic Updates

Your catalog stays in sync automatically:

• Gold plan: Hourly sync—inventory updates every hour
• Silver plan: Daily sync—inventory updates once per day
• Bronze plan: Manual upload only (no automatic sync)

4. Start Selling

Your products are now available in WhatsApp and Instagram. Customers can browse, ask questions, and place orders—all with real-time inventory and pricing from Shopify.

What Gets Synced

• Products: All active products from your Shopify catalog
• Variants: Size, color, and other product variants
• Pricing: Current prices, including sale prices
• Inventory: Stock levels and availability status
• Images: Product photos and gallery images
• Descriptions: Product descriptions and metadata
• Collections: Product categories and collections

Plan Requirements

• Gold: Hourly sync, unlimited products, full Shopify integration
• Silver: Daily sync, up to 50 products, full Shopify integration
• Bronze: Manual product upload only (no automatic sync)

To use Shopify integration, you'll need a Silver or Gold plan. Upgrade your plan to enable automatic sync.

Getting Started

1. Sign up for a Silver or Gold plan
2. Go to your Towasal dashboard → Integrations → Shopify
3. Click "Connect Shopify" and authorize the connection
4. Wait for the initial sync to complete (usually 2-5 minutes)
5. Start selling on WhatsApp and Instagram!

Need help? Contact support@towasal.io or use the WhatsApp support button.

Connect Towasal to WordPress/WooCommerce for automated inventory sync and seamless WhatsApp/Instagram commerce.

Why Connect WordPress?

If you're running a WordPress store with WooCommerce, Towasal brings your entire catalog to WhatsApp and Instagram—where your customers already are.

• WooCommerce support: Native integration with WooCommerce stores
• URL import: Import products directly from your WordPress product pages
• Automatic sync: Products, prices, variants, and inventory levels update automatically (Silver & Gold)
• Real-time accuracy: Customers never see out-of-stock items
• Unified commerce: Manage inventory in WordPress, sell everywhere through Towasal

How It Works

Option 1: WooCommerce API Integration

For stores using WooCommerce, connect via REST API. In your Towasal dashboard, go to Integrations → WordPress. Enter your WordPress site URL and WooCommerce API credentials. Towasal will automatically sync your products, variants, prices, and inventory.

Option 2: URL Import

Don't have WooCommerce? No problem. Use URL import to add products from any WordPress product page. Simply paste the product URL, and Towasal extracts product details, images, and pricing automatically.

Automatic Updates

Once connected, your catalog stays in sync:

• Gold plan: Hourly sync—inventory updates every hour
• Silver plan: Daily sync—inventory updates once per day
• Bronze plan: Manual URL import only (no automatic sync)

Setting Up WooCommerce API

1. In WordPress admin, go to WooCommerce → Settings → Advanced → REST API
2. Click "Add key" to create a new API key
3. Set permissions to "Read" (read-only access is sufficient)
4. Copy the Consumer Key and Consumer Secret
5. In Towasal dashboard, go to Integrations → WordPress
6. Enter your WordPress site URL and API credentials
7. Click "Connect" and wait for the initial sync

Plan Requirements

• Gold: Hourly sync, unlimited products, full WooCommerce integration
• Silver: Daily sync, up to 50 products, WooCommerce integration + URL import
• Bronze: URL import only (no automatic sync)

To use automatic WooCommerce sync, you'll need a Silver or Gold plan. Upgrade your plan to enable automatic sync.

Connect your WhatsApp Business API to enable automated sales and support on WhatsApp.

Why WhatsApp Business?

WhatsApp is where your customers shop. Over 2 billion people use WhatsApp, and in many markets, it's the preferred channel for customer service and commerce.

• 24/7 availability: Your AI agent never sleeps—responds to customers anytime, day or night
• Fast responses: Average response time under 60 seconds vs. hours for manual support
• Bilingual support: English and Arabic conversations feel natural and localized
• Voice & text: Customers can speak or type—the bot understands both (Silver & Gold)
• Human handoff: Seamlessly transfer complex queries to your team with one tap
• Order management: Create orders, send confirmations, and track status—all in WhatsApp

How It Works

1. Connect Your WhatsApp Business Account

In your Towasal dashboard, go to Integrations → WhatsApp Business. We'll guide you through connecting your WhatsApp Business API account. You'll need a verified WhatsApp Business number and API access.

2. Configure Your AI Agent

Set up your AI sales agent with your products, policies, and brand voice. Upload PDFs for document training, configure product catalogs, and customize responses.

3. Start Receiving Messages

Once connected, customers can message your WhatsApp number. The AI agent responds automatically, answers questions, shows products, and processes orders.

4. Human Handoff When Needed

For complex queries or when customers request it, transfer the conversation to a human agent. Your team can take over seamlessly from the Towasal dashboard.

Features Available

• Product browsing: Customers can search, browse, and view products with images and prices
• Order creation: AI agent creates orders automatically and sends order IDs
• Inventory sync: Real-time stock levels so customers never see out-of-stock items
• Voice notes: Customers can send voice messages—bot understands and responds (Silver & Gold)
• Multilingual: Seamless switching between English and Arabic in the same conversation
• Wishlist: Customers can save products for later purchase
• Order tracking: Customers can check order status and receive updates
• Payment links: Share payment links directly in chat (with custom gateway integration)

Plan Requirements

WhatsApp Business integration is available on all plans:

• Bronze: 1 WhatsApp agent per number, text-only responses, 200 conversations
• Silver: 1 WhatsApp agent per number, text & voice responses, 500 conversations
• Gold: 1 WhatsApp agent per number, text & voice responses, 2000 conversations, team management

All plans support human handoff and bilingual (English/Arabic) conversations.

Setting Up WhatsApp Business API

To connect Towasal to WhatsApp Business API, you'll need:

1. WhatsApp Business Account: A verified WhatsApp Business number
2. Meta Business Account: Access to Meta Business Manager
3. API Credentials: WhatsApp Business API access token and phone number ID
4. Webhook Configuration: We'll help you set up webhooks for message delivery

Our onboarding team guides you through the entire setup process. Contact support@towasal.io for assistance.

Connect your Instagram Business account to sell directly through Instagram Direct Messages.

Why Instagram DMs?

Instagram is where customers discover products. When they see your posts or stories, they want to buy—and Instagram DMs is where they reach out.

• 24/7 availability: Your AI agent never sleeps—responds to DMs anytime, day or night
• Fast responses: Average response time under 60 seconds vs. hours for manual replies
• Product carousels: Show multiple products with images in Instagram's native carousel format
• Bilingual support: English and Arabic conversations feel natural and localized
• Seamless experience: Customers stay in Instagram—no need to switch apps
• Order management: Create orders, send confirmations, and track status—all in Instagram DMs

How It Works

1. Connect Your Instagram Business Account

In your Towasal dashboard, go to Integrations → Instagram DMs. We'll guide you through connecting your Instagram Business or Creator account via Meta's Graph API.

2. Configure Your AI Agent

Set up your AI sales agent with your products, policies, and brand voice. Upload PDFs for document training, configure product catalogs, and customize responses for Instagram's format.

3. Start Receiving DMs

Once connected, customers can message your Instagram account. The AI agent responds automatically, shows products in carousels, answers questions, and processes orders.

4. Human Handoff When Needed

For complex queries or when customers request it, transfer the conversation to a human agent. Your team can take over seamlessly from the Towasal dashboard.

Features Available

• Product carousels: Show multiple products with images in Instagram's native carousel format
• Product browsing: Customers can search, browse, and view products with images and prices
• Order creation: AI agent creates orders automatically and sends order IDs
• Inventory sync: Real-time stock levels so customers never see out-of-stock items
• Multilingual: Seamless switching between English and Arabic in the same conversation
• Wishlist: Customers can save products for later purchase
• Order tracking: Customers can check order status and receive updates
• Payment links: Share payment links directly in DMs (with custom gateway integration)

Plan Requirements

Instagram DMs integration is available on all plans:

• Bronze: 1 Instagram agent per account, text-only responses, 200 conversations
• Silver: 1 Instagram agent per account, text & voice responses, 500 conversations
• Gold: 1 Instagram agent per account, text & voice responses, 2000 conversations, team management

All plans support human handoff and bilingual (English/Arabic) conversations.

Sync your inventory management system with Towasal for real-time stock updates.

Why Sync Inventory?

Accurate inventory is critical for customer satisfaction. When customers see out-of-stock items or incorrect prices, they lose trust and you lose sales.

• Real-time accuracy: Customers never see out-of-stock items—inventory syncs automatically
• Multi-channel consistency: Same inventory across WhatsApp, Instagram, and your store
• Reduced errors: No manual updates means fewer mistakes and fewer refunds
• Time savings: Set it once, and inventory stays in sync automatically
• Better customer experience: Customers get accurate availability and pricing instantly

How It Works

Option 1: CSV Upload

Upload a CSV file with your products, prices, and inventory levels. Towasal imports the data and keeps it updated. You can schedule regular CSV uploads or do it manually.

Option 2: API Integration

Connect your inventory system via REST API. Towasal pulls product data, prices, and stock levels automatically on a schedule (hourly for Gold, daily for Silver).

Option 3: Custom Integration

For custom inventory systems, we can build a custom integration. Contact support@towasal.io to discuss your requirements.

Automatic Updates

Once connected, your inventory stays in sync:

• Gold plan: Hourly sync—inventory updates every hour
• Silver plan: Daily sync—inventory updates once per day
• Bronze plan: Manual CSV upload only (no automatic sync)

What Gets Synced

• Product SKUs: Unique product identifiers
• Product names: Product titles and descriptions
• Prices: Regular prices, sale prices, and currency
• Stock levels: Available quantity for each product/variant
• Variants: Size, color, and other product variations
• Availability status: In stock, out of stock, low stock
• Product images: Product photos and gallery images

Plan Requirements

• Gold: Hourly sync, unlimited products, API integration + CSV upload
• Silver: Daily sync, up to 50 products, CSV upload + URL import
• Bronze: Manual CSV upload only (no automatic sync), up to 25 products

To use automatic inventory sync, you'll need a Silver or Gold plan. Upgrade your plan to enable automatic sync.

Import your products to Towasal via CSV files. Perfect for stores that manage inventory in spreadsheets or need a simple way to bulk upload products.

Why Use CSV Import?

CSV import is the simplest way to get your products into Towasal, especially if you're already managing inventory in spreadsheets.

• Easy to use: Export from Excel, Google Sheets, or any spreadsheet tool
• Bulk upload: Import hundreds or thousands of products at once
• Flexible: Works with any inventory system that can export CSV
• Quick updates: Update prices or inventory by uploading a new CSV
• No API needed: Perfect for stores without API access
• Available on all plans: Bronze, Silver, and Gold all support CSV import

How It Works

1. Prepare Your CSV File

Export your products from your inventory system or create a CSV file with your product data. Include columns for SKU, Product Name, Price, Stock Quantity, and other details.

2. Upload to Towasal

In your Towasal dashboard, go to Integrations → CSV Import. Click "Upload CSV" and select your file. Towasal validates the format and shows a preview before importing.

3. Review & Import

Review the preview to ensure all products are correct. Click "Import" to add products to your catalog. The import typically completes in seconds to minutes, depending on file size.

4. Update Anytime

To update prices or inventory, export a new CSV with updated values and upload it again. Towasal matches products by SKU and updates existing products.

CSV Format Requirements

Required Columns:

• SKU: Unique product identifier (used to match products on updates)
• Product Name: Product title
• Price: Product price (numeric, no currency symbols)
• Stock Quantity: Available inventory (numeric)

Optional Columns:

• Description: Product description
• Image URL: Link to product image
• Variant: Size, color, or other variant name
• Category: Product category
• Sale Price: Discounted price (if on sale)
• Currency: Currency code (e.g., USD, KWD)

File Requirements:

• Format: CSV (comma-separated values)
• Encoding: UTF-8
• Max file size: 10MB (typically supports 10,000+ products)
• First row: Column headers

Plan Requirements

CSV import is available on all plans:

• Bronze: Manual CSV upload, up to 25 products
• Silver: CSV upload, up to 50 products, can be used with daily store sync
• Gold: CSV upload, up to 100 products, can be used with hourly store sync

CSV import works alongside other import methods. You can use CSV for some products and API sync for others.

Import products directly from any website URL. Towasal automatically extracts product information.

Why Use URL Import?

URL import is the fastest way to add products to Towasal when you don't have API access or CSV files ready.

• Quick and easy: Just paste a product URL—no formatting or file preparation needed
• Automatic extraction: Towasal extracts product details, images, and prices automatically
• Works with any website: Compatible with most e-commerce platforms and custom stores
• Perfect for testing: Great for adding a few products to test Towasal before bulk import
• No API required: Works even if your store doesn't have an API
• Available on Silver & Gold: Use alongside CSV import and API sync

How It Works

1. Get Your Product URL

Copy the URL of any product page from your website. This could be from Shopify, WordPress, WooCommerce, or any custom store.

2. Paste in Towasal

In your Towasal dashboard, go to Integrations → URL Import. Paste the product URL and click "Import."

3. Automatic Extraction

Towasal automatically visits the URL and extracts:

• Product name and title
• Price (regular and sale price if available)
• Product images
• Description and details
• Variants (if available)
• Stock status (if visible on the page)

4. Review & Add

Review the extracted data, make any adjustments needed, and click "Add Product." The product is now available in your Towasal catalog.

What Gets Extracted

• Product Name: Main product title
• Price: Regular price and sale price (if available)
• Images: Product photos and gallery images
• Description: Product description and details
• Variants: Size, color, and other options (if structured on the page)
• Stock Status: In stock, out of stock, or low stock (if visible)
• SKU: Product SKU or identifier (if available)

Plan Requirements

URL import is available on Silver and Gold plans:

• Gold: Unlimited URL imports, can be used alongside hourly API sync
• Silver: URL import supported, can be used alongside daily API sync
• Bronze: Not available (use CSV import or manual product upload instead)

URL import works alongside other import methods. You can use URL import for some products and API sync or CSV for others.

Connect Towasal to your custom e-commerce store or inventory system with a tailored integration.

Why Custom Integration?

If you're running a custom e-commerce platform, legacy system, or proprietary store, a custom integration ensures Towasal works seamlessly with your setup.

• Tailored to your system: Integration built specifically for your store architecture
• Works with any platform: Legacy systems, custom builds, or proprietary solutions
• Full feature access: All Towasal features available through custom integration
• Ongoing support: Dedicated support for your custom integration
• Future-proof: Integration evolves with your system
• Enterprise-ready: Built for scale and reliability

How It Works

1. Consultation

Contact our team to discuss your store architecture, data structure, and integration requirements. We'll assess your system and propose an integration approach.

2. Development

Our team builds a custom integration that connects Towasal to your store. This may involve:

• REST API integration
• Database connection (with proper security)
• Webhook setup
• Custom data mapping
• Authentication and security configuration

3. Testing

We test the integration thoroughly in a staging environment to ensure data accuracy, sync reliability, and feature compatibility.

4. Deployment

Once tested, we deploy the integration to production. Your products, inventory, and orders are now synced with Towasal.

5. Ongoing Support

We provide ongoing support and maintenance for your custom integration, ensuring it continues to work as your system evolves.

What We Can Integrate

• Custom e-commerce platforms: Proprietary or in-house built stores
• Legacy systems: Older platforms that don't have modern APIs
• Database systems: Direct database connections (with proper security)
• ERP systems: Enterprise resource planning systems
• Inventory management: Custom inventory or warehouse systems
• Multi-channel platforms: Systems that manage multiple sales channels

If your system can export data or has any API access, we can likely integrate it.

Plan Requirements

Custom integrations are typically available for:

• Gold plan customers: Custom integrations are included with Gold plans
• Enterprise customers: Custom integrations available for enterprise contracts
• Silver customers: May be available on a case-by-case basis

Contact sales@towasal.io to discuss custom integration options for your store.

If you need assistance with any integration or have questions about setting up Towasal, we're here to help:

• Contact support@towasal.io for technical support
• Use the WhatsApp support button on any page for instant help
• Visit our Help Center for additional resources
• Check out our Video Tutorials for step-by-step guides