Integrations & Connectors

Supported Platforms

Setting Up Shopify

The Shopify integration uses a custom private app (Admin API). Here's how to set it up:

1. 1In your Shopify Admin, go to Settings → Apps and sales channels → Develop apps. If prompted, enable custom app development for your store.
2. 2Click Create an app. Name it "AvidiaTech" for easy identification.
3. 3Under Configuration → Admin API access scopes, enable the following:
   • read_products and write_products
   • read_product_listings
   • write_metafields (for SEO fields)
4. 4Click Save → Install app → Install. Copy the Admin API access token (shown once — save it securely).
5. 5In AvidiaTech, go to Dashboard → Integrations → Add Integration → Shopify. Enter your store URL (e.g., mystore.myshopify.com) and paste your Admin API access token. Click Test Connection.

Setting Up BigCommerce

1. 1In BigCommerce Admin, go to Advanced Settings → API Accounts → Create API Account → V2/V3 API Token.
2. 2Name the account "AvidiaTech". Under OAuth Scopes, enable: Products: Modify and Content: Modify.
3. 3Save and download the credentials file. You'll need your Store Hash, Client ID, and Access Token.
4. 4In AvidiaTech, go to Integrations → Add → BigCommerce and enter all three credentials. Your store hash looks like abc123xyz (visible in your BigCommerce API URL).

Setting Up WooCommerce

1. 1In WordPress Admin, go to WooCommerce → Settings → Advanced → REST API → Add Key.
2. 2Set the description to "AvidiaTech", select your admin user, and set permissions to Read/Write.
3. 3Generate the key. Copy the Consumer Key and Consumer Secret (shown once).
4. 4In AvidiaTech, go to Integrations → Add → WooCommerce. Enter your store URL (e.g., https://mystore.com), Consumer Key, and Consumer Secret.

Field Mapping

AvidiaTech can push the following fields to each platform. By default, all available fields are pushed. Disable specific fields in the integration settings if you manage those fields directly in your store.

Sync Frequency

Choose how and when AvidiaTech pushes data to your platform:

Sync Status and Error Handling

Each product shows a sync status badge in the product list: Synced, Pending, Failed, or Never Synced.

Failed syncs are retried automatically 3 times with exponential backoff. If all retries fail, the product is flagged with the error code. Common causes:

• Product was deleted from the platform (404 error)
• API credentials expired or were revoked
• Rate limit hit on the platform side (429 error — retried automatically)
• Platform field validation error (e.g., title too long for platform limits)

View the full sync log for any product under Product Detail → Sync History.

Webhook Integration for Real-Time Sync

For real-time, event-driven sync, use AvidiaTech webhooks. Configure a webhook endpoint on your platform or middleware (Zapier, Make, n8n) to receive pipeline completion events and trigger your own sync logic.

See the Webhooks guide for event types and payload format.

Integration API

// List integrations
GET https://app.avidiatech.com/api/v1/integrations
Authorization: Bearer <your-api-key>

// Response
{
  "integrations": [
    {
      "id": "int_01HX5MN2QR4VP8XWBCJT5GA",
      "platform": "shopify",
      "store_url": "mystore.myshopify.com",
      "status": "connected",
      "last_sync": "2024-03-15T09:00:00Z"
    }
  ]
}

// Trigger a sync for a specific product
POST https://app.avidiatech.com/api/v1/integrations/int_01HX5MN2QR4VP8XWBCJT5GA/sync
{
  "ingestion_ids": ["ing_01HX4K2QZRP7W9VMBGT3DENF8"]
}

// Test connection
POST https://app.avidiatech.com/api/v1/integrations/int_01HX5MN2QR4VP8XWBCJT5GA/test
// Response: { "status": "ok", "latency_ms": 142 }