---
title: "Shopify کنیکٹر"
description: "گاہکوں، آرڈرز، پروڈکٹس، اور کارٹ ایونٹس کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Shopify انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/ecommerce/shopify/
markdown: https://tajo.io/ur/docs/connectors/ecommerce/shopify.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# Shopify کنیکٹر

کنیکٹر کی حیثیت: زیرِ تیاری تیار ہو رہا ہے۔ ابھی تصدیق نہیں ہوئی۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

مکمل گاہک ڈیٹا سنکرونائزیشن، ترک شدہ کارٹ بحالی، اور خودکار مارکیٹنگ مہمات کے لیے اپنے Shopify اسٹور کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Shopify |
| **زمرہ** | ای-کامرس |
| **سیٹ اپ کی پیچیدگی** | آسان |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | گاہک، آرڈرز، پروڈکٹس، کارٹس، ایونٹس |
| **دستیاب اسکلز** | 12 |

## خصوصیات

- **ریئل ٹائم گاہک سنک** - گاہک کا ڈیٹا فوری طور پر Brevo رابطوں میں سنک ہوتا ہے
- **آرڈر ٹریکنگ** - خریداری کے بعد کے فلوز کے لیے آرڈر ایونٹس
- **پروڈکٹ کیٹلاگ سنک** - سفارشات کے لیے پروڈکٹس دستیاب
- **کارٹ ترک کرنا** - ترک شدہ کارٹس کو ٹریک اور بحال کریں
- **براؤز رویہ** - پیج ویو اور پروڈکٹ دلچسپی کی ٹریکنگ
- **ملٹی اسٹور سپورٹ** - متعدد Shopify اسٹورز کو منسلک کریں

## شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. ایڈمن رسائی کے ساتھ Shopify اسٹور
2. API رسائی کے ساتھ Brevo اکاؤنٹ
3. Tajo اکاؤنٹ

## انسٹالیشن

### آپشن 1: Shopify App Store (تجویز کردہ)

1. [Shopify App Store میں Tajo ایپ](https://apps.shopify.com/tajo) پر جائیں
2. “Add app” پر کلک کریں
3. درخواست کردہ اجازتیں دیں
4. اپنا Brevo اکاؤنٹ منسلک کریں

### آپشن 2: دستی انسٹالیشن

#### مرحلہ 1: Shopify ایپ بنائیں

1. اپنے Shopify ایڈمن پر جائیں → Settings → Apps and sales channels
2. “Develop apps” → “Create an app” پر کلک کریں
3. اسے “Tajo Integration” کا نام دیں

#### مرحلہ 2: API اسکوپس ترتیب دیں

یہ اسکوپس فعال کریں:

```
read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags
```

#### مرحلہ 3: ایپ انسٹال کریں

```bash
# Using Tajo CLI
tajo connectors install shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY \
  --api-secret $SHOPIFY_API_SECRET
```

#### مرحلہ 4: ویب ہُکس ترتیب دیں

Tajo خود بخود یہ ویب ہُکس رجسٹر کرتا ہے:

| Webhook | مقصد |
| --- | --- |
| `customers/create` | نیا گاہک سنک |
| `customers/update` | گاہک ڈیٹا تبدیلیاں |
| `customers/delete` | گاہک کو ہٹانا |
| `orders/create` | آرڈر پلیس ایونٹس |
| `orders/updated` | آرڈر اسٹیٹس تبدیلیاں |
| `checkouts/create` | کارٹ بنایا گیا |
| `checkouts/update` | کارٹ اپ ڈیٹ ہوا |

## تشکیل

### بنیادی سیٹ اپ

```yaml
connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_version: "2024-01"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false  # Optional

    # List assignment
    lists:
      all_customers: 5
      buyers: 6
      abandoned_cart: 7
```

### فیلڈ میپنگ

Shopify فیلڈز کو Brevo رابطہ خصوصیات پر میپ کریں:

#### طے شدہ میپنگز

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | گاہک کا ای میل (منفرد شناخت کنندہ) |
| `first_name` optional | string | FIRSTNAME خصوصیت پر میپ ہوتا ہے |
| `last_name` optional | string | LASTNAME خصوصیت پر میپ ہوتا ہے |
| `phone` optional | string | WhatsApp/SMS کے لیے SMS خصوصیت پر میپ ہوتا ہے |
| `accepts_marketing` optional | boolean | سبسکرپشن کی حالت کو کنٹرول کرتا ہے |
| `orders_count` optional | integer | آرڈرز کی کل تعداد |
| `total_spent` optional | number | لائف ٹائم گاہک ویلیو |
| `tags` optional | array | Shopify سے گاہک ٹیگز |

#### کسٹم خصوصیت میپنگ

```yaml
field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  last_order_date: LAST_ORDER_DATE

  # Custom fields
  customer_type: CUSTOMER_TYPE
  preferred_language: LANGUAGE
  loyalty_tier: VIP_TIER

  # Computed fields
  average_order_value: AOV
  days_since_last_order: RECENCY
```

### پروڈکٹ سنک

ای میل سفارشات کے لیے پروڈکٹس سنک کریں:

```yaml
sync:
  products:
    enabled: true
    include_variants: true
    include_images: true
    categories_as_tags: true

    # Filter products
    filter:
      status: active
      exclude_tags: ["hidden", "wholesale-only"]
```

### انوینٹری ٹریکنگ

اسٹاک لیول سنکرونائزیشن کو فعال کریں:

```yaml
sync:
  inventory:
    enabled: true
    low_stock_threshold: 10
    out_of_stock_events: true
```

## ایونٹس

### گاہک ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `customer_created` | نیا گاہک سائن اپ | ویلکم سیریز |
| `customer_updated` | پروفائل تبدیلیاں | ڈیٹا سنک |
| `customer_tags_added` | ٹیگز تفویض کیے گئے | سیگمنٹ اپ ڈیٹس |

### آرڈر ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `order_placed` | چیک آؤٹ مکمل | آرڈر کی تصدیق |
| `order_fulfilled` | آرڈر بھیج دیا گیا | شپنگ نوٹیفکیشن |
| `order_cancelled` | آرڈر منسوخ | منسوخی ای میل |
| `order_refunded` | رقم کی واپسی پروسیس ہوئی | واپسی کی تصدیق |

### کارٹ ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `cart_created` | کارٹ میں اشیاء شامل کی گئیں | براؤز ٹریکنگ |
| `cart_updated` | کارٹ میں ترمیم ہوئی | کارٹ ویلیو ٹریکنگ |
| `cart_abandoned` | 30 منٹ میں کوئی چیک آؤٹ نہیں | بحالی ای میلز |

## فعال کردہ اسکلز

Shopify کنیکٹر یہ اسکلز فعال کرتا ہے:

| اسکل | تفصیل |
| --- | --- |
| [گاہک سنک](https://tajo.io/ur/docs/skills/data-sync/customer-sync) | ریئل ٹائم گاہک سنک |
| آرڈر ایونٹس | آرڈر لائف سائیکل ٹریکنگ |
| [ترک شدہ کارٹ](https://tajo.io/ur/docs/skills/email-marketing/abandoned-cart) | کارٹ ریکوری ای میلز |
| ویلکم سیریز | نیا گاہک آن بورڈنگ |
| خریداری کے بعد | آرڈر فالو اپ |
| دوبارہ جیتنا | غیر فعال گاہکوں کو دوبارہ مصروف کریں |
| براؤز ترک کرنا | پروڈکٹ دلچسپی فالو اپ |
| دوبارہ بھرنا | دوبارہ آرڈر یاد دہانیاں |

## کوڈ کی مثالیں

### کنیکٹر کو انیشیلائز کریں

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect Shopify store
await tajo.connectors.connect('shopify', {
  shopUrl: 'your-store.myshopify.com',
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecret: process.env.SHOPIFY_API_SECRET
});
```

### ابتدائی سنک چلائیں

```javascript
// Full historical sync
await tajo.connectors.sync('shopify', {
  type: 'full',
  resources: ['customers', 'orders', 'products'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('shopify');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 15420,
//   ordersCount: 8234,
//   productsCount: 342
// }
```

### کارٹ ایونٹس ٹریک کریں

اپنی Shopify تھیم میں Tajo اسکرپٹ شامل کریں:

```liquid
<!-- Add to theme.liquid before </head> -->
{% if customer %}
<script>
  window.tajoConfig = {
    customerId: "{{ customer.id }}",
    customerEmail: "{{ customer.email }}",
    customerName: "{{ customer.first_name }}"
  };
</script>
{% endif %}
<script src="https://cdn.example.com/shopify.js"></script>
```

Caution

اوپر دیا گیا `example.com` پتہ Tajo اینڈ پوائنٹ دستیاب ہونے تک صرف ایک پلیس ہولڈر ہے۔

### کسٹم Webhook ہینڈلر

```javascript
// Handle Shopify webhooks manually
app.post('/webhooks/shopify', async (req, res) => {
  const hmac = req.get('X-Shopify-Hmac-SHA256');

  // Verify webhook signature
  if (!verifyShopifyWebhook(req.body, hmac)) {
    return res.status(401).send('Unauthorized');
  }

  const topic = req.get('X-Shopify-Topic');

  // Forward to Tajo
  await tajo.connectors.handleWebhook('shopify', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});
```

## نگرانی

### ڈیش بورڈ میٹرکس

Tajo ڈیش بورڈ میں اپنے Shopify کنکشن کی نگرانی کریں:

- **سنک اسٹیٹس**: ریئل ٹائم کنکشن کی صحت
- **سنک شدہ گاہک**: Shopify سے کل رابطے
- **ٹریک شدہ آرڈرز**: پروسیس شدہ آرڈر ایونٹس
- **کارٹ ریکوری**: ترک شدہ کارٹ کی کارکردگی
- **خرابی کی شرح**: ناکام سنک کوششیں

### Webhook لاگز

ویب ہُک ڈیلیوری اسٹیٹس دیکھیں:

```bash
tajo connectors logs shopify --type webhook --last 24h
```

### سنک کی تاریخ

تاریخی سنک آپریشنز چیک کریں:

```bash
tajo connectors history shopify --limit 10
```

## ٹربل شوٹنگ

### عام مسائل

API شرح کی حدود

Shopify کی API شرح کی حدود 2 درخواستیں فی سیکنڈ ہیں۔ بڑے تاریخی درآمد کے لیے بیچ سنک استعمال کریں۔

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| Webhook موصول نہیں ہوا | ایپ کی اجازتیں | درست اسکوپس کے ساتھ ایپ دوبارہ انسٹال کریں |
| گاہک سنک نہیں ہوا | ای میل غائب | Shopify کو گاہکوں کے لیے ای میل درکار ہے |
| پروڈکٹس غائب | پروڈکٹ اسٹیٹس | چیک کریں کہ پروڈکٹ “active” اسٹیٹس میں ہے |
| کارٹ ٹریک نہیں ہوا | اسکرپٹ لوڈ نہیں ہوا | theme.liquid میں اسکرپٹ کی تصدیق کریں |

### ڈیبگ موڈ

تفصیلی لاگنگ فعال کریں:

```yaml
connectors:
  shopify:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### کنکشن ٹیسٹ کریں

```bash
tajo connectors test shopify
# ✓ API connection successful
# ✓ Webhooks registered
# ✓ Products accessible
# ✓ Customers readable
# ✓ Orders readable
```

## بہترین طرز عمل

1. **ٹیسٹ اسٹور سے شروع کریں** - پہلے ڈویلپمنٹ اسٹور استعمال کریں
2. **ابتدائی سنک غیر کام کے اوقات میں چلائیں** - بڑے سنک سست ہو سکتے ہیں
3. **کسٹم خصوصیات میپ کریں** - صرف طے شدہ میپنگز پر انحصار نہ کریں
4. **کارٹ ٹریکنگ فعال کریں** - ترک شدہ کارٹ کی بحالی کے لیے اہم
5. **Webhook کی صحت کی نگرانی کریں** - ناکام ڈیلیوریوں کے لیے الرٹس ترتیب دیں
6. **بیچ امپورٹس استعمال کریں** - 10,000 سے زیادہ ریکارڈز کے تاریخی ڈیٹا کے لیے

## سیکیورٹی

- **OAuth 2.0** - محفوظ ٹوکن پر مبنی تصدیق
- **Webhook تصدیق** - HMAC دستخط کی توثیق
- **انکرپٹڈ اسٹوریج** - API اسناد آرام کے وقت انکرپٹڈ
- **اسکوپڈ رسائی** - صرف کم از کم درکار اجازتیں

## متعلقہ وسائل

- [WooCommerce کنیکٹر](https://tajo.io/ur/docs/connectors/ecommerce/woocommerce)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [ترک شدہ کارٹ اسکل](https://tajo.io/ur/docs/skills/email-marketing/abandoned-cart)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)