Zendesk 커넥터

Zendesk Support 인스턴스를 Tajo를 통해 Brevo에 연결하여 통합된 고객 지원 데이터, 티켓 기반 세그먼테이션, 만족도 점수 산출, 지원 트리거 마케팅 자동화를 구현하십시오.

개요

기능

• 사용자 동기화 - Zendesk 최종 사용자 및 상담원을 Brevo 연락처와 동기화
• 티켓 추적 - 지원 인식 마케팅 세그먼테이션을 위한 티켓 데이터 동기화
• 조직 매핑 - B2B 워크플로를 위해 연락처를 조직과 연결
• 만족도 점수 - CSAT 및 NPS 데이터를 Brevo 속성에 동기화
• 티켓 이벤트 - 자동화 트리거를 위해 티켓 생성, 해결, 에스컬레이션 추적
• 헬프 센터 통합 - 아티클 조회수 및 검색 행동 추적
• 다중 채널 지원 - 이메일, 채팅, 음성, 메시징 채널의 데이터 동기화
• 맞춤 필드 - Zendesk 맞춤 티켓 및 사용자 필드를 Brevo에 매핑

사전 요구 사항

시작하기 전에 다음이 준비되어 있는지 확인하십시오.

1. Zendesk Support 계정 (Team, Professional 또는 Enterprise)
2. Zendesk 인스턴스에 대한 관리자 접근 권한
3. API 토큰 또는 OAuth 앱이 구성됨
4. API 접근이 가능한 Brevo 계정
5. Tajo 계정

인증

API 토큰 인증

빠른 설정에 이메일/토큰 인증을 사용하십시오.

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 토큰을 생성하십시오.

OAuth 2.0

위임된 사용자 접근이 있는 다중 인스턴스 통합에 OAuth를 사용하십시오.

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

필수 범위

read          # 모든 리소스에 대한 읽기 접근
write         # 모든 리소스에 대한 쓰기 접근
tickets:read  # 티켓 읽기 (세분화)
users:read    # 사용자 읽기 (세분화)
organizations:read  # 조직 읽기 (세분화)

구성

기본 설정

connectors:
  zendesk:
    enabled: true
    subdomain: "yourcompany"
    auth:
      email: "[email protected]"
      api_token: "${ZENDESK_API_TOKEN}"

    # 데이터 동기화 옵션
    sync:
      users: true
      tickets: true
      organizations: true
      satisfaction_ratings: true

    # Brevo 목록 할당
    lists:
      all_customers: 30
      active_tickets: 31
      satisfied_customers: 32

필드 매핑

Zendesk 사용자 필드를 Brevo 연락처 속성에 매핑합니다.

맞춤 필드 매핑

field_mapping:
  # 표준 필드
  email: email
  name: FULLNAME
  phone: SMS

  # 지원 지표
  open_tickets: OPEN_TICKETS
  total_tickets: TOTAL_TICKETS
  avg_satisfaction: CSAT_SCORE
  last_ticket_date: LAST_SUPPORT_DATE

  # 조직 필드
  organization.name: COMPANY_NAME
  organization.tags: COMPANY_TAGS

  # 맞춤 필드
  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
});

// 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 웹훅 처리

app.post('/webhooks/zendesk', async (req, res) => {
  const signature = req.get('X-Zendesk-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 요청/분, 인증된 사용자는 100 요청/분
• Incremental 내보내기: 10 요청/분
• Batch API: 배치 요청당 100 레코드
• 웹훅 배달: 지수 백오프를 사용한 자동 재시도

문제 해결

일반적인 문제

디버그 모드

자세한 로깅 활성화:

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

연결 테스트

tajo connectors test zendesk
# ✓ API 연결 성공
# ✓ 사용자 읽기 가능
# ✓ 티켓 읽기 가능
# ✓ 조직 읽기 가능
# ✓ 웹훅 구성됨

모범 사례

1. Incremental 내보내기 사용 - 대규모 데이터 동기화에 Incremental API 사용
2. 최종 사용자만 필터링 - Brevo 연락처 동기화에서 상담원 및 관리자 제외
3. CSAT 데이터 동기화 - 고객 상태 세그먼테이션을 위한 만족도 점수 사용
4. 조직 매핑 - B2B 마케팅 캠페인을 위해 조직 데이터 활용
5. 웹훅 재시도 구현 - 일시적인 실패를 원활하게 처리
6. Side-loading 사용 - 요청 수를 줄이기 위해 API 응답에 관련 레코드 포함

보안

• API 토큰 인증 - 관리자 이메일에 연결된 토큰 기반 접근
• OAuth 2.0 - 범위 제어가 있는 토큰 기반 위임 접근
• 웹훅 서명 - 웹훅 페이로드에 대한 HMAC 서명 확인
• TLS 암호화 - HTTPS를 통해 암호화된 모든 API 통신
• IP 허용 목록 - IP 범위별 API 접근 제한

관련 리소스

• Zendesk API 문서
• Zendesk 웹훅 가이드
• Intercom 커넥터
• 고객 동기화 스킬
• Brevo Contacts API