웹훅에 대한 정보
웹훅을 사용하여 HTTP 요청에 타사 서비스와 JSON, XML 또는 양식으로 인코딩된 콘텐츠를 허용하는 REST API로 정보를 전달할 수 있습니다. 웹훅을 사용하여 URL 매개변수를 어떤 URL에든 전달할 수도 있습니다.
웹훅은 티켓이 지정된 조건을 충족할 때 Zendesk Support에서 자동화 및 트리거에 의해 사용됩니다. 웹훅은 타사 서비스의 HTTP 응답에 따라 트리거 및 자동화가 작업을 하게 되는 결과를 낳을 수 있는 수단이므로 중요합니다.
사용 가능한 콘텐츠 자리 표시자를 사용하여 HTTP 요청에 티켓 데이터를 삽입할 수 있습니다.
비즈니스 규칙이 웹훅을 실행할 때 실행될 작업이 대기열에 쌓이지만 실제로는 바로 작업을 실행하지 않습니다. 웹훅 작업은 별개로 실행되므로 웹훅이 특정 순서로 실행된다는 보장은 없습니다.
엔드포인트가 특정 HTTP 응답 코드를 리턴하는 경우 웹훅 요청은 최대 3번까지 자동으로 다시 시도됩니다. 대상과 달리 연속된 실패 요청이 웹훅을 비활성화하지 않습니다. 자세한 내용과 재시도 시나리오의 예는 개발자 문서에서 웹훅 모니터링하기를 참조하세요.
웹훅 만들기
웹훅을 만들려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
- 작업을 클릭한 다음 웹훅 만들기를 선택합니다.
- 타사 서비스나 시스템과 연동되도록 웹훅을 구성합니다.
- (선택 사항) 웹훅 테스트를 클릭하여 예상대로 제대로 작동하는지 확인합니다.
- 다음을 클릭하여 Support 트리거 또는 자동화에 웹훅을 연결합니다. 이 작업은 Zendesk Support 관리자 인터페이스에서 합니다.
- 관리 센터의 웹훅 만들기 페이지로 돌아가서 설정 마침을 클릭합니다.
웹훅을 만들어 트리거나 자동화에 연결한 후에는 관리 센터의 웹훅 페이지에서 웹훅의 세부 정보, 이벤트 구독 및 활동을 볼 수 있습니다. 자세한 내용은 관리 센터에서 웹훅 관리하기를 참조하세요.
웹훅 엔드포인트
웹훅은 웹훅을 만들 때 지정한 엔드포인트 URL에서 요청을 보내고 응답을 받습니다. 이런 방식으로 타사 서비스, API 및 시스템과 연동됩니다.
엔드포인트 URL은 https://www.yourdomain.com/path
형식을 사용합니다.
필수는 아니지만 보안 HTTP (HTTPS)를 사용할 것을 권장합니다. 보안 엔드포인트 URL을 제공함으로써 인증을 사용 설정하고 데이터를 안전하게 전달할 수 있습니다.
웹훅 인증하기
- 필요 없음 - 인증이 구성되어 있지 않거나 필요하지 않습니다.
- 기본 인증 - 사용자 이름 및 비밀번호를 사용하여 웹훅을 인증합니다.
- 전달자 토큰 - OAuth 액세스 토큰을 사용하여 웹훅을 인증합니다.
개발자가 웹훅 인증에 대한 자세한 정보를 원하는 경우에는 웹훅 보안 및 인증을 참조하세요.
웹훅을 트리거 또는 자동화에 연결하기
웹훅이 어떤 작업을 수행하려면 먼저 트리거나 자동화에 연결되어야 합니다. 트리거와 자동화는 웹훅이 호출되어야 하는 상황을 지정합니다.
Support 트리거에 웹훅을 연결하려면 다음과 같이 하세요.
-
관리 센터의 사이드바에서
개체 및 규칙을 클릭한 다음 비즈니스 규칙 > 트리거를 선택합니다.
참고: 웹훅을 만들거나 편집하는 경우에는 비즈니스 규칙 관리를 클릭합니다. -
새 트리거나 자동화를 만들거나 옵션 아이콘(
)에 커서를 갖다 대고 편집을 클릭하여 기존 트리거나 자동화를 편집합니다.
- 트리거의 경우에는 작업 아래에서 작업 추가를 클릭합니다. 웹훅에 알림을 선택한 다음 해당 웹훅을 선택합니다. 저장을 클릭합니다.
-
관리 센터의 사이드바에서
개체 및 규칙을 클릭한 다음 비즈니스 규칙 > 자동화를 선택합니다.
참고: 웹훅을 만들거나 편집하는 경우에는 비즈니스 규칙 관리를 클릭합니다. -
새 트리거를 만들거나 옵션 아이콘(
)에 커서를 갖다 대고 편집을 클릭하여 기존 트리거를 편집합니다.
- 자동화의 경우에는 다음 작업 수행 아래에서 작업 추가 아이콘(
)을 클릭합니다. 알림: 웹훅에 알림을 선택한 다음 해당 웹훅을 선택합니다. 제출을 클릭합니다.
웹훅 테스트하기
관리 센터에 요청은 물론 서로 다른 이벤트 소스와 웹훅을 테스트하는 옵션이 있습니다. 특히 테스트를 위해 기존 웹훅에 액세스하는 것 외에도 웹훅을 만들거나 편집하는 동안 테스트할 수도 있습니다.
웹훅을 테스트하려면 다음과 같이 하세요.
- 관리 센터의 사이드바에서
앱 및 연동 서비스를 클릭한 다음 웹훅 > 웹훅을 선택합니다.
- 목록에서 웹훅을 찾아 웹훅 행에 있는 옵션 메뉴 아이콘(
)을 클릭한 다음 웹훅 테스트를 클릭합니다.
- 웹훅 테스트 창에서 이벤트 소스 테스트를 선택합니다. 엔드포인트 URL을 테스트하는 데 사용할 수 있는 첨부된 트리거 또는 샘플 티켓입니다.
- 테스트 요청의 세부 정보(요청 본문, 매개변수 또는 헤더)를 입력합니다.
- 테스트 보내기를 클릭합니다. 테스트 요청 아래 창에 응답이 표시됩니다.
0 댓글
댓글을 남기려면 로그인하세요.