Zendesk Connector

เชื่อมต่อ Zendesk Support instance ของคุณกับ Brevo ผ่าน Tajo เพื่อข้อมูล customer support ที่รวมกัน การแบ่ง segment ตาม ticket การให้คะแนนความพึงพอใจ และ marketing automation ที่ triggered จาก support

ภาพรวม

ฟีเจอร์

• การซิงค์ผู้ใช้ - ซิงค์ Zendesk end-users และ agents กับ Brevo contacts
• การติดตาม Ticket - ซิงค์ข้อมูล ticket สำหรับการแบ่ง segment การตลาดที่ตระหนักถึง support
• การแมป Organization - เชื่อมผู้ติดต่อกับ organizations สำหรับ B2B workflows
• คะแนนความพึงพอใจ - ซิงค์ข้อมูล CSAT และ NPS ไปยัง Brevo attributes
• เหตุการณ์ Ticket - ติดตามการสร้าง การแก้ไข และการยกระดับ ticket สำหรับ automation triggers
• การผสานรวม Help center - ติดตามการดูบทความและพฤติกรรมการค้นหา
• รองรับหลายช่องทาง - ซิงค์ข้อมูลจากอีเมล แชท เสียง และ messaging channels
• Custom fields - แมป Zendesk custom ticket และ user fields ไปยัง Brevo

ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Zendesk Support (Team, Professional หรือ Enterprise)
2. สิทธิ์ admin สำหรับ Zendesk instance ของคุณ
3. API token หรือกำหนดค่า OAuth app
4. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
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"

สร้าง API token จาก Zendesk Admin > Apps and Integrations > APIs > Zendesk API

OAuth 2.0

ใช้ OAuth สำหรับการผสานรวมหลาย instance พร้อม delegated user access

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

Scopes ที่จำเป็น

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:

การแมป Custom Field

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 Endpoints

Ticketing API

Users API

Organizations API

Satisfaction Ratings API

เหตุการณ์

เหตุการณ์ Ticket

เหตุการณ์ผู้ใช้

เหตุการณ์ความพึงพอใจ

ตัวอย่างโค้ด

เริ่มต้น Connector

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

ซิงค์ผู้ใช้และ Tickets

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

ขีดจำกัดอัตรา

Rate limits ของ Zendesk แตกต่างกันตามแผน:

ขีดจำกัดเพิ่มเติม:

• Search API: 6 คำขอ/นาทีสำหรับ anonymous, 100/นาทีสำหรับการยืนยันตัวตน
• Incremental exports: 10 คำขอ/นาที
• Batch API: 100 records ต่อ batch request
• Webhook delivery: ลองใหม่อัตโนมัติพร้อม exponential backoff

การแก้ไขปัญหา

ปัญหาทั่วไป

โหมด Debug

เปิดใช้งาน verbose logging:

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 - ใช้ Incremental API สำหรับการซิงค์ข้อมูลขนาดใหญ่
2. กรองเฉพาะ end-users - ยกเว้น agents และ admins จากการซิงค์ Brevo contact
3. ซิงค์ข้อมูล CSAT - ใช้คะแนนความพึงพอใจสำหรับการแบ่ง segment สุขภาพลูกค้า
4. แมป organizations - ใช้ข้อมูล organization สำหรับแคมเปญ B2B marketing
5. ใช้ webhook retries - จัดการความล้มเหลวชั่วคราวอย่างมีเกียรติ
6. ใช้ side-loading - รวม records ที่เกี่ยวข้องใน API responses เพื่อลดจำนวนคำขอ

ความปลอดภัย

• การยืนยันตัวตนด้วย API Token - การเข้าถึงด้วย token ที่เชื่อมกับอีเมล admin
• OAuth 2.0 - Delegated access ด้วย token พร้อมการควบคุม scope
• Webhook signing - การตรวจสอบ HMAC signature สำหรับ webhook payloads
• การเข้ารหัส TLS - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน HTTPS
• IP whitelisting - จำกัดการเข้าถึง API ตามช่วง IP

แหล่งข้อมูลที่เกี่ยวข้อง

• Zendesk API Documentation
• Zendesk Webhooks Guide
• Intercom Connector
• Customer Sync Skill
• Brevo Contacts API