개발·연동
웹훅이란? 결과가 생기면 내 서버로 알려주는 방식
Webhook · HTTP Callback
웹훅은 서비스에서 일이 생겼을 때 등록한 주소로 알려주는 방식이에요. 통화가 끝났는지나 문자가 전달됐는지를 매번 조회하는 부담을 줄여줘요.
요청과 나중에 오는 결과를 연결해요
발송 API 응답은 요청 접수이고, 전달 결과는 나중에 도착할 수 있어요. 통화 ID나 메시지 ID로 같은 작업의 요청과 이벤트를 묶어요.
같은 알림이 다시 와도 한 번만 처리해요
네트워크나 재시도로 이벤트가 중복될 수 있어요. 중복 처리 기준을 정하고, 받은 내용을 저장한 뒤 오래 걸리는 작업은 따로 처리하는 구성을 검토해요. 채널별 재시도 조건은 가이드에서 확인해요.
한국AI통신(ClawOps) 알림은 서명을 확인해요
웹훅 주소와 구독할 이벤트를 설정하고 Signing Key로 서명을 검증해요. 통화·메시지·인증·이메일은 각 이벤트 문서에 맞춰 처리해요. 서명 확인과 재전송 방어는 따로 준비해요.