emporiqa

The Emporiqa module connects your Drupal Commerce store to the Emporiqa chat assistant. It synchronizes your products, pages, and policies in real time via webhooks, and embeds a chat widget that lets customers ask questions about your inventory, get product recommendations, manage their cart, and track orders.

Features

• Chat widget: automatically embedded on all pages with language and user awareness
• Real-time product sync: products and variations are synced to Emporiqa on create, update, and delete
• Page and policy sync: sync any content type (shipping policies, FAQs, about pages, etc.) using Drupal's native display mode system — you control exactly which fields are sent
• In-chat cart: customers can add to cart, update quantities, remove items, and check out directly from the chat widget
• Order tracking: built-in API endpoint for customers to check order status via the chat, with hook-based extensibility for custom order systems
• Conversion tracking: order completion events sent to Emporiqa for chat-attributed revenue reporting
• Multi-language support: syncs content in all configured languages
• Media support: supports image fields and Media references on both products and variations
• Stock and availability: works with Commerce Stock, custom stock fields, or falls back to publish status
• Admin UI sync: trigger full sync from the admin interface with a progress bar and live product/page counts
• Field auto-detection: on install, automatically discovers your category, brand, image, stock, and attribute fields
• Drush commands: emporiqa:sync-products, emporiqa:sync-pages, emporiqa:sync-all, and emporiqa:test-connection for bulk operations
• Extensibility: hooks to control which entities sync (hook_emporiqa_entity_sync_alter), modify payloads (hook_emporiqa_data_alter), intercept cart operations (hook_emporiqa_cart_alter), and customize order tracking (hook_emporiqa_order_tracking_alter)

Post-Installation

1. Go to Administration → Configuration → Web services → Emporiqa (/admin/config/services/emporiqa)
2. Enter your Store ID and Webhook Secret (found in your Emporiqa dashboard under Store Settings → Integration)
3. Click Test Connection to verify the webhook link
4. Review the auto-detected Field Mapping (the module pre-populates category, brand, image, and stock fields on install)
5. For page/policy sync: go to Structure → Content types → [Your type] → Manage display, enable the Emporiqa tab, and configure which fields to include
6. Run initial sync: use the Sync tab in the admin UI, or run drush emporiqa:sync-all from the command line

The chat widget appears automatically once the Store ID is configured.

Additional Requirements

• Drupal Commerce 2.x or 3.x
• PHP 8.1 or higher
• An Emporiqa account

Recommended modules/libraries

• Commerce Stock: enables stock level tracking for accurate product availability
• Drush: provides CLI commands for manual sync operations and connection testing

Try It

Create a free sandbox store to test the full integration before going live. Sandbox stores include 100 products, 20 pages, and full chat widget functionality. No credit card required.

Supporting this Module

Development is maintained by Emporiqa. For support, contact [email protected] or file an issue in the project queue.

Community Documentation

• Drupal Integration Guide