BadgerFy.ai Docs

Integrations

BadgerFy.ai integrates with popular e-commerce platforms to automatically import product catalogs and order data. Once connected, you can import data directly from your store without manual file exports.

📦 Supported Platforms

Currently, we support Shopify, BigCommerce, and WooCommerce. Each integration allows you to import both product/promo data and order data for use with your agents.

Setting Up Integrations

Integrations are configured at the organization level. Navigate to Organization Settings → Integrations in your dashboard to add a new integration. Each platform has different authentication requirements outlined below.

Shopify

Connect your Shopify store to import products, variants, and order history. The integration uses Shopify's Admin API with secure access token authentication.

Requirements

  • Store Domain: Your Shopify store URL (e.g., your-store.myshopify.com)
  • Admin API Access Token: Generated from a custom app in your Shopify admin

Setup Steps

  1. Log in to your Shopify Admin
  2. Go to Settings → Apps and sales channels → Develop apps
  3. Click Create an app and give it a name (e.g., "BadgerFy Integration")
  4. In your new app, go to Configuration and click Configure Admin API scopes
  5. Enable the following scopes:
    • read_products — For product/promo data imports
    • read_orders — For order data imports
    • read_price_rules — For discount/promotion information (optional)
  6. Click Save, then go to API credentials
  7. Click Install app to generate your access token
  8. Copy the Admin API access token (you'll only see it once)
  9. In BadgerFy.ai, add a new Shopify integration with your store domain and access token
⚠️ Keep Your Token Secure

Your Admin API access token provides access to your store data. Never share it publicly or commit it to version control. BadgerFy.ai encrypts and securely stores your token.

Data Imported

  • Products: Title, handle (URL), variants, prices, images, categories (product type). Imported data is converted to the product-promo schema: one record per product with a variants array (see Product & Promotions Data).
  • Orders: Order ID, date, customer info (anonymized), line items, totals
  • Promotions: Active price rules and discount codes (when available)

BigCommerce

Connect your BigCommerce store to import products and order history. The integration uses BigCommerce's REST API with API account authentication.

Requirements

  • Store Hash: Your BigCommerce store identifier (found in your store URL)
  • API Access Token: Generated from an API account in your BigCommerce admin

Setup Steps

  1. Log in to your BigCommerce Admin
  2. Go to Settings → API → API Accounts
  3. Click Create API Account → Create V2/V3 API Token
  4. Give the account a name (e.g., "BadgerFy Integration")
  5. Set the following OAuth scopes:
    • Products — Read-only (for product/promo data)
    • Orders — Read-only (for order data)
  6. Click Save to generate credentials
  7. Copy the Access Token and note your Store Hash from the API Path
  8. In BadgerFy.ai, add a new BigCommerce integration with your store hash and access token

Data Imported

  • Products: Name, custom URL, variants, prices, sale prices, images, categories. Converted to the product-promo schema (one product per record with a variants array).
  • Orders: Order ID, date, line items with product details, totals

WooCommerce

Connect your WooCommerce store to import products and order history. The integration uses the WooCommerce REST API with consumer key/secret authentication.

Requirements

  • Store URL: Your WordPress site URL where WooCommerce is installed
  • Consumer Key: Generated from WooCommerce API settings
  • Consumer Secret: Generated alongside the consumer key

Setup Steps

  1. Log in to your WordPress admin
  2. Go to WooCommerce → Settings → Advanced → REST API
  3. Click Add key
  4. Enter a description (e.g., "BadgerFy Integration")
  5. Set the user to an admin account
  6. Set permissions to Read
  7. Click Generate API key
  8. Copy both the Consumer key and Consumer secret
  9. In BadgerFy.ai, add a new WooCommerce integration with your store URL and API credentials
⚠️ Self-Hosted WooCommerce

If your WooCommerce site is self-hosted, ensure that external API traffic is not blocked by your hosting provider, firewall, or security plugins. Common issues include:

  • Firewall rules: Allow incoming requests from BadgerFy.ai servers
  • Security plugins: Whitelist API endpoints in plugins like Wordfence or Sucuri
  • REST API disabled: Some themes or plugins disable the WooCommerce REST API
  • SSL/HTTPS: Ensure your site uses HTTPS for secure API communication

Data Imported

  • Products: Name, slug (URL), variations, prices, sale prices, images, categories. Converted to the product-promo schema (one product per record with a variants array).
  • Orders: Order ID, date, line items with product details, totals

Using Integrations

Once an integration is connected, you can use it in two ways:

Import Data Tab

In any product-promo or order-data data source, the Import Data tab lets you pull fresh data from your connected integration. Select the integration, start the import, preview the results, and confirm to add the data to your source.

Update Existing Files

For files already in your data source, use the Update With Integration button to sync fresh data while keeping the same file reference name. This is useful for keeping your product catalog or order history up to date.

Best Practices

  • Regular Syncs: For product-promo data, sync regularly to keep promotions and pricing current. Stale data can lead to displaying incorrect offers.
  • Review Before Confirming: Always preview imported data before confirming the upload. Check that product URLs, prices, and categories look correct.
  • Use Consumer API for Automation: Pro and Business users can automate data updates using the Consumer API instead of manual imports.
  • Limit API Scopes: Only grant the minimum required permissions when creating API credentials for your integrations.
🔗 Related Documentation