발표일 마이그레이션 시작일 마이그레이션 종료일
2026년 9월 14일 2026년 9월 14일 2027년 7월 31일

Zendesk에서 헬프 센터 기본서식 작성 API v1, v2 및 v3를 중단할 예정입니다. 헬프 센터의 기능과 스타일을 유지하려면 기본서식 작성 API v4로 업그레이드해야 합니다.

본 공지는 다음 섹션으로 구성되어 있습니다.

  • 무엇이 변경되나요?
  • Zendesk에서 이러한 변경을 하는 이유는 무엇인가요?
  • 어떻게 해야 하나요?

무엇이 변경되나요?

기본서식 작성 API v1, v2 및 v3 기능 제공을 중단합니다. v4로 단계적으로 전환되므로, 사용자 지정 테마를 충분한 시간 동안 마이그레이션할 수 있습니다.

  • 2026년 9월 14일 모든 새 계정은 v1, v2 및 v3 테마 가져오기를 사용할 수 없습니다.
  • 2026년 11월 25일: 이번에 출시하는 Zendesk 명령줄 인터페이스(ZCLI) 업그레이드 도구는 개발자가 사용자 지정 코딩된 테마를 마이그레이션할 수 있도록 지원합니다.
  • 2027년 3월 1일: 제품 내 GUI 업그레이드 도구를 출시할 예정입니다. 현재 모든 계정은 v1, v2 및 v3 테마 가져오기가 완전히 차단됩니다.
  • 2027년 7월 31일: 나머지 모든 레거시 테마는 v4로 강제 업그레이드되며 v1, v2, v3는 완전히 차단됩니다.

Zendesk에서 이러한 변경을 하는 이유는 무엇인가요?

4가지 기본서식 작성 API 버전을 유지하면 제품 개발 속도가 낮아지고 이전 버전을 사용하는 고객은 새 기능을 사용할 수 없습니다. API v4에 통합하면 다음과 같은 이점을 누릴 수 있습니다.

  • 새로운 기능에 바로 액세스 제공: 최신 헬프 센터 개선 사항이 출시되는 즉시 이전 버전과의 호환성이 구현되는 것을 기다리지 않고 바로 활용할 수 있습니다.
  • 규정 준수 개선: 최신 API 버전은 최신 웹 위협을 막도록 강화되었으며 레거시 버전의 보안 및 접근성 문제를 해결합니다.
  • 더 나은 서비스 제공: API 버전 수를 줄이면 엔지니어링 및 지원팀에서 보고된 문제를 더 빨리 해결할 수 있습니다.

어떻게 해야 하나요?

헬프 센터 기본서식 작성 버전 확인에서 현재 사용 중인 버전을 확인합니다. 다음 사항에 해당하는 경우, 2027년 7월 31일 전에 헬프 센터 테마를 기본서식 작성 API v4로 업그레이드해야 합니다.

  • 개발자 리소스가 있는 경우: 2026년 11월 25일부터 팀에서 ZCLI 업그레이드 도구를 사용하여 코드를 마이그레이션할 수 있습니다. 이와 관련한 문서는 나중에 전용 문서로 제공하겠습니다.
  • 자동화된 시각적 도구를 선호하는 경우: 2027년 3월 1일부터 제품 내 GUI 업그레이드 도구를 사용하여 몇 번만 클릭하고 수동으로 QA를 확인함으로써 업그레이드할 수 있습니다.
  • 마켓플레이스 테마를 사용하는 경우: 테마 개발자에게 문의하여 테마의 v4 준비 버전으로 업그레이드했는지 확인합니다.

이 발표와 관련된 피드백이나 질문이 있으시면 고객 제품 피드백을 수집 및 관리하는 커뮤니티 포럼을 방문하세요. Zendesk 제품에 대한 일반적인 지원은 Zendesk 고객 지원팀에 문의하세요.

Zendesk 제공