Zendesk کنیکٹر

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

جائزہ

خصوصیات

• صارف سنک - 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 تصدیق استعمال کریں۔

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 استعمال کریں۔

# 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)

تشکیل

بنیادی سیٹ اپ

connectors:
  zendesk:
    enabled: true
    subdomain: "yourcompany"
    auth:
      email: "[email protected]"
      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 رابطہ خصوصیات پر میپ کریں:

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

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

Users API

Organizations API

Satisfaction Ratings API

ایونٹس

ٹکٹ ایونٹس

صارف ایونٹس

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

کوڈ کی مثالیں

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

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: '[email protected]',
  apiToken: process.env.ZENDESK_API_TOKEN
});

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

// 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 کو سنبھالیں

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 شرح کی حدود پلان کے مطابق مختلف ہیں:

اضافی حدود:

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

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

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

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

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

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 دستاویزات
• Zendesk Webhooks گائیڈ
• Intercom کنیکٹر
• گاہک سنک اسکل
• Brevo Contacts API