HTTP 대상을 웹훅으로 전환하기

팁: 2022년 2월에는 HTTP 대상이 사용되지 않게 됩니다. 기존 HTTP 대상을 전환하는 데 도움이 필요하다면 Zendesk 고객 지원팀에 문의하세요.

빠른 경로: 관리 센터 > 앱 및 연동 서비스 > 웹훅 > 웹훅

Zendesk Support의 HTTP 대상이 Zendesk 관리 센터에서 만들어지고 관리되는 웹훅으로 바뀝니다. 관리 센터에서 간단한 전환 프로세스를 사용하여 기존 HTTP 대상을 웹훅으로 전환할 수 있습니다.

이 문서는 다음 섹션으로 구성되어 있습니다.

대상을 웹훅으로 전환하는 데 대한 정보
전환될 HTTP 대상 준비하기
관리 센터에서 HTTP 대상을 웹훅으로 전환하기
전환 로그 보기
전환 재시도하기
전환된 웹훅을 다시 대상으로 되돌리기

대상을 웹훅으로 전환하는 데 대한 정보

대상을 전환하기 전에 다음 사항을 고려하세요.

전환 툴은 HTTP 대상만 전환합니다.
대상이 활성 상태여야 전환됩니다. 사용 중지되었고 비활성화된 대상은 전환되지 않습니다.
웹훅은 HTTP 인증을 지원하지 않습니다. 인증을 사용하는 모든 대상을 HTTPS를 사용하도록 업데이트한 후에 전환할 수 있습니다.
자격이 있는 대상이 모두 전환됩니다. 한 번에 한 대상씩 전환할 수는 없습니다.
대상이 전환되거나 HTTP 대상이 사용되지 않을 때까지 대상이 계속 활성 상태를 유지합니다.
전환의 일부가 실패하면 실패한 대상과 관련된 모든 항목이 롤백됩니다. 어떤 상황에서도 실패한 전환이 트리거 및 비즈니스 규칙의 기존 구성에 영향을 미치지 않습니다.
HTTP 대상이 사용되지 않을 때까지는 전환을 완전히 되돌릴 수 있습니다. 어떤 이유로든 전환한 대상을 되돌리려면 그렇게 할 수 있습니다.

전환될 HTTP 대상 준비하기

HTTPS 대신 HTTP를 사용하며 기본 인증이 사용 설정되어 있거나 비활성 상태인 대상은 전환될 수 없습니다. 대부분의 경우 간단한 방법으로 전환에 포함될 수 있도록 대상을 수정할 수 있습니다.

HTTP에서 HTTPS로 변경하기

참고: HTTPS로 변경하거나 웹훅으로 전환하기 전에 웹훅에 의해 접속되는 서버가 HTTPS를 지원하는지 확인하세요. 대상을 HTTPS나 웹훅으로 전환하는데 서버가 HTTPS를 지원하지 않는 경우에는 이후 요청이 실패하게 됩니다.

전환 프로세스 중 비보안 대상을 보안 웹훅(HTTPS)으로 전환할지 또는 건너뛸지 선택할 수 있습니다. 비보안 대상을 전환하기로 선택하는 경우에는 사전에 이를 해결하기 위한 조치가 필요하지 않습니다.

HTTP를 사용하는 일부 HTTP 대상만 전환하려는 경우에는 그러한 대상에 대한 URL만 수동으로 업데이트한 후 전환 프로세스 중 비보안 대상 전환하지 않기를 선택할 수 있습니다.

대상 URL을 HTTP에서 HTTPS로 변경하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스 아이콘()을 클릭한 다음 대상 > 대상을 선택합니다.
목록에서 대상을 찾아 편집을 클릭합니다.
URL 값을 업데이트하여 https를 사용하도록 합니다.
드롭다운에서 대상 업데이트를 선택하고 제출을 클릭합니다.

대상이 활성 상태인지 확인하기

활성 HTTP 대상만 전환될 수 있습니다.

대상을 활성화하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스 아이콘()을 클릭한 다음 대상 > 대상을 선택합니다.
비활성 대상 목록에서 다시 활성화하려는 대상을 찾아 활성화를 클릭합니다.

관리 센터에서 HTTP 대상을 웹훅으로 전환하기

모든 기존 대상을 복제하여 전환 프로세스를 시작합니다. 그런 다음 대상 대신 웹훅을 사용하도록 비즈니스 규칙이 수정됩니다. 마지막 단계는 대상을 비활성화하고 웹훅을 활성화하는 것입니다.

전환에 성공하면 HTTP 대상이 비활성화되고, 웹훅이 활성화되며, 비즈니스 규칙이 거의 동시에 업데이트됩니다.

대상 전환에 실패하면 대상 및 해당 트리거가 변경되지 않고 활성 상태를 유지합니다.

HTTP 대상을 웹훅으로 전환하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스 아이콘()을 클릭한 다음 웹훅 > 웹훅을 선택합니다.
시작하기를 클릭합니다.
전환 자격이 있는 대상이 있으면 전환 프로세스가 안내됩니다.
대상 관리를 클릭하여 대상이 반드시 전환 준비가 되도록 한 후 다음을 클릭합니다.
자격이 있는 대상의 요약을 검토한 다음 대상 전환을 클릭합니다.
비보안(HTTP) 대상이 감지되면 비보안 대상을 보안 웹훅(HTTPS)으로 전환하거나 비보안 대상을 전환하지 않기로 선택할 수 있습니다.
참고: 비보안 대상을 보안 웹훅으로 전환하면 서버가 HTTPS를 지원하지 않는 경우 워크플로우가 중단될 수 있습니다.
대상 전환 로그 보기를 클릭하여 전환된 대상과 전환되지 못한 대상을 봅니다.

전환 중 건너뛰는 대상

대상을 전환하기 전에 건너뛰게 될 대상이 여러 개 표시될 수 있습니다. 즉, 전환 프로세스의 일부로 그러한 대상에 대해 아무 조치도 취해지지 않을 것이라는 뜻입니다. 전환 중 대상을 건너뛸 수 있는 이유는 다음을 포함합니다.

Salesforce와 같은 연동 서비스로부터 만든 대상
URL에 Support 자리 표시자가 있는 대상

전환 로그 보기

전환 프로세스의 마지막에 전환 로그를 보라는 메시지가 표시됩니다. 웹훅 페이지에서 언제든 전환 로그에 액세스할 수도 있습니다. 전환 로그를 보려면 페이지 위쪽에 있는 작업을 클릭한 다음 대상 전환 로그 보기를 클릭합니다.

전환 로그에는 전환하지 못함, 전환됨, 전환 중의 3가지 탭이 있습니다. 각 탭은 각 단계의 웹훅 수와 해당 단계에서 각 대상에 대해 사용할 수 있는 작업 메뉴를 포함합니다.

전환 중 탭은 전환 프로세스 중에만 수가 표시되고 대부분의 시간에는 빈 상태로 있습니다.
전환됨 탭에는 전환된 모든 웹훅 수의 기록이 표시됩니다. 이 탭에서 웹훅을 더 자세히 보고, 웹훅을 다시 대상으로 되돌리고, 해당 웹훅의 전환 ID를 찾을 수 있습니다.
전환하지 못함 탭에는 전환되지 못한 각 자격 있는 대상의 기록이 표시됩니다. 이 탭을 사용하여 전환되지 못한 이유를 자세히 보고 각 대상의 전환을 재시도할 수 있습니다.

전환 재시도하기

전환 로그에서 전환되지 못한 대상을 확인하고 전환을 재시도할 수 있습니다.

대상의 전환을 재시도하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스 아이콘()을 클릭한 다음 웹훅 > 웹훅을 선택합니다.
페이지 위쪽에 있는 작업을 클릭한 다음 대상 전환 로그 보기를 클릭합니다.
전환하지 못함 탭을 클릭하여 재시도하려는 대상을 찾습니다.
대상에 대해 설명된 오류를 해결합니다.
대상의 행에서 옵션 아이콘()을 클릭하고 전환 다시 시도를 클릭합니다.
전환이 다시 시도되는 동안 대상이 전환 중 탭에 나열됩니다. 전환 다시 시도가 완료되면 대상이 전환됨 탭으로 이동되거나 대상이 전환되지 못한 데 대한 정보가 전환되지 못함 탭에 업데이트되고 대상이 표의 위쪽으로 이동됩니다.

전환 오류 해결하기

다음은 대상 전환이 실패할 수 있는 가장 일반적인 이유입니다.

실패	이유	해결
트리거를 업데이트하지 못함	웹훅을 호출 중인 트리거에 대한 업데이트에 실패했습니다. 이는 종종 전환과 관계없이 올바르지 않은 트리거 구성으로 인한 것입니다.	트리거를 검토하여 트리거가 수정 및 저장될 수 있는지 확인한 후 전환을 다시 시도하세요.
대상을 업데이트하지 못함	HTTP 대상을 비활성화하기 위한 업데이트에 실패했습니다. 이는 보통 올바르지 않은 대상 URL 등 올바르지 않은 대상 구성으로 인한 것입니다.	HTTP 대상을 검토하여 대상이 수정 및 저장될 수 있는지 확인한 후 전환을 다시 시도하세요.
웹훅을 업데이트하지 못함	유효성 검증 문제로 인해 웹훅이 만들어지지 않았습니다.	HTTP 대상을 검토하여 올바르게 전환될 준비가 되어 있는지 확인한 후 전환을 다시 시도하세요.

전환된 웹훅을 다시 대상으로 되돌리기

HTTP 대상이 사용되지 않을 때까지는 웹훅으로 전환된 모든 대상은 문제가 발생하면 다시 대상으로 되돌릴 수 있습니다.

참고: 관리 센터에서 새로 만든 웹훅은 HTTP 대상으로 전환할 수 없습니다. 이는 웹훅으로 전환된 대상에만 해당됩니다.

웹훅을 대상으로 전환하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스 아이콘()을 클릭한 다음 웹훅 > 웹훅을 선택합니다.
페이지 위쪽에 있는 작업을 클릭한 다음 대상 전환 로그 보기를 클릭합니다.
전환됨 탭을 클릭하여 대상으로 전환하려는 웹훅을 찾습니다.
작업 메뉴 아이콘()을 클릭하여 대상으로 되돌리기를 클릭합니다.
웹훅을 성공적으로 대상으로 되돌린 후에는 전환됨 탭의 목록에서 제거됩니다.