---
title: "Zendesk کنیکٹر"
description: "Tajo کے ذریعے ٹکٹس، صارفین، تنظیموں، اور سپورٹ ایونٹس کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Zendesk انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/support/zendesk/
markdown: https://tajo.io/ur/docs/connectors/support/zendesk.md
lang: ur-PK
robots: noindex
---

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

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

# Zendesk کنیکٹر

کنیکٹر کی حیثیت: منصوبہ بند ابھی تیار نہیں ہوا۔ Tajo آج یہ کنیکٹر نہیں چلاتا۔

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

متحدہ گاہک سپورٹ ڈیٹا، ٹکٹ پر مبنی segmentation، اطمینان اسکورنگ، اور سپورٹ ٹرگر شدہ مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Zendesk Support instance کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Zendesk |
| **زمرہ** | سپورٹ |
| **سیٹ اپ کی پیچیدگی** | درمیانی |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | ٹکٹس، صارفین، تنظیمیں، ایونٹس |
| **API بنیادی URL** | `https://{subdomain}.zendesk.com/api/v2` |

## خصوصیات

- **صارف سنک** - Brevo رابطوں کے ساتھ Zendesk end-users اور ایجنٹس سنک کریں
- **ٹکٹ ٹریکنگ** - سپورٹ سے آگاہ مارکیٹنگ segmentation کے لیے ٹکٹ ڈیٹا سنک کریں
- **تنظیم میپنگ** - B2B ورک فلوز کے لیے رابطوں کو تنظیموں کے ساتھ منسلک کریں
- **اطمینان اسکورز** - CSAT اور NPS ڈیٹا کو Brevo خصوصیات پر سنک کریں
- **ٹکٹ ایونٹس** - آٹومیشن ٹرگرز کے لیے ٹکٹ کی تخلیق، resolution، اور escalation ٹریک کریں
- **Help center انٹیگریشن** - مضمون کے views اور سرچ رویے کو ٹریک کریں
- **ملٹی چینل سپورٹ** - ای میل، چیٹ، وائس، اور پیغام رسانی چینلز سے ڈیٹا سنک کریں
- **کسٹم فیلڈز** - Zendesk کسٹم ٹکٹ اور صارف فیلڈز کو Brevo پر میپ کریں

## شرائط

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

1. Zendesk Support اکاؤنٹ (Team, Professional, یا Enterprise)
2. اپنے Zendesk instance تک ایڈمن رسائی
3. API token یا OAuth ایپ ترتیب دیا گیا
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. Tajo اکاؤنٹ

## تصدیق

### API Token تصدیق

فوری سیٹ اپ کے لیے email/token تصدیق استعمال کریں۔

```bash
curl https://{subdomain}.zendesk.com/api/v2/users.json \
  -u {email}/token:{api_token} \
  -H "Content-Type: application/json"
```

Zendesk Admin > Apps and Integrations > APIs > Zendesk API سے API token تیار کریں۔

### OAuth 2.0

delegated صارف رسائی کے ساتھ ملٹی instance انٹیگریشنز کے لیے OAuth استعمال کریں۔

```bash
# Authorization URL
https://{subdomain}.zendesk.com/oauth/authorizations/new?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}&
  scope=read%20write
```

#### مطلوبہ اسکوپس

```
read          # Read access to all resources
write         # Write access to all resources
tickets:read  # Read tickets (granular)
users:read    # Read users (granular)
organizations:read  # Read organizations (granular)
```

## تشکیل

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

```yaml
connectors:
  zendesk:
    enabled: true
    subdomain: "yourcompany"
    auth:
      email: "admin@yourcompany.com"
      api_token: "${ZENDESK_API_TOKEN}"

    # Data sync options
    sync:
      users: true
      tickets: true
      organizations: true
      satisfaction_ratings: true

    # Brevo list assignment
    lists:
      all_customers: 30
      active_tickets: 31
      satisfied_customers: 32
```

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

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

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

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | صارف ای میل پتہ (منفرد شناخت کنندہ) |
| `name` optional | string | مکمل نام، FIRSTNAME/LASTNAME میں تقسیم |
| `phone` optional | string | WhatsApp/SMS کے لیے SMS خصوصیت پر میپ ہوتا ہے |
| `organization_id` optional | integer | B2B میپنگ کے لیے منسلک تنظیم |
| `role` optional | string | صارف رول (end-user, agent, admin) |
| `tags` optional | array | Zendesk سے صارف ٹیگز |
| `ticket_restriction` optional | string | ٹکٹ رسائی کی سطح |
| `custom_fields` optional | object | کسٹم صارف فیلڈ اقدار |

#### کسٹم فیلڈ میپنگ

```yaml
field_mapping:
  # Standard fields
  email: email
  name: FULLNAME
  phone: SMS

  # Support metrics
  open_tickets: OPEN_TICKETS
  total_tickets: TOTAL_TICKETS
  avg_satisfaction: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # Organization fields
  organization.name: COMPANY_NAME
  organization.tags: COMPANY_TAGS

  # Custom fields
  user_fields.customer_type: CUSTOMER_TYPE
  user_fields.account_tier: ACCOUNT_TIER
```

## API اینڈ پوائنٹس

### Ticketing API

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/v2/tickets` | ٹکٹس کی فہرست |
| `POST` | `/api/v2/tickets` | ٹکٹ بنائیں |
| `PUT` | `/api/v2/tickets/{id}` | ٹکٹ اپ ڈیٹ کریں |
| `GET` | `/api/v2/tickets/{id}` | ٹکٹ دکھائیں |
| `GET` | `/api/v2/search.json?query={query}` | ٹکٹس تلاش کریں |

### Users API

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/v2/users` | صارفین کی فہرست |
| `POST` | `/api/v2/users` | صارف بنائیں |
| `PUT` | `/api/v2/users/{id}` | صارف اپ ڈیٹ کریں |
| `GET` | `/api/v2/users/{id}` | صارف دکھائیں |
| `GET` | `/api/v2/users/search.json?query={query}` | صارفین تلاش کریں |

### Organizations API

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/v2/organizations` | تنظیموں کی فہرست |
| `POST` | `/api/v2/organizations` | تنظیم بنائیں |
| `GET` | `/api/v2/organizations/{id}/users` | تنظیم ممبران کی فہرست |

### Satisfaction Ratings API

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/v2/satisfaction_ratings` | اطمینان ریٹنگز کی فہرست |
| `GET` | `/api/v2/satisfaction_ratings/{id}` | ریٹنگ دکھائیں |

## ایونٹس

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

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `ticket.created` | نیا ٹکٹ submit | سپورٹ تسلیم |
| `ticket.updated` | ٹکٹ اسٹیٹس تبدیل | اسٹیٹس نوٹیفکیشن |
| `ticket.solved` | ٹکٹ solved نشان زد | CSAT سروے ٹرگر |
| `ticket.reopened` | Solved ٹکٹ دوبارہ کھولا | Escalation الرٹ |

### صارف ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `user.created` | نیا صارف رجسٹرڈ | سپورٹ میں خوش آمدید |
| `user.updated` | صارف پروفائل تبدیل | خصوصیت سنک |
| `user.merged` | صارفین merge | ڈی ڈپلیکیشن |

### اطمینان ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `satisfaction_rating.created` | CSAT submit | فیڈ بیک پروسیسنگ |
| `satisfaction_rating.bad` | منفی ریٹنگ | ریکوری outreach |
| `satisfaction_rating.good` | مثبت ریٹنگ | Advocacy مہمات |

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

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

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

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

// Connect Zendesk
await tajo.connectors.connect('zendesk', {
  subdomain: 'yourcompany',
  email: 'admin@yourcompany.com',
  apiToken: process.env.ZENDESK_API_TOKEN
});
```

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

```javascript
// Full sync of users and ticket data
await tajo.connectors.sync('zendesk', {
  type: 'full',
  resources: ['users', 'tickets', 'organizations'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('zendesk');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   usersSynced: 8400,
//   ticketsSynced: 34200,
//   organizationsSynced: 1200
// }
```

### Zendesk Webhooks کو سنبھالیں

```javascript
app.post('/webhooks/zendesk', async (req, res) => {
  const signature = req.get('X-Zendesk-Webhook-Signature');

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

  await tajo.connectors.handleWebhook('zendesk', {
    type: req.body.type,
    ticketId: req.body.ticket_id,
    userId: req.body.user_id,
    payload: req.body
  });

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

## شرح کی حدود

Zendesk شرح کی حدود پلان کے مطابق مختلف ہیں:

| پلان | شرح کی حد | تفصیلات |
| --- | --- | --- |
| Team | 200 درخواستیں/منٹ | فی API token |
| Professional | 400 درخواستیں/منٹ | فی API token |
| Enterprise | 700 درخواستیں/منٹ | فی API token |
| High Volume Add-on | 2,500 درخواستیں/منٹ | فی API token |

اضافی حدود:

- **Search API**: گمنام کے لیے 6 درخواستیں/منٹ، authenticated کے لیے 100/منٹ
- **Incremental exports**: 10 درخواستیں/منٹ
- **Batch API**: 100 ریکارڈز فی بیچ درخواست
- **Webhook ڈیلیوری**: exponential backoff کے ساتھ خودکار retry

شرح کی حد ہیڈرز

اپنے API استعمال کا انتظام کرنے کے لیے `X-Rate-Limit-Remaining` اور `Retry-After` ہیڈرز کی نگرانی کریں۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط API token | Zendesk Admin میں token دوبارہ بنائیں |
| 403 Forbidden | ناکافی اجازتیں | ایجنٹ یا ایڈمن رول کی ضروریات چیک کریں |
| صارف سنک نہیں ہوا | صارف ایجنٹ ہے، end-user نہیں | sync تشکیل میں role کے ذریعے فلٹر کریں |
| Webhook موصول نہیں ہوا | Trigger/target ترتیب نہیں | Zendesk Admin میں webhook target سیٹ اپ کریں |
| Search خالی واپس آیا | Indexing تاخیر | search index اپ ڈیٹ کے لیے 1-2 منٹ انتظار کریں |

### ڈیبگ موڈ

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

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

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

```bash
tajo connectors test zendesk
# ✓ API connection successful
# ✓ Users readable
# ✓ Tickets readable
# ✓ Organizations readable
# ✓ Webhooks configured
```

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

1. **Incremental exports استعمال کریں** - بڑے پیمانے پر ڈیٹا sync کے لیے Incremental API استعمال کریں
2. **صرف end-users فلٹر کریں** - Brevo رابطہ sync سے ایجنٹس اور ایڈمنز کو خارج کریں
3. **CSAT ڈیٹا سنک کریں** - گاہک صحت کی segmentation کے لیے اطمینان اسکورز استعمال کریں
4. **تنظیموں کو میپ کریں** - B2B مارکیٹنگ مہمات کے لیے تنظیم ڈیٹا کا فائدہ اٹھائیں
5. **Webhook retries نافذ کریں** - عارضی ناکامیوں کو خوش اسلوبی سے سنبھالیں
6. **Side-loading استعمال کریں** - درخواست کی تعداد کم کرنے کے لیے API جوابات میں متعلقہ ریکارڈز شامل کریں

## سیکیورٹی

- **API Token تصدیق** - ایڈمن ای میل سے منسلک Token پر مبنی رسائی
- **OAuth 2.0** - scope کنٹرولز کے ساتھ Token پر مبنی delegated رسائی
- **Webhook دستخط** - webhook payloads کے لیے HMAC دستخط کی توثیق
- **TLS انکرپشن** - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
- **IP وائٹ لسٹنگ** - IP رینج کے ذریعے API رسائی کو محدود کریں

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

- [Zendesk API دستاویزات](https://developer.zendesk.com/api-reference)
- [Zendesk Webhooks گائیڈ](https://developer.zendesk.com/api-reference/webhooks/introduction/)
- [Intercom کنیکٹر](https://tajo.io/ur/docs/connectors/support/intercom)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)
- [Brevo Contacts API](https://tajo.io/ur/docs/contact-management)