موصل Zendesk

اربط مثيل Zendesk Support الخاص بك مع Brevo عبر Tajo لبيانات دعم عملاء موحدة، وتقسيم قائم على التذاكر، وتقييم الرضا، وأتمتة تسويق مُشغَّلة من الدعم.

نظرة عامة

الميزات

• مزامنة المستخدمين - مزامنة المستخدمين النهائيين والوكلاء في Zendesk مع جهات اتصال Brevo
• تتبع التذاكر - مزامنة بيانات التذاكر للتقسيم التسويقي المدرك للدعم
• تعيين المؤسسات - ربط جهات الاتصال بالمؤسسات لسير عمل B2B
• درجات الرضا - مزامنة بيانات CSAT وNPS مع سمات Brevo
• أحداث التذاكر - تتبع إنشاء التذاكر وحلها وتصعيدها لمحفزات الأتمتة
• تكامل مركز المساعدة - تتبع مشاهدات المقالات وسلوك البحث
• دعم متعدد القنوات - مزامنة البيانات من قنوات البريد الإلكتروني والدردشة والصوت والمراسلة
• الحقول المخصصة - ربط حقول التذاكر والمستخدمين المخصصة في Zendesk بـ Brevo

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب Zendesk Support (Team أو Professional أو Enterprise)
2. صلاحيات المسؤول على مثيل Zendesk الخاص بك
3. رمز API أو تطبيق OAuth مُعَد
4. حساب Brevo مع وصول إلى API
5. حساب Tajo

المصادقة

مصادقة رمز API

استخدم مصادقة البريد الإلكتروني/الرمز للإعداد السريع.

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

ولِّد رمز API من Zendesk Admin > Apps and Integrations > APIs > Zendesk API.

OAuth 2.0

استخدم 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

نقاط نهاية واجهة البرمجة

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
});

مزامنة المستخدمين والتذاكر

// مزامنة كاملة للمستخدمين وبيانات التذاكر
await tajo.connectors.sync('zendesk', {
  type: 'full',
  resources: ['users', 'tickets', 'organizations'],
  since: '2023-01-01'
});

// التحقق من حالة المزامنة
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');

  // التحقق من توقيع webhook
  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 طلبات/دقيقة للمجهولين، 100/دقيقة للمصادق عليهم
• التصديرات التزايدية: 10 طلبات/دقيقة
• Batch API: 100 سجل لكل طلب دفعة
• تسليم Webhook: إعادة محاولة تلقائية بالتراجع الأُسّي

استكشاف الأخطاء وإصلاحها

المشاكل الشائعة

وضع التصحيح

تفعيل التسجيل المفصل:

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 API لمزامنة البيانات على نطاق واسع
2. صفِّ المستخدمين النهائيين فقط - استبعد الوكلاء والمسؤولين من مزامنة جهات اتصال Brevo
3. زامن بيانات CSAT - استخدم درجات الرضا لتقسيم صحة العملاء
4. عيّن المؤسسات - استفد من بيانات المؤسسات للحملات التسويقية B2B
5. طبّق إعادة محاولة webhook - تعامل مع الإخفاقات المؤقتة بسلاسة
6. استخدم التحميل الجانبي - ضمّن السجلات ذات الصلة في استجابات API لتقليل عدد الطلبات

الأمان

• مصادقة رمز API - وصول قائم على الرموز مرتبط بالبريد الإلكتروني للمسؤول
• OAuth 2.0 - وصول مُوكَّل قائم على الرموز مع ضوابط النطاق
• توقيع Webhook - التحقق من توقيع HMAC لحمولات webhook
• تشفير TLS - جميع اتصالات API مشفرة عبر HTTPS
• قائمة IP المسموح بها - قيّد وصول API حسب نطاق IP

موارد ذات صلة

• وثائق Zendesk API
• دليل Zendesk Webhooks
• موصل Intercom
• مهارة مزامنة العملاء
• واجهة جهات اتصال Brevo