사용 중인 플랜
Suite Team, Growth, Professional, Enterprise 또는 Enterprise Plus
Support(다음 포함) Guide Professional 또는 Enterprise

콘텐츠를 한 헬프 센터에서 다른 헬프 센터로 마이그레이션하는 방법에는 여러 가지가 있습니다. 이 문서는 주로 헬프 센터 API를 사용하여 콘텐츠를 프로그래밍 방식으로 가져오는 것에 중점을 두고 있으며, 새로운 헬프 센터로 기존 콘텐츠를 마이그레이션하는 과정에 대한 개괄적인 개요를 제공합니다. 다음과 같은 접근 방식을 사용하여 콘텐츠를 마이그레이션할 수도 있습니다.

  • 복사하여 붙여넣기: 문서 몇 개만 마이그레이션하는 경우에는 이전 헬프 센터에서 콘텐츠를 복사하여 새 문서에 붙여 넣는 것이 가장 빠르고 쉬운 방법입니다.
  • 전문 서비스: 대규모 또는 복잡한 마이그레이션의 경우 Zendesk를 고용하여 마이그레이션 도움을 받을 수 있습니다.
  • 파트너 앱: Zendesk 앱 마켓플레이스에서 헬프 데스크 마이그레이션과 같은 파트너 앱을 찾을 수 있습니다.

이 문서에서 다루는 주제는 다음과 같습니다.

  • 지식창고로 콘텐츠 마이그레이션하기
    • 작성자를 Zendesk 사용자로 가져오기
    • 지식창고에서 카테고리 만들기
    • 사용자 세그먼트 만들기(선택 사항)
    • 카테고리 안에 섹션 만들기
    • 섹션 안에 문서 만들기
    • 첨부 파일 업로드하기(필요한 경우)
    • 문서 댓글 가져오기
  • 커뮤니티로 콘텐츠 마이그레이션하기
    • 사용자 세그먼트 만들기(선택 사항)
    • 커뮤니티의 주제 가져오기
    • 주제의 게시물 가져오기
    • 게시물의 댓글 가져오기

지식창고로 콘텐츠 마이그레이션하기

콘텐츠를 외부 시스템에서 헬프 센터로 마이그레이션하는 것은 여러 단계를 거쳐야 하며, 앞선 단계의 데이터가 다음 단계에서 필수적입니다.

계획을 세우는 것이 중요합니다. 기존 콘텐츠의 구조를 헬프 센터의 3중 계층 구조로 맵핑해야 합니다.

작성자를 Zendesk 사용자로 가져오기

먼저 모든 문서의 작성자를 “상담사” 역할을 가진 Zendesk 사용자로 가져와야 합니다. Zendesk의 상담사가 반드시 티켓을 해결하는 사람은 아닙니다(Zendesk Support 사용자 역할 이해하기 참조).

API로 Zendesk 사용자를 만들려면(사용자 만들기 참조) 각 POST 요청에서 role 속성을 “상담사”로 설정해야 합니다.

성공적으로 사용자를 만든 후에는 Zendesk가 JSON 응답에서 사용자의 새 ID를 포함한 상세 정보를 리턴합니다.
{
  "user": {
    "id":   9873843,
    "name": "Roger Wilco",
    ...
  }
}

헬프 센터에서 만드는 각 문서의 author_id 속성을 설정하는 데 ID가 필요하므로 각 사용자의 ID를 기록해 두세요.

팁: 각 작성자 ID와 이들의 레거시 문서 간의 맵핑을 만들고자 할 수 있습니다.

섹션을 구분하기 위해 사용자 세그먼트에 있는 조직을 사용할 계획이라면 사용자를 만들기 전에 조직을 먼저 만들어야 합니다. 그런 다음 사용자를 만들 때 사용자에게 조직 ID를 배정할 수 있습니다(조직 만들기 참조). 사용자가 여러 조직에 속할 경우 조직 멤버십을 사용하여 사용자 레코드에 조직을 추가합니다.

지식창고에서 카테고리 만들기

카테고리는 섹션의 모음입니다(카테고리 만들기 참조). 카테고리를 만든 후에는 Zendesk가 카테고리의 새 ID를 포함한 JSON 응답을 리턴합니다.
{
  "category": {
    "id":          37486578,
    "name":        "Super Hero Tricks",
    "description": "This category contains a collection of Super Hero tricks",
    "locale":      "en-us",
    "position":    2,
    ...
  }
}

나중에 섹션을 만들 때 섹션을 특정 카테고리에 배정하려면 ID가 필요하므로 각 카테고리의 ID를 기록해 두세요.

사용자 세그먼트 만들기(선택 사항)

헬프 센터의 특정 섹션에 대한 액세스를 제한하려면 섹션에 사용자 세그먼트를 배정할 수 있습니다(사용자 세그먼트 만들기 참조).

사용자 세그먼트를 만든 후에는 Zendesk가 사용자 세그먼트의 새 ID를 포함한 JSON 응답을 리턴합니다.
{
  "user_segment": {
    "id": 7284
    "name": "VIP agents",
    "user_type": "staff",
    "group_ids": [12, ...],
    "organization_ids": [42, ...],
    "tags": ["vip"],
    "created_at": "2017-05-21T20:01:12Z",
    "updated_at": "2017-05-21T20:01:12Z",
    "built_in": false
  }
}

나중에 섹션을 만들 때 섹션에 액세스 제한을 배정하려면 세그먼트 ID가 필요하므로 각 사용자 세그먼트의 ID를 기록해 두세요.

카테고리 안에 섹션 만들기

섹션은 문서의 모음입니다(섹션 만들기 참조). 각 POST 요청에서 반드시 category_id 및 user_segment_id(있는 경우)를 설정해야 합니다. Zendesk는 섹션의 새 ID를 포함한 JSON 응답을 리턴합니다.
{
  "section": {
    "id":          3457836,
    "name":        "Avionics",
    "description": "This section contains articles on flight instruments",
    "locale":      "en-us",
    "category_id": 3465,
    ...
  }
}

나중에 문서를 만들 때 문서를 특정 섹션에 배정하려면 섹션 ID가 필요하므로 각 섹션의 ID를 기록해 두세요.

섹션 안에 문서 만들기

이전 단계에서 모든 섹션 ID와 사용자 ID를 기록했다면 문서를 만들 수 있습니다(문서 만들기 참조). 각 POST 요청에서 title 및 body뿐만 아니라 author_id 및 section_id도 설정해야 합니다.
참고: 모든 작성자는 자신이 작성한 문서를 자동으로 구독합니다. 헬프 센터가 활성화되면 작성자는 문서가 만들어질 때 이메일 알림을 받게 됩니다.
Zendesk는 다음과 같은 JSON 응답을 리턴합니다.
{
  "article": {
    "id":                37486578,
    "author_id":         3465,
    "promoted":          false,
    "position":          42,
    "comments_disabled": true,
    "section_id":        98838,
    ...
  }
}

첨부 파일 업로드하기(필요한 경우)

문서에 Amazon S3와 같이 공용 파일 서버에 호스팅되지 않은 인라인 이미지가 있는 경우 이미지를 헬프 센터에 업로드합니다(연결되지 않은 첨부 파일 만들기 참조). 반드시 inline 매개변수를 true로 설정합니다.

Zendesk는 첨부 파일의 URL(content_url)을 포함한 JSON 응답을 리턴합니다.
{
  "article_attachment": {
    "id":           1428,
    "article_id":   null,
    "file_name":    "icon.jpg",
    "content_url":  "https://company.zendesk.com/hc/article_attachments/1428/icon.jpg",
    "content_type": "application/image",
    "size":         58298,
    "inline":       true
  }
}

content_url을 사용하여 문서의 HTML에서 이미지 URL을 업데이트합니다(대량으로 첨부 파일을 문서에 연결하기 참조).

문서 댓글 가져오기

댓글을 가져오려면 작성자 ID와 문서의 ID가 필요합니다. 상담사와 최종 사용자 모두 댓글의 작성자가 될 수 있습니다(댓글 만들기 참조).
참고: 댓글 작성자는 해당 문서를 자동 구독하게 됩니다. 헬프 센터가 활성화되면 작성자는 댓글이 만들어질 때 이메일 알림을 받게 됩니다.

커뮤니티로 콘텐츠 마이그레이션하기

커뮤니티 콘텐츠를 가져오는 것은 지식창고를 가져오는 것과 비슷한 점이 많습니다. 게시물에 작성자를 배정하려면 사용자 가져오기를 해야 합니다. 또한 기존 커뮤니티 콘텐츠를 헬프 센터 커뮤니티의 이중 계층 구조와 맵핑해야 합니다.

사용자 세그먼트 만들기(선택 사항)

특정 주제에 대한 액세스를 제한하려면 사용자 세그먼트 ID가 필요합니다(사용자 세그먼트 만들기 참조). 나중에 주제를 만들 때 주제에 대한 액세스 제한을 배정하려면 사용자 세그먼트 ID가 필요합니다.

커뮤니티의 주제 가져오기

해당되는 경우 POST 요청에서 user_segment_id를 설정했는지 확인합니다(주제 만들기 참조).

Zendesk는 주제 ID를 포함한 JSON 응답을 리턴합니다.

{
  "topic": {
    "id":   115000553548,
    "name": "Help Center-Tricks",
    ...
  }
}

나중에 주제를 만들 때 게시물을 특정 주제에 배정하려면 주제 ID가 필요하므로 각 주제의 ID를 기록해 두세요.

주제의 게시물 가져오기

각 POST 요청에서 title 및 details뿐만 아니라 author_id 및 topic_id도 설정해야 합니다(Create post 참조).

지식창고 문서와는 달리 커뮤니티 게시물의 작성자는 상담사 또는 최종 사용자입니다.

게시물을 만들 때 작성자는 해당 주제의 모든 업데이트를 자동 구독하게 되며, 새로운 게시물이 만들어지거나 업데이트될 때 알림을 받게 됩니다.

게시물이 만들어지면 동일한 주제의 모든 구독자는 이메일 알림을 받습니다. 게시물을 일괄로 가져올 때 구독자들에게 너무 많은 알림을 한꺼번에 보내지 않도록 POST 요청에 notify_subscribers 값을 가진 false 매개변수를 포함시킵니다.

{
  "post": {
    "id":        35467,
    "author_id": 89567,
    "title":     "Help!",
    "details":   "My printer is on fire!",
    "notify_subscribers": false,
    ...
  }
}

게시물의 댓글 가져오기

게시물을 만들고 ID를 받은 후에는 관련 댓글을 추가할 수 있습니다(Create comment 참조).

한 번에 하나의 댓글만 만들 수 있습니다. 게시물 댓글을 만들 때 댓글 작성자는 해당 주제의 모든 업데이트를 자동 구독하게 되며, 새로운 게시물이 만들어지거나 업데이트될 때 알림을 받게 됩니다.

댓글이 만들어지면 동일한 주제의 모든 구독자는 이메일 알림을 받습니다. 구독자들에게 너무 많은 알림을 한꺼번에 보내지 않도록 POST 요청에 notify_subscribers 값을 가진 false 매게 변수를 포함시킵니다.

Zendesk 제공