웹훅 관리하기

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

웹훅 페이지의 Zendesk 관리 센터에서 웹훅을 만들고 관리합니다.

관리자나 웹훅을 관리할 수 있는 권한이 있는 사용자 지정 역할의 상담사여야 합니다.

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

• 웹훅 편집 및 관리하기
• 웹훅의 활동 보기
• 웹훅 디버그하기

웹훅 편집 및 관리하기

대부분의 경우 관리자가 웹훅을 편집, 복제, 비활성화 및 삭제할 수 있습니다. 하지만 앱 요구 사항에 의해 만들어진 웹훅의 경우에는 편집은 할 수 있지만 복제하거나 삭제할 수는 없습니다. 앱 요구 사항에 의해 만들어진 웹훅은 앱 개발자만 업데이트할 수 있으며 계정 관리자가 수행한 변경 내용을 무시합니다. 웹훅이 만들어진 후에는 웹훅의 연결 방법을 변경할 수 없습니다.

웹훅을 편집하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
2. 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 편집을 클릭합니다.
3. 필요에 따라 웹훅을 수정합니다.

   모든 필드를 편집할 수 있습니다. 하지만 인증을 사용하는 경우 웹훅을 만들거나 업데이트한 후에는 키, 토큰 또는 비밀번호를 볼 수 없습니다. 사용자 지정 헤더를 제거하려면 삭제 아이콘()을 클릭합니다.

4. (선택 사항) 웹훅에 변경한 내용을 테스트합니다.
5. 저장을 클릭합니다.

웹훅을 복제하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
2. 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 복제를 클릭합니다.
3. 웹훅의 이름을 편집하고 필요에 따라 웹훅을 수정합니다.
4. 업데이트를 클릭합니다.

웹훅을 비활성화하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
2. 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 비활성화를 클릭합니다.
3. 확인 대화 상자에서 비활성화를 클릭합니다.

웹훅을 삭제하려면 다음과 같이 하세요.

1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
2. 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 삭제를 클릭합니다.
3. 삭제를 클릭합니다.

웹훅의 활동 보기

각 웹훅에는 활동 로그가 있습니다. 자세한 호출 기록 외에도 지난 7일 동안의 요청 수를 볼 수도 있습니다.

엔드포인트가 특정 HTTP 응답 코드를 리턴하는 경우 웹훅 호출은 최대 3번까지 자동으로 다시 시도됩니다. 자세한 내용과 재시도 시나리오의 예는 개발자 문서에서 웹훅 재시도 논리를 참조하세요.

Zendesk는 웹훅에 한 번만 작업을 전달하기 위해 최선을 다하지만 장담할 수는 없습니다. 웹훅이 동일한 작업에 의해 여러 번 호출될 수 있습니다. 중복 호출을 감지하기 위해 웹훅의 서명을 사용할 수 있습니다. 이러한 상황이 워크플로우에 문제가 된다면 웹훅으로 인한 작업을 여러 번 수행하더라도 결과가 달라지지 않는 멱등성을 가지도록 하세요.

1. 관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
2. 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 자세히 보기를 클릭합니다.
3. 활동 탭을 클릭합니다.
4. 필터를 클릭하여 시작 날짜, 시작 시간, 종료 날짜, 종료 시간 또는 상태별로 활동 로그를 필터링한 다음 필터 적용을 클릭합니다.

웹훅 디버그하기

웹훅이 제대로 작동하지 않으면 실패한 호출이 웹훅의 활동 로그에 표시됩니다. 실패한 상태 또는 특정 오류 유형별로 활동 로그를 필터링할 수 있습니다. 활동 탭에서 호출 ID를 클릭하여 웹훅의 특정 호출에 대한 요청 및 응답을 볼 수도 있습니다.

대부분의 경우 응답은 Zendesk 자체가 아니라 웹훅의 요청을 수신하는 타사 서비스에서 제공됩니다. 보통 오류를 수정하려면 이러한 서비스를 확인하여 필요한 작업을 해야 합니다.

응답 상태의 숫자 코드를 사용하여 문제를 진단할 수 있습니다. 이러한 응답 상태 코드는 HTTP 요청들 간에 표준입니다. 표준 HTTP 응답 상태 코드 목록과 그 의미는 MDN 웹 문서에서 HTTP 응답 상태 코드를 참조하세요.

참고: 서비스에서 HTTP 응답 상태 코드를 사용하는 경우에는 해당 문서를 참조해야 할 수 있습니다.

웹훅 요청에는 10초 시간 제한이 있습니다. “실패: 504 Gateway Timeout 응답 상태는 서비스가 이 제한 시간 내에 웹훅의 요청에 응답하지 않았음을 나타냅니다. 제한 시간은 조정할 수 없습니다.