Integrations
Integrations keep the IntentFlow product index aligned with the merchant's ecommerce platform.
Integration types
| Type | Description | Status |
|---|---|---|
| CSV upload | Manual catalog upload from the dashboard. | Available |
| Hosted feed | Scheduled import from a public or authenticated feed URL. | PLACEHOLDER |
| Platform plugin | Native plugin installed in an ecommerce platform. | PLACEHOLDER |
| Admin API sync | Direct integration with a platform admin API. | PLACEHOLDER |
| Custom backend | Merchant backend pushes catalog changes to IntentFlow. | PLACEHOLDER |
Supported platforms
| Platform | Catalog sync | Widget install | Notes |
|---|---|---|---|
| Shopify | PLACEHOLDER | PLACEHOLDER | Add app, permissions, webhook, and theme-app-extension details. |
| WooCommerce | PLACEHOLDER | PLACEHOLDER | Add WordPress plugin setup and REST credentials. |
| Magento | PLACEHOLDER | PLACEHOLDER | Add module setup and cron behavior. |
| BigCommerce | PLACEHOLDER | PLACEHOLDER | Add app scopes and Script Manager placement. |
| PrestaShop | PLACEHOLDER | PLACEHOLDER | Add module setup details. |
| Drupal Commerce | PLACEHOLDER | PLACEHOLDER | Add module/library setup details. |
Data mapping
Each integration should map platform fields into the product index contract:
| IntentFlow field | Platform source |
|---|---|
external_id | Platform product or variant ID. |
title | Product or variant title. |
category | Product type, category, collection, taxonomy, or best available category label. Required. |
price | Active storefront price. |
url | Public product URL. |
image_url | Primary product image. |
in_stock | Stock availability. |
attributes | Extra searchable facts such as color, size, material, gender, brand, or variation options. |
Send platform-specific facts that can improve suggestions as additional attributes instead of inventing new top-level IntentFlow fields. For example, Shopify option values can map to attributes.color or attributes.size.
Sync behavior
PLACEHOLDER: Define whether each integration is pull-based, webhook-based, scheduled, or hybrid. Include retry, conflict, deletion, variant, multi-currency, and multi-language behavior.
Developer handoff
Integration developers should start with: