Konektor Zendesk

Hubungkan instance Zendesk Support Anda ke Brevo melalui Tajo untuk data support pelanggan yang terpadu, segmentasi berbasis tiket, penilaian kepuasan, dan otomatisasi marketing yang dipicu aktivitas support.

Ikhtisar

Fitur

• Sinkronisasi user - Sinkronkan end-user dan agen Zendesk dengan kontak Brevo
• Pelacakan tiket - Sinkronkan data tiket untuk segmentasi marketing yang sadar konteks support
• Pemetaan organisasi - Kaitkan kontak dengan organisasi untuk alur kerja B2B
• Skor kepuasan - Sinkronkan data CSAT dan NPS ke atribut Brevo
• Event tiket - Lacak pembuatan, penyelesaian, dan eskalasi tiket sebagai pemicu otomatisasi
• Integrasi help center - Lacak tampilan artikel dan perilaku pencarian
• Dukungan multi-channel - Sinkronkan data dari channel email, chat, voice, dan messaging
• Custom field - Petakan custom field tiket dan user Zendesk ke Brevo

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Akun Zendesk Support (Team, Professional, atau Enterprise)
2. Akses admin ke instance Zendesk Anda
3. API token atau app OAuth yang sudah dikonfigurasi
4. Akun Brevo dengan akses API
5. Akun Tajo

Autentikasi

Autentikasi API token

Gunakan autentikasi email/token untuk setup cepat.

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

Buat API token dari Zendesk Admin > Apps and Integrations > APIs > Zendesk API.

OAuth 2.0

Gunakan OAuth untuk integrasi multi-instance dengan akses user yang terdelegasi.

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

Scope yang dibutuhkan

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)

Konfigurasi

Setup dasar

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

Pemetaan field

Petakan field user Zendesk ke atribut kontak Brevo:

Pemetaan 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

Endpoint API

Ticketing API

Users API

Organizations API

Satisfaction Ratings API

Event

Event tiket

Event user

Event kepuasan

Contoh kode

Inisialisasi konektor

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

Menyinkronkan user dan tiket

// 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
// }

Menangani webhook Zendesk

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

Batas rate

Batas rate Zendesk berbeda menurut paket:

Batas tambahan:

• Search API: 6 permintaan/menit untuk anonim, 100/menit untuk terautentikasi
• Ekspor inkremental: 10 permintaan/menit
• Batch API: 100 record per permintaan batch
• Pengiriman webhook: Percobaan ulang otomatis dengan exponential backoff

Pemecahan masalah

Masalah umum

Mode debug

Aktifkan logging verbose:

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

Menguji koneksi

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

Praktik terbaik

1. Gunakan ekspor inkremental - Gunakan Incremental API untuk sinkronisasi data berskala besar
2. Filter hanya end-user - Kecualikan agent dan admin dari sinkronisasi kontak Brevo
3. Sinkronkan data CSAT - Gunakan skor kepuasan untuk segmentasi customer health
4. Petakan organisasi - Manfaatkan data organisasi untuk kampanye marketing B2B
5. Terapkan percobaan ulang webhook - Tangani kegagalan sementara dengan baik
6. Gunakan side-loading - Sertakan record terkait dalam respons API untuk menekan jumlah permintaan

Keamanan

• Autentikasi API token - Akses berbasis token yang terikat pada email admin
• OAuth 2.0 - Akses terdelegasi berbasis token dengan kontrol scope
• Penandatanganan webhook - Verifikasi tanda tangan HMAC untuk payload webhook
• Enkripsi TLS - Semua komunikasi API dienkripsi lewat HTTPS
• IP whitelisting - Batasi akses API berdasarkan rentang IP

Sumber daya terkait

• Dokumentasi API Zendesk
• Panduan Webhook Zendesk
• Konektor Intercom
• Skill Customer Sync
• Brevo Contacts API