웹훅(Webhook) 연결하기

참가자의 티켓, 참가신청에 변경사항이 있을 때 웹훅으로 실시간 업데이트를 받아보세요. 웹훅이란 데이터가 변경되었을 때 실시간으로 알림을 받을 수 있는 기능이에요. 예를 들어, 참가자가 티켓을 결제하면 Slack 채널에 알림을 보내거나 Google Sheets에 데이터를 기록하는 등 다양하게 활용할 수 있어요.

참가자 결제 완료 → Ticketaco → POST https://your-server.com/webhook → Slack 알림

이벤트 타입

웹훅으로 등록할 수 있는 이벤트 타입은 아래와 같습니다. 웹훅 본문과 자세한 설명은 각 이벤트 타입을 선택해서 살펴보세요.

이벤트 타입	설명
order.completed	예매 완료 이벤트입니다.
ticket.checked_in	참가자 체크인 이벤트입니다.
ticket.canceled	티켓 취소 이벤트입니다.
ticket.updated	티켓 정보 변경(참가자 정보 설정, 양도) 이벤트입니다.
entry.created	추첨·승인 티켓 참가신청 완료 이벤트입니다.
entry.canceled	추첨·승인 티켓 참가신청 취소 이벤트입니다.

웹훅 등록

개발자센터의 웹훅 메뉴에서 등록 버튼을 누르면 웹훅 이벤트 등록 팝업창이 열립니다. 웹훅 이름, 웹훅 URL을 입력하고 등록할 이벤트를 선택하세요. 마지막으로 ‘저장’을 누르면 웹훅이 등록됩니다.

웹훅 목록에서 잘 등록되었는지 확인하세요. 등록한 이벤트가 발생하면 웹훅 URL로 웹훅 이벤트가 전송됩니다. 웹훅은 상세 페이지에서 삭제할 수 있습니다.

• 웹훅 URL은 온라인에서 접근할 수 있는 주소를 등록해야 합니다. 로컬 개발 환경은 외부에서 접근할 수 없기 때문에 로컬 서버 포트가 포함된 URL은 웹훅으로 등록할 수 없습니다.
• 이벤트는 HTTPS를 통해 HTTP POST 메서드로 전달되는 JSON 파일입니다. 서버에서 JSON을 처리할 수 있는지 확인해주세요.
• 웹훅 상세 페이지에서 테스트 전송 버튼으로 URL이 정상 동작하는지 확인할 수 있습니다.
• 조직당 최대 10개의 웹훅을 등록할 수 있습니다.

웹훅 전송 기록

개발자센터 웹훅 목록에서 등록한 웹훅을 선택하면 웹훅 상세 정보와 전송 기록을 확인할 수 있습니다.

웹훅 전송 기록은 등록한 이벤트의 가장 최근 전송 상태를 보여줍니다. 즉, 하나의 전송 기록은 이벤트가 발생한 뒤의 상태 변화를 표현합니다. 이벤트 발생 시간을 선택하면 해당 이벤트의 본문을 볼 수 있습니다. 전송 기록은 30일간 보관되며, 이후 자동으로 삭제됩니다.

전송 상태는 ‘전송 중’, ‘성공’, ‘실패’ 중 하나입니다.

재전송 정책

웹훅을 잘 받았다면 10초 이내로 200번대 응답을 보내주세요. 200번대 응답을 보내면 웹훅 상태가 ‘성공’입니다. 200 응답을 보내지 않고 최초의 웹훅 전송이 실패하면 최대 5회까지 웹훅을 재전송합니다. 웹훅 전송이 실패하면 이메일로 실패 내역이 전송됩니다.

1회부터 4회까지 웹훅 재전송이 실패해도 웹훅 상태는 ‘전송 중’입니다. 5회 웹훅 재전송이 실패하면 웹훅 상태가 ‘실패’로 변경됩니다.

재전송 횟수	재전송 간격(분)
1	1
2	4
3	16
4	64
5	256