관리 센터에서 웹훅 만들기

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

웹훅은 Zendesk Support에서 트리거 또는 자동화 실행과 같은 이벤트에 대한 응답으로 지정된 URL에 HTTP 요청을 보냅니다. 웹 개발자는 보통 웹훅을 사용하여 다른 시스템에서 동작을 호출합니다.

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

참고: 평가판 계정의 웹훅은 최대 10개까지로 제한됩니다.

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

웹훅에 대한 정보

웹훅은 타사 서비스나 백엔드 시스템과 연동하는 데 사용됩니다. 예를 들어 웹훅을 사용하여 다음과 같은 작업을 수행할 수 있습니다.

웹훅을 사용하여 HTTP 요청에 타사 서비스와 JSON, XML 또는 양식으로 인코딩된 콘텐츠를 허용하는 REST API로 정보를 전달할 수 있습니다. 웹훅을 사용하여 URL 매개변수를 어떤 URL에든 전달할 수도 있습니다.

웹훅은 티켓이 지정된 조건을 충족할 때 Zendesk Support에서 자동화 및 트리거에 의해 사용됩니다. 웹훅은 타사 서비스의 HTTP 응답에 따라 트리거 및 자동화가 작업을 하게 되는 결과를 낳을 수 있는 수단이므로 중요합니다.

사용 가능한 콘텐츠 자리 표시자를 사용하여 HTTP 요청에 티켓 데이터를 삽입할 수 있습니다.

비즈니스 규칙이 웹훅을 실행할 때 실행될 웹훅 작업이 대기열에 쌓이지만 실제로는 바로 작업을 실행하지 않습니다. 웹훅 작업은 별개로 실행되므로 웹훅이 특정 순서로 실행된다는 보장은 없습니다.

엔드포인트가 특정 HTTP 응답 코드를 리턴하는 경우 웹훅 요청은 최대 3번까지 자동으로 다시 시도됩니다. 대상과 달리 연속된 실패 요청이 웹훅을 비활성화하지 않습니다. 자세한 내용과 재시도 시나리오의 예는 개발자 문서에서 웹훅 모니터링하기를 참조하세요.

웹훅을 만드는 데 있어 두 가지 부분이 있습니다. 먼저 웹훅 자체의 세부 정보를 정의합니다. 그런 다음 트리거나 자동화에 첨부하여 웹훅이 사용될 수 있도록 합니다.

참고: 타사와 연동하기 위해 웹훅을 설정할 때에는 해당 타사 문서를 참조해야 할 수도 있습니다.

웹훅을 만들려면 다음과 같이 하세요.

웹훅을 만들어 트리거나 자동화에 연결한 후에는 관리 센터의 웹훅 페이지에서 웹훅의 세부 정보, 이벤트 구독 및 활동을 볼 수 있습니다. 자세한 내용은 관리 센터에서 웹훅 관리하기를 참조하세요.

웹훅은 웹훅을 만들 때 지정한 엔드포인트 URL에서 요청을 보내고 응답을 받습니다. 이런 방식으로 타사 서비스, API 및 시스템과 연동됩니다.

엔드포인트 URL은 https://www.yourdomain.com/path 형식을 사용합니다.

필수는 아니지만 보안 HTTP (HTTPS)를 사용할 것을 권장합니다. 보안 엔드포인트 URL을 제공함으로써 인증을 사용 설정하고 데이터를 안전하게 전달할 수 있습니다.

웹훅이 보안 엔드포인트와 연동되는 경우에는 웹훅과 웹훅이 보내는 데이터를 인증하기 위한 3가지 옵션이 있습니다. 엔드포인트의 인증 요구 사항에 관한 타사 문서를 참조하거나 팀의 개발자와 함께 웹훅의 올바른 인증 방법을 결정할 수 있습니다.

개발자가 웹훅 인증에 대한 자세한 정보를 원하는 경우에는 웹훅 보안 및 인증을 참조하세요.

웹훅이 어떤 작업을 수행하려면 먼저 트리거나 자동화에 연결되어야 합니다. 트리거와 자동화는 웹훅이 호출되어야 하는 상황을 지정합니다.

Support 트리거에 웹훅을 연결하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 비즈니스 규칙 > 트리거를 선택합니다.
참고: 웹훅을 만들거나 편집하는 경우에는 비즈니스 규칙 관리를 클릭합니다.
새 트리거를 만들거나 옵션 아이콘()에 커서를 갖다 대고 편집을 클릭하여 기존 트리거를 편집합니다.
트리거의 경우에는 작업 아래에서 작업 추가를 클릭합니다. 웹훅에 알림을 선택한 다음 해당 웹훅을 선택합니다. 저장을 클릭합니다.

Support 자동화에 웹훅을 연결하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 개체 및 규칙을 클릭한 다음 비즈니스 규칙 > 자동화를 선택합니다.
참고: 웹훅을 만들거나 편집하는 경우에는 비즈니스 규칙 관리를 클릭합니다.
새 자동화를 만들거나 옵션 아이콘()에 커서를 갖다 대고 편집을 클릭하여 기존 자동화를 편집합니다.
자동화의 경우에는 다음 작업 수행 아래에서 작업 추가 아이콘()을 클릭합니다. 알림: 웹훅에 알림을 선택한 다음 해당 웹훅을 선택합니다. 제출을 클릭합니다.

관리 센터에 요청은 물론 서로 다른 이벤트 소스와 웹훅을 테스트하는 옵션이 있습니다. 특히 테스트를 위해 기존 웹훅에 액세스하는 것 외에도 웹훅을 만들거나 편집하는 동안 테스트할 수도 있습니다.

웹훅을 테스트하려면 다음과 같이 하세요.

관리 센터의 사이드바에서 앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘()을 클릭한 다음 웹훅 테스트를 클릭합니다.
웹훅 테스트 창에서 이벤트 소스 테스트를 선택합니다. 엔드포인트 URL을 테스트하는 데 사용할 수 있는 첨부된 트리거 또는 샘플 티켓입니다.
테스트 요청의 세부 정보(요청 본문, 매개변수 또는 헤더)를 입력합니다.
테스트 보내기를 클릭합니다. 테스트 요청 아래 창에 응답이 표시됩니다.